alexei.dolgolyov
1c0a7cb850
Phase 4 — New Widget Types: - Clock/Weather, System Stats, RSS/Feed, Calendar, Markdown, Metric/Counter, Link Group, Camera/Stream widgets - Backend services with caching for each data source - Full creation form with dynamic config fields per type Phase 5 — Visual & Styling Enhancements: - Glassmorphism card style (solid/glass/outline) - Board-level themes with per-board hue/saturation - Animated SVG status rings replacing static dots - Card size options (compact/medium/large) - Custom CSS injection (admin + per-board, sanitized) - Wallpaper backgrounds with blur/overlay/parallax Phase 6 — Functional Features: - Favorites bar with drag-and-drop reordering - Recent apps tracking with privacy toggle - Uptime dashboard page (/status, guest-accessible) - Notifications system (Discord/Slack/Telegram/HTTP webhooks) - App tags with filtering in board view - Multi-URL app cards with expandable sub-links - Personal API tokens with scoped permissions - Audit log with retention and admin viewer Phase 7 — Quality of Life: - Onboarding wizard (5-step first-launch setup) - App URL health preview with favicon/title detection - Board templates (4 built-in + custom import/export) - Keyboard shortcut overlay (j/k nav, 1-9 boards, ? help) 212 files changed, 15641 insertions, 980 deletions. Build, lint, type check, and 222 tests all pass.
61 lines
2.9 KiB
Markdown
61 lines
2.9 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
|
|
|
|
- [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`
|