# Nachklang Calendar

Event calendar for Nachklang e.V.: a public landing page for subscribing to the calendar, and an
admin area (`/admin`) for editing events in all calendars.

Next.js (App Router) + TypeScript + Tailwind + shadcn, the same stack as `nachklang-feedback`.
Rewritten from Angular in September 2026 ([docs/rewrite-plan.md](docs/rewrite-plan.md)).

Documentation: [architecture](docs/architecture.md) · [features](docs/features.md) ·
[gotchas](docs/gotchas.md) · [deployment](docs/deployment.md) · [API wish list](docs/api-wishlist.md)

## Development

```bash
cp .env.local.example .env.local   # then adjust if needed
npm install
npm run dev                        # http://localhost:4200
```

Port 4200 is not arbitrary: it is the port the API's better-auth origins and the admin app's
redirect allow-list trust. Another port breaks sign-out and the return redirect after sign-in.

The admin area needs the API (`:3000`) and the admin app (`:3002`) running locally.

## Other scripts

```bash
npm run build   # production build (output: standalone; see docs/deployment.md)
npm run lint
npm test        # Vitest, pure logic in lib/
```