64 lines
2.7 KiB
Markdown
64 lines
2.7 KiB
Markdown
# Phase 1: Project Scaffolding & Tooling
|
|
|
|
**Status:** ⬜ Not Started
|
|
**Parent plan:** [PLAN.md](./PLAN.md)
|
|
**Domain:** backend
|
|
|
|
## Objective
|
|
Initialize the SvelteKit project with the full toolchain: TypeScript strict, Svelte 5, Tailwind CSS v4, shadcn-svelte, Prisma + SQLite, Vitest, ESLint, Prettier. Create the Docker and CI configuration.
|
|
|
|
## 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)
|
|
|
|
## Files to Modify/Create
|
|
- `package.json` — project config with all dependencies and scripts
|
|
- `svelte.config.js` — SvelteKit config with adapter-node
|
|
- `vite.config.ts` — Vite config with Vitest
|
|
- `tsconfig.json` — TypeScript strict config
|
|
- `tailwind.config.ts` — Tailwind v4 config
|
|
- `src/app.css` — Tailwind imports + theme variables
|
|
- `src/app.d.ts` — SvelteKit type augmentation
|
|
- `src/app.html` — HTML template
|
|
- `prisma/schema.prisma` — empty schema with SQLite datasource
|
|
- `.env.example` — template env vars
|
|
- `Dockerfile` — multi-stage Node build
|
|
- `docker-compose.yml` — single-service deployment
|
|
- `.gitea/workflows/ci.yml` — CI pipeline
|
|
- `eslint.config.js` — ESLint flat config
|
|
- `.prettierrc` — Prettier config
|
|
|
|
## Acceptance Criteria
|
|
- `npm install` succeeds
|
|
- Project structure matches SvelteKit conventions
|
|
- All config files are valid
|
|
- Dockerfile builds (structure-wise, not the app itself yet)
|
|
|
|
## Notes
|
|
- Use `@sveltejs/adapter-node` for Docker deployment
|
|
- Svelte 5 runes mode is the default in latest SvelteKit — no special config needed
|
|
- Tailwind v4 uses the new CSS-based config approach
|
|
- ⚠️ Big Bang: build will not pass yet — no routes or components exist
|
|
|
|
## Review Checklist
|
|
- [ ] All tasks completed
|
|
- [ ] Code follows project conventions
|
|
- [ ] No unintended side effects
|
|
- [ ] Build passes
|
|
- [ ] Tests pass (new + existing)
|
|
|
|
## Handoff to Next Phase
|
|
<!-- Filled in by the implementation agent after completing this phase. -->
|