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.