web-app-launcher/plans/mvp-web-app-launcher/CONTEXT.md

Feature Context: Web App Launcher — MVP

Current State

Fresh repository — no code yet. Only PLAN_PROMPT.md and .gitignore exist.

Temporary Workarounds

• None yet

Cross-Phase Dependencies

• Phase 2 depends on Phase 1 (project scaffolding, Prisma setup)
• Phase 3 depends on Phase 2 (user/group models, auth service)
• Phase 4 depends on Phase 2 (app model, services layer)
• Phase 5 depends on Phase 2 (board/section/widget models) and Phase 4 (app widget references apps)
• Phase 6 depends on Phases 3-5 (admin needs auth, app, board entities)
• Phase 7 depends on Phase 1 (Tailwind, shadcn-svelte) and Phase 5 (board layout to polish)
• Phase 8 depends on all prior phases

Implementation Notes

• Big Bang strategy: intermediate phases may not build/pass tests. Only Phase 8 must result in a fully working build.
• SQLite with Prisma — single file DB at data/launcher.db
• All env config via environment variables; .env.example provided as template
• Svelte 5 runes mode: use $state, $derived, $effect — NOT legacy stores for component state
• shadcn-svelte uses Bits UI primitives — each component is a local file, not a library import