Static Single Page Application for building Criterion Challenge lists: pick one film per category per year with automatic filtering, export as Letterboxd CSV
- TypeScript 58.7%
- Svelte 40%
- CSS 0.7%
- HTML 0.3%
- JavaScript 0.3%
| .vite-hooks | ||
| scripts | ||
| src | ||
| static | ||
| .gitignore | ||
| .npmrc | ||
| AGENTS.md | ||
| bun.lock | ||
| components.json | ||
| Dockerfile | ||
| package.json | ||
| playwright.config.ts | ||
| README.md | ||
| tsconfig.json | ||
| vite.config.ts | ||
CC List Builder
A static single-page app for tracking a year's Criterion Challenge: pick one film per category, keep the picks on the device, and export them as a Letterboxd-importable CSV. It is installable as a PWA and works fully offline once loaded.
Stack
- TypeScript (strict), SvelteKit 3 as a static SPA (
adapter-static,ssr = false) - Svelte 5 runes only
- Tailwind v4 + shadcn-svelte
- SignalDB 2 RC, persisted to IndexedDB
- Vite+ (
vp) toolchain; package manager is bun (plainnpmfails withEBADDEVENGINES)
Commands
| Task | Command |
|---|---|
| Dev server | bun run dev |
| Production build | bun run build |
| Preview a build | bun run preview |
| Format + lint + typecheck | vp check (or --fix) |
| Unit tests | bun run test:unit -- --run |
| Unit + e2e | bun run test |
Note: vp dev / vp preview are broken in this repo — use the bun run
variants above.
Layout
src/lib/domain/— film, filter, category, curated-list types and helperssrc/lib/catalog/— pure query engines (query, facets, lines, picker logic)src/lib/letterboxd/— film matching and CSV exportsrc/lib/data/— runtime fetchers and SignalDB collectionssrc/lib/state/— module-level runes holding the app statesrc/lib/components/— Svelte components;ui/is shadcn-svelte generatedsrc/routes/[year]/— the year view (deep links are year-level only)static/data/— the film catalog, served at runtime (not bundled;catalog.jsonalone is ~6 MB)
Data
static/data/ is the in-repo source of truth for the catalog, served at
/data/... and fetched at runtime. Curated lists are looked up through
static/data/lists/index.json, which maps ids to their directory (some live
under criterion/closet-picks/ rather than lists/).
Conventions
- Copy, comments, and commit messages stay neutral about where the film data came from.
- SignalDB and the catalog engines are pure of framework code — keep I/O at
the edges (
src/lib/data/) so the engines stay testable. - Conventional Commits; a commit hook runs
vp check --fix. mainis always green:vp checkandbun run test:unit -- --runmust pass before anything lands onmain, and tests ship with the code they cover.