Save Slot
Your Game Boy collection, saved.
A collector archive for Game Boy and Game Boy Color:
discover → collect → complete → play → wishlist → remember.
The full product and build spec is in SAVE-SLOT-MASTER-PROMPT.md.
Phase reports live in reports/.
Stack
Next.js 16 (App Router, Cache Components) · TypeScript · Tailwind CSS v4 · Supabase (Postgres, Auth, Storage) · Vitest · Playwright · Vercel
Getting started
pnpm install
cp .env.example .env.local # Supabase values are optional for now
pnpm dev # http://localhost:3000
Without Supabase env vars the app uses the built-in seed catalogue (39 games from
src/data/seed/catalog.ts), so everything works offline. With the Supabase values in
.env.local it reads the real database. The design system preview is at /dev/components
(development only).
Accounts need Supabase. To try sign-in, collections and memories locally without Supabase,
start with SAVESLOT_MEMORY_BACKEND=1 pnpm dev: an in-memory backend (data is gone on restart).
The e2e tests use it too.
Database
- Migrations:
supabase/migrations/*.sql (schema, RLS, search RPC, views)
- Seed:
src/data/seed/catalog.ts → pnpm seed:generate → supabase/seed.sql
- RLS tests:
supabase/tests/rls_test.sql (always rolls back; success = RLS TESTS PASSED)
- Types:
pnpm db:types → src/lib/supabase/database.types.ts
Local Supabase (optional)
pnpm dlx supabase start # needs Docker
Scripts
| Command | What it does |
|---|
pnpm dev | Dev server |
pnpm build / pnpm start | Production build / serve |
pnpm lint · pnpm typecheck · pnpm format | Code quality |
pnpm test | Unit and component tests (Vitest, incl. colour-contrast checks) |
pnpm test:e2e | End-to-end tests (Playwright, desktop + mobile, incl. axe) |
pnpm check | Lint, typecheck, tests and build in one go |
If Playwright can't download browsers, point it at an installed Chromium with
PLAYWRIGHT_CHROMIUM_PATH=/path/to/chrome.
Legal
Save Slot is a fan-made collector archive and is not affiliated with, endorsed or sponsored by
Nintendo. Game Boy and Game Boy Color are trademarks of Nintendo. Save Slot does not host, link to
or stream ROMs.
