Files
Goldebek/AGENTS.md
T
Per Hoener b57c24a3c4
Deploy / validate-dispatch (push) Successful in 1s
Deploy / scheduled-rebuild-dev (push) Skipped
Deploy / scheduled-rebuild-master (push) Skipped
Deploy / rollback-dev (push) Skipped
Deploy / rollback-master (push) Skipped
Deploy / changes (push) Successful in 6s
Deploy / app-quality (push) Successful in 1m16s
Deploy / secret-scan (push) Successful in 4s
Deploy / security-deps (push) Successful in 18s
Deploy / context (push) Successful in 1s
Deploy / app-image (push) Successful in 1m28s
Deploy / deploy-master (push) Skipped
Deploy / deploy-dev (push) Successful in 13s
feat: build official Goldebek municipal website
2026-09-19 15:09:27 +02:00

2.2 KiB

Repository Notes

Next.js

This repository uses Next.js 16 with breaking changes relative to earlier versions. Read the relevant guide in node_modules/next/dist/docs/ before changing framework code and heed deprecation notices.

Shape

  • The Next.js application lives at the repository root and uses the App Router, React 19, TypeScript, and output: "standalone".
  • Pages, GET /api/events, and health routes run in one Node.js process.
  • Calendar data is fetched at runtime from an external ICS source.
  • TSX content modules live under src/trip-reports/ and are registered in src/trip-reports/index.ts.

Commands

  • Install dependencies exactly as CI does: npm ci.
  • Checks: npm run lint, npm run typecheck, npm run test, npm run build.
  • E2E smoke test: npm run test:e2e.
  • Dev server: set CALENDAR_URL, then run npm run dev.

Configuration and assets

  • .env.example documents safe example settings.
  • CALENDAR_URL is required at runtime but not during next build.
  • APP_URL controls canonical URLs, sitemap, robots, host checks, and the default CORS origin.
  • Original image sources live in .media-source/; generated variants live under public/images/.
  • Use npm run content:new for new TSX content modules.

CI and deployment

  • Workflows live in .gitea/workflows/.
  • CI runs lint, Vitest, typecheck, build, E2E, and security scans.
  • Deploy builds and scans a configurable container image, deploys with Docker Compose, verifies app/API/health routes, and supports rollback.

This is NOT the Next.js you know

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ (resolved from this file's directory; in monorepos the next package may not be visible from the repo root) before writing any code. Heed deprecation notices.

This block is written and re-added by next dev — verify at node_modules/next/dist/server/lib/generate-agent-files.js. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.