# Feature: Web App Launcher — MVP

**Branch:** `feature/mvp-web-app-launcher`
**Base branch:** `master`
**Created:** 2026-03-24
**Status:** 🟡 In Progress
**Strategy:** Big Bang
**Mode:** Automated
**Execution:** Orchestrator

## Summary

Build a self-hosted web application launcher/dashboard for a TrueNAS server environment. The MVP includes local auth + guest mode, app CRUD with healthchecks, a single default board with sections and app widgets, an admin panel, dark theme with ambient backgrounds, and Docker deployment with Gitea CI.

## Build & Test Commands

- **Build:** `npm run build`
- **Test:** `npm test`
- **Lint:** `npm run lint`
- **Type Check:** `npm run check`

## Tech Stack

- **Framework:** SvelteKit (Svelte 5 runes mode) + TypeScript strict
- **UI:** Tailwind CSS v4 + shadcn-svelte (Bits UI) + Lucide Svelte + Simple Icons
- **Data:** Prisma ORM + SQLite + Superforms + Zod
- **Auth:** bcrypt + JWT (HTTP-only cookies) + refresh token rotation
- **Background Jobs:** node-cron
- **DevOps:** Docker (multi-stage) + docker-compose + Gitea Actions

## Phases

- [x] Phase 1: Project Scaffolding & Tooling [backend] → [subplan](./phase-1-scaffolding.md)
- [x] Phase 2: Database Schema & Services Layer [backend] → [subplan](./phase-2-database-services.md)
- [x] Phase 3: Authentication System [fullstack] → [subplan](./phase-3-authentication.md)
- [x] Phase 4: App Registry & Healthcheck [fullstack] → [subplan](./phase-4-app-healthcheck.md)
- [x] Phase 5: Board, Section & Widget System [fullstack] → [subplan](./phase-5-board-widgets.md)
- [x] Phase 6: Admin Panel [fullstack] → [subplan](./phase-6-admin-panel.md)
- [x] Phase 7: UI Polish & Ambient Backgrounds [frontend] → [subplan](./phase-7-ui-polish.md)
- [x] Phase 8: Integration, Testing & Deployment [fullstack] → [subplan](./phase-8-integration-deploy.md)

## Phase Progress Log

| Phase                         | Domain    | Status      | Review | Build | Committed |
| ----------------------------- | --------- | ----------- | ------ | ----- | --------- |
| Phase 1: Scaffolding          | backend   | ✅ Complete | ✅     | ⬜    | ⬜        |
| Phase 2: Database & Services  | backend   | ✅ Complete | ⬜     | ⬜    | ⬜        |
| Phase 3: Authentication       | fullstack | ✅ Complete | ⬜     | ⬜    | ⬜        |
| Phase 4: App & Healthcheck    | fullstack | ✅ Complete | ⬜     | ⬜    | ⬜        |
| Phase 5: Board & Widgets      | fullstack | ✅ Complete | ⬜     | ⬜    | ⬜        |
| Phase 6: Admin Panel          | fullstack | ✅ Complete | ⬜     | ⬜    | ⬜        |
| Phase 7: UI Polish            | frontend  | ✅ Complete | ⬜     | ⬜    | ⬜        |
| Phase 8: Integration & Deploy | fullstack | ✅ Complete | ✅     | ✅    | ⬜        |

## Final Review

- [ ] Comprehensive code review
- [ ] Full build passes
- [ ] Full test suite passes
- [ ] Merged to `master`