luna-recipes/features/LESSONS-FROM-WERK.md

Lessons from WERK — Was wir bei der Rezept-App NICHT wiederholen

Architektur

• Kein Monorepo — Eine App, ein Repo, fertig
• Kein shared-stubs Chaos — Kein Packages-Ordner, alles in einem Projekt
• SQLite statt PostgreSQL — Kein Docker für DB nötig, einfacher
• Kein SSR — Reines SPA/PWA, kein hydrateRoot-Desaster

Frontend

• Relative API-URLs — Kein hardcoded localhost in .env
• Keine Radix Dialog Forms — Forms als eigene Seiten/Routes
• Mobile-first testen — Von Anfang an, nicht nachträglich

Backend

• Fastify JWT richtig — register(jwt); await app.after();
• NODE_ENV=production in Deployment, immer
• Kein pino-pretty in Production

Deployment

• Docker simpel — Ein Container, ein Service
• Keine Caddy URI-Rewrites — Einfaches Routing
• CORS von Anfang an richtig — Mit Port testen

Vorgehen

• Inkrementell — Erst lauffähiges Minimum, dann Features
• Jeden Schritt testen — Nicht 5 Features auf einmal, einzeln bauen + verifizieren
• Agent-Tasks klein halten — Ein Task = eine Sache