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

44 lines
2.2 KiB
Markdown

# 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.
<!-- BEGIN:nextjs-agent-rules -->
# 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.
<!-- END:nextjs-agent-rules -->