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%
Find a file
2026-11-22 16:33:49 +00:00
.vite-hooks first commit 2026-10-20 23:52:12 +02:00
scripts feat: default filter for other years' challenge picks 2026-11-08 19:56:34 +01:00
src feat(share): preview mode for shared links 2026-11-22 14:16:53 +01:00
static fix(data): add missing members to 6 boxsets 2026-11-21 11:34:12 +01:00
.gitignore chore: gitignore local data data-sync scripts 2026-11-14 09:35:32 +01:00
.npmrc first commit 2026-10-20 23:52:12 +02:00
AGENTS.md chore: remove the retired migrate-data script 2026-10-31 21:08:19 +01:00
bun.lock chore: rename project to cc-list-builder, centralize database names, bump to 0.1.0 2026-11-10 21:47:35 +01:00
components.json feat: add app shell, year route, and theme 2026-10-21 08:37:03 +02:00
Dockerfile chore: add Dockerfile for static deployment 2026-11-22 17:32:54 +01:00
package.json chore: rename project to cc-list-builder, centralize database names, bump to 0.1.0 2026-11-10 21:47:35 +01:00
playwright.config.ts first commit 2026-10-20 23:52:12 +02:00
README.md docs: replace sv template README with project overview 2026-11-22 16:46:15 +01:00
tsconfig.json feat: add app shell, year route, and theme 2026-10-21 08:37:03 +02:00
vite.config.ts chore: remove the retired migrate-data script 2026-10-31 21:08:19 +01:00

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 (plain npm fails with EBADDEVENGINES)

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 helpers
  • src/lib/catalog/ — pure query engines (query, facets, lines, picker logic)
  • src/lib/letterboxd/ — film matching and CSV export
  • src/lib/data/ — runtime fetchers and SignalDB collections
  • src/lib/state/ — module-level runes holding the app state
  • src/lib/components/ — Svelte components; ui/ is shadcn-svelte generated
  • src/routes/[year]/ — the year view (deep links are year-level only)
  • static/data/ — the film catalog, served at runtime (not bundled; catalog.json alone 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.
  • main is always green: vp check and bun run test:unit -- --run must pass before anything lands on main, and tests ship with the code they cover.