Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Add Nextcloud

Open Beginner friendly
  • Is something wrong?
#6 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
80/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript, node.js
Domain
tooling

Research direction

Start with docs/ADDING_APPS.md and the gitea entry in src/catalog/apps/batch-19.js, which shows the url field pattern to copy. Add the Nextcloud definition to the most fitting file in src/catalog/apps/, using Basic auth with the OCS-APIRequest: true header and GET /ocs/v2.php/cloud/user?format=json as the connection test per the linked API docs. Done means npm run validate and npm test pass, the logo is generated with npm run logos -- <app id>, and any live testing is described in the PR.

Written by the indexing model from the issue text.

Description

app request good first issue help wanted self-hosted app

Add Nextcloud to the catalog. It's a popular self-hosted app and a good first contribution: Conector already supports apps on your own server through a url field.

API documentation: https://docs.nextcloud.com/server/latest/developer_manual/client_apis/

What we know so far (check it against the docs before relying on it):

  • Base URL: {url}, where {url} is a field with format: "url" (see the gitea app in src/catalog/apps/batch-19.js for an example).
  • Authentication: Username and an app password (Personal settings → Security → Devices & sessions), sent with HTTP Basic auth plus the OCS-APIRequest: true header.
  • Connection test: GET /ocs/v2.php/cloud/user?format=json returns the user.
  • What agents could do with it: Files over WebDAV, shares, Talk, Deck, Calendar and Contacts.

How to add it

  1. Follow docs/ADDING_APPS.md: add the definition to the most fitting file in src/catalog/apps/, with help text that leads people to the key in a few numbered steps.
  2. Run npm run validate and npm test, and generate the logo with npm run logos -- <app id>.
  3. If you run Nextcloud yourself, connect it in a local Conector and try a couple of requests from your agent. Say in the pull request what you tested.

Comment here if you'd like to take it, so nobody else starts the same work.

Dominant language
JavaScript
Stars
1
Forks
1
Avg merge
6m
Merged PRs (30d)
8

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Secra-Solutions/Conector

All issues in Secra-Solutions/Conector

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.