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 insrc/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 runnpm run dev.
Configuration and assets
.env.exampledocuments safe example settings.CALENDAR_URLis required at runtime but not duringnext build.APP_URLcontrols canonical URLs, sitemap, robots, host checks, and the default CORS origin.- Original image sources live in
.media-source/; generated variants live underpublic/images/. - Use
npm run content:newfor 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.