Add Forgejo
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 82/100
- Issue type
- Feature
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript
- Domain
- api
Research direction
Start with docs/ADDING_APPS.md and the gitea definition in src/catalog/apps/batch-19.js, then check the Forgejo API docs for the base URL, token auth and GET /user connection test. Add a Forgejo definition to the best-fitting file in src/catalog/apps/, with numbered help text. Done when npm run validate and npm test pass and the logo is generated with npm run logos -- forgejo.
Written by the indexing model from the issue text.
Description
Add Forgejo 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://forgejo.org/docs/latest/user/api-usage/
What we know so far (check it against the docs before relying on it):
- Base URL:
{url}/api/v1, where{url}is a field withformat: "url"(see thegiteaapp insrc/catalog/apps/batch-19.jsfor an example). - Authentication: An access token (Settings → Applications), sent as
Authorization: token <token>(Bearer also works). - Connection test:
GET /userreturns the signed-in user. - What agents could do with it: Repositories, issues and pull requests. Its API is compatible with Gitea's, so the existing
giteadefinition insrc/catalog/apps/batch-19.jsis a good starting point.
How to add it
- 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. - Run
npm run validateandnpm test, and generate the logo withnpm run logos -- <app id>. - If you run Forgejo 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
- 19h 5m
- Merged PRs (30d)
- 26
Getting set up
- Ships a Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 12 days
-
[Bug]: Payment providers removed from config are never disabled in payment_providerPossibly taken @medusa-os-bot claimed this today. Opentype: bug
Difficulty 2/5 Half a day Newbie friendliness 82/100
medusajs/medusa#17544 · 1 comment ·
Maintainers usually reply within 1 day
-
area:cli good first issue priority:medium type:feature
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
PicadoLabs/build-with-ai#199 ·
Maintainers usually reply within 1 day
-
Cookies with valid Max-Age are omitted when Expires is in the pastPossibly taken @Max-Reisinger claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Maintainers usually reply within 3 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
sagemathinc/sagebrush#252 ·
Maintainers usually reply within 1 day