GitTheGov/app-template
Template
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 3
Template repo for GitTheGov microservice apps
23 commits 1 branch 0 tags 109 KiB
  • TypeScript 89.5%
  • CSS 7.3%
  • Dockerfile 1.6%
  • Shell 1%
  • JavaScript 0.6%
Find a file Use this template
Exact
Vinnie Esposito fec6c00be6
Some checks failed
preview.yml / fix: replace espodev.com reference with espoautos.com in deploy comment (push) Failing after 0s
Details
build-and-deploy / build (push) Failing after 12m47s
Details
fix: replace espodev.com reference with espoautos.com in deploy comment 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-22 09:50:41 -05:00
.forgejo/workflows fix: replace espodev.com reference with espoautos.com in deploy comment 2026-04-22 09:50:41 -05:00
k8s fix(deploy): template cert-manager cluster-issuer from vars/domain (#2) 2026-04-21 17:49:27 +00:00
public feat: upgrade template to full-stack Next.js with DB/S3/auth wiring 2026-04-18 11:20:02 -05:00
seed feat: upgrade template to full-stack Next.js with DB/S3/auth wiring 2026-04-18 11:20:02 -05:00
src feat(auth): request explicit read:user scope from Forgejo OAuth 2026-04-21 22:00:18 -05:00
.dockerignore feat: upgrade template to full-stack Next.js with DB/S3/auth wiring 2026-04-18 11:20:02 -05:00
.gitignore template: drop bun.lock so new apps aren't frozen to template-time deps 2026-04-18 11:34:50 -05:00
CLAUDE.md docs: put file-proxy route at src/app/files/ (not under /api/) 2026-04-21 18:52:53 -05:00
docker-entrypoint.sh apply schema.sql at container start; postgresql-client in runner 2026-04-18 11:58:00 -05:00
Dockerfile apply schema.sql at container start; postgresql-client in runner 2026-04-18 11:58:00 -05:00
next.config.js harden template: DBOS SDK helper, next.config externals, pivot guide 2026-04-21 18:44:24 -05:00
package.json harden template: DBOS SDK helper, next.config externals, pivot guide 2026-04-21 18:44:24 -05:00
PLATFORM.md feat: upgrade template to full-stack Next.js with DB/S3/auth wiring 2026-04-18 11:20:02 -05:00
README.md feat: upgrade template to full-stack Next.js with DB/S3/auth wiring 2026-04-18 11:20:02 -05:00
schema.sql feat: upgrade template to full-stack Next.js with DB/S3/auth wiring 2026-04-18 11:20:02 -05:00
tsconfig.json feat: upgrade template to full-stack Next.js with DB/S3/auth wiring 2026-04-18 11:20:02 -05:00

README.md

template

Reference app template for the platform. Next.js 15 + React 19, with first-class access to the platform's provisioned resources:

  • Postgres — per-app database, connection string in DATABASE_URL
  • S3/MinIO — per-app bucket, creds in S3_ACCESS_KEY / S3_SECRET_KEY
  • Forgejo OAuth — OIDC-via-better-auth, creds in AUTH_FORGEJO_*

Created from this template by create_app (op-api MCP tool), which provisions a fresh namespace, database, bucket, and OAuth application automatically.

Workflows

  • .forgejo/workflows/deploy.yml — builds on push to main, pushes image to the in-cluster registry, and writes the new SHA back to k8s/deployment.yaml with [skip ci] to break the loop.
  • .forgejo/workflows/preview.yml — builds a preview image on PR open and POSTs create_preview to op-api, which lands a short-lived namespace.
  • .forgejo/workflows/cleanup.yml — fires on PR close, POSTs delete_preview.

Local development

bun install
bun run dev   # http://localhost:3000

See PLATFORM.md for the platform contract and CLAUDE.md for how to work with this codebase.