feat(mvp): phase 1 - project scaffolding & tooling

Initialize SvelteKit project with Svelte 5, TypeScript strict, Tailwind CSS v4,
shadcn-svelte, Prisma + SQLite, Vitest, ESLint, Prettier. Add Docker multi-stage
build, docker-compose, and Gitea Actions CI pipeline.
This commit is contained in:
2026-03-24 19:53:06 +03:00
parent dc9bd3bba4
commit cf6bde238c
24 changed files with 9643 additions and 18 deletions
+1 -1
View File
@@ -1,7 +1,7 @@
# Feature Context: Web App Launcher — MVP
## Current State
Fresh repository — no code yet. Only PLAN_PROMPT.md and .gitignore exist.
Phase 1 (Project Scaffolding & Tooling) is complete. The SvelteKit project is initialized with all dependencies installed (`npm install` succeeds). Config files in place: `svelte.config.js` (adapter-node), `vite.config.ts` (Tailwind v4 + Vitest), `tsconfig.json` (strict), `eslint.config.js`, `.prettierrc`, `components.json` (shadcn-svelte), `prisma/schema.prisma` (SQLite). Docker and CI configs created. Build does not pass yet (Big Bang strategy — expected).
## Temporary Workarounds
- None yet
+2 -2
View File
@@ -27,7 +27,7 @@ Build a self-hosted web application launcher/dashboard for a TrueNAS server envi
## Phases
- [ ] Phase 1: Project Scaffolding & Tooling [backend] → [subplan](./phase-1-scaffolding.md)
- [x] 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)
@@ -40,7 +40,7 @@ Build a self-hosted web application launcher/dashboard for a TrueNAS server envi
| Phase | Domain | Status | Review | Build | Committed |
|-------|--------|--------|--------|-------|-----------|
| Phase 1: Scaffolding | backend | ⬜ Not Started | | ⬜ | ⬜ |
| Phase 1: Scaffolding | backend | ✅ Complete | | ⬜ | ⬜ |
| Phase 2: Database & Services | backend | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
| Phase 3: Authentication | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
| Phase 4: App & Healthcheck | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
@@ -1,6 +1,6 @@
# Phase 1: Project Scaffolding & Tooling
**Status:** ⬜ Not Started
**Status:** ✅ Complete
**Parent plan:** [PLAN.md](./PLAN.md)
**Domain:** backend
@@ -9,19 +9,19 @@ Initialize the SvelteKit project with the full toolchain: TypeScript strict, Sve
## Tasks
- [ ] Task 1: Initialize SvelteKit project with TypeScript, Svelte 5 adapter-node
- [ ] Task 2: Install and configure Tailwind CSS v4
- [ ] Task 3: Install and configure shadcn-svelte (Bits UI primitives)
- [ ] Task 4: Install Prisma, configure SQLite provider, create initial empty schema
- [ ] Task 5: Install Vitest and configure for SvelteKit
- [ ] Task 6: Configure ESLint + Prettier for Svelte/TS
- [ ] Task 7: Install runtime dependencies: lucide-svelte, simple-icons, superforms, zod, bcrypt, jsonwebtoken, node-cron, openid-client
- [ ] Task 8: Create `.env.example` with all required env vars
- [ ] Task 9: Create `Dockerfile` (multi-stage build)
- [ ] Task 10: Create `docker-compose.yml`
- [ ] Task 11: Create `.gitea/workflows/ci.yml` (lint, type-check, test, Docker build)
- [ ] Task 12: Create `app.css` with Tailwind base + CSS custom properties for theming
- [ ] Task 13: Create `app.d.ts` with SvelteKit type augmentation (Locals, Session)
- [x] Task 1: Initialize SvelteKit project with TypeScript, Svelte 5 adapter-node
- [x] Task 2: Install and configure Tailwind CSS v4
- [x] Task 3: Install and configure shadcn-svelte (Bits UI primitives)
- [x] Task 4: Install Prisma, configure SQLite provider, create initial empty schema
- [x] Task 5: Install Vitest and configure for SvelteKit
- [x] Task 6: Configure ESLint + Prettier for Svelte/TS
- [x] Task 7: Install runtime dependencies: lucide-svelte, simple-icons, superforms, zod, bcryptjs, jsonwebtoken, node-cron
- [x] Task 8: Create `.env.example` with all required env vars
- [x] Task 9: Create `Dockerfile` (multi-stage build)
- [x] Task 10: Create `docker-compose.yml`
- [x] Task 11: Create `.gitea/workflows/ci.yml` (lint, type-check, test, Docker build)
- [x] Task 12: Create `app.css` with Tailwind base + CSS custom properties for theming
- [x] Task 13: Create `app.d.ts` with SvelteKit type augmentation (Locals, Session)
## Files to Modify/Create
- `package.json` — project config with all dependencies and scripts
@@ -60,4 +60,21 @@ Initialize the SvelteKit project with the full toolchain: TypeScript strict, Sve
- [ ] Tests pass (new + existing)
## Handoff to Next Phase
<!-- Filled in by the implementation agent after completing this phase. -->
Phase 1 scaffolding is complete. All tooling is configured and `npm install` succeeds.
**What's ready for Phase 2:**
- Prisma is installed with SQLite datasource configured at `prisma/schema.prisma` — add models there.
- `@prisma/client` is a devDependency; run `npx prisma generate` after adding models.
- `DATABASE_URL` defaults to `file:../data/launcher.db` (see `.env.example`).
- SvelteKit project structure is in place: `src/routes/+page.svelte`, `src/app.html`, `src/app.css`, `src/app.d.ts`.
- `App.Locals` type augmentation defines `user` and `session` — align with the User model in Phase 2.
- shadcn-svelte is configured via `components.json` — add UI components with `npx shadcn-svelte@latest add <component>`.
- `src/lib/utils/cn.ts` provides the `cn()` class-merge utility used by shadcn-svelte components.
**Known gaps (expected for Big Bang strategy):**
- `npm run build` will fail until SvelteKit routes and server hooks are wired up.
- `npm run check` will fail until `.svelte-kit/` is generated via `svelte-kit sync`.
- No tests exist yet — `npm test` will pass vacuously (no test files).