57 lines
2.7 KiB
Markdown
57 lines
2.7 KiB
Markdown
# 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
|
|
|
|
- [ ] Phase 1: Project Scaffolding & Tooling [backend] → [subplan](./phase-1-scaffolding.md)
|
|
- [ ] Phase 2: Database Schema & Services Layer [backend] → [subplan](./phase-2-database-services.md)
|
|
- [ ] Phase 3: Authentication System [fullstack] → [subplan](./phase-3-authentication.md)
|
|
- [ ] Phase 4: App Registry & Healthcheck [fullstack] → [subplan](./phase-4-app-healthcheck.md)
|
|
- [ ] Phase 5: Board, Section & Widget System [fullstack] → [subplan](./phase-5-board-widgets.md)
|
|
- [ ] Phase 6: Admin Panel [fullstack] → [subplan](./phase-6-admin-panel.md)
|
|
- [ ] Phase 7: UI Polish & Ambient Backgrounds [frontend] → [subplan](./phase-7-ui-polish.md)
|
|
- [ ] 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 | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
| Phase 2: Database & Services | backend | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
| Phase 3: Authentication | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
| Phase 4: App & Healthcheck | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
| Phase 5: Board & Widgets | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
| Phase 6: Admin Panel | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
| Phase 7: UI Polish | frontend | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
| Phase 8: Integration & Deploy | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
|
|
|
|
## Final Review
|
|
- [ ] Comprehensive code review
|
|
- [ ] Full build passes
|
|
- [ ] Full test suite passes
|
|
- [ ] Merged to `master`
|