Write a Forgejo Actions workflow example for Next.js → Dokploy #4

New issue

Open

opened 2026-05-08 20:40:08 +02:00 by flndrn · 0 comments

flndrn commented

2026-05-08 20:40:08 +02:00

Owner

Why

Many flndrn projects (and likely many community ones) deploy a Next.js app to Dokploy. A working example workflow in docs/examples/forgejo-actions-nextjs-dokploy.yml would be a high-leverage reference.

Scope

A complete .forgejo/workflows/deploy.yml example demonstrating:

Trigger on push to main.
Build the Next.js app (using Node 22, pnpm).
Run tests (lint + unit).
On success, hit the Dokploy webhook URL stored as a secret.
Optionally: post a Matrix message on success/failure.

Acceptance criteria

File at docs/examples/forgejo-actions-nextjs-dokploy.yml.
Comments inline explain each step.
README in docs/examples/ with a short index.
One paragraph in README.md quickstart section pointing at examples.

Pointers

Forgejo Actions docs: https://forgejo.org/docs/latest/user/actions/
Dokploy webhook URL pattern: https://<dokploy>/api/deploy/<refreshToken> for applications, /api/deploy/compose/<refreshToken> for composes.

Friendly note: take this if you've shipped at least one Next.js app and have moderate CI confidence. Post your draft in a PR early — we iterate.

## Why Many flndrn projects (and likely many community ones) deploy a Next.js app to Dokploy. A working example workflow in `docs/examples/forgejo-actions-nextjs-dokploy.yml` would be a high-leverage reference. ## Scope A complete `.forgejo/workflows/deploy.yml` example demonstrating: 1. Trigger on push to `main`. 2. Build the Next.js app (using Node 22, pnpm). 3. Run tests (lint + unit). 4. On success, hit the Dokploy webhook URL stored as a secret. 5. Optionally: post a Matrix message on success/failure. ## Acceptance criteria - [ ] File at `docs/examples/forgejo-actions-nextjs-dokploy.yml`. - [ ] Comments inline explain each step. - [ ] README in `docs/examples/` with a short index. - [ ] One paragraph in `README.md` quickstart section pointing at examples. ## Pointers - Forgejo Actions docs: https://forgejo.org/docs/latest/user/actions/ - Dokploy webhook URL pattern: `https://<dokploy>/api/deploy/<refreshToken>` for applications, `/api/deploy/compose/<refreshToken>` for composes. Friendly note: take this if you've shipped at least one Next.js app and have moderate CI confidence. Post your draft in a PR early — we iterate.