Classic WoW Forever

"I have N minutes tonight. What should this character do?"

A session planner for World of Warcraft: Forever. Route guides tell you the fastest path; this tells a time-poor adult the best use of the time slot they actually have.

Don't want to self host? Use classicwowforever.dev.

Status

Built so far:

• Launch countdown and waitlist (Milestone 1)
• Rested XP calculator at /rested
• An example plan at /p/example with a working session timer
• The database schema for Milestones 2 and 3, with tested security rules
• Magic-link sign-in and the Characters pages (Milestone 2)
• The planner at /plan, with quota, feedback and shareable plans (Milestone 3)
• Planner evals in evals/ (Milestone 4)
• Reviewed game data in data/, validated in CI and synced to the database on merge
• Report a quest at /report, with a review queue for data keepers (pnpm reports)
• A one-line prompt on the home page that sets up the planner
• Group sessions: roles, the right dungeon for the group's levels and time, and a plan for the whole party

docs/plan-changes.md records the decisions made since the original plan.

Stack

• Next.js (App Router, TypeScript, Tailwind CSS) on Vercel
• Supabase for Postgres and auth
• Claude API for plan generation (from Milestone 3)
• Python for evals (from Milestone 3)

Run it locally

You need Node.js (latest LTS), pnpm, and Docker.

1. pnpm install
2. pnpm db:start starts a local Supabase (Postgres, Auth, and a test inbox) in Docker. It applies supabase/migrations/ and supabase/seed.sql automatically. The first run downloads a few images.
3. pnpm db:env writes .env.development.local with your local Supabase URL and keys.
4. For the planner, put your own ANTHROPIC_API_KEY in .env.development.local (or .env.local).
5. pnpm dev, then open http://localhost:3000.

Sign in with any address: the email lands in the local inbox at http://127.0.0.1:54324, not a real mailbox. pnpm dev always uses the local database; .env.local holds production values for scripts and is never used in development.

Command	What it does
pnpm dev	Dev server, against local Supabase
pnpm test	Unit tests (Vitest)
pnpm lint	ESLint
pnpm build	Production build
pnpm db:start	Start local Supabase (Docker)
pnpm db:reset	Rebuild the local database from migrations and seed
pnpm db:stop	Stop local Supabase
pnpm db:env	Write .env.development.local for the running local stack
pnpm test:db	Security and quota tests on a throwaway Postgres (TEST_DATABASE_URL)
pnpm evals	Planner evals against the Claude API (see evals/README.md)
pnpm data:check	Validate the game data in data/zones/
pnpm data:sync	Copy game data into a database (--local or --production; dry run until --yes)
pnpm data:generate	Regenerate supabase/seed.sql and the data JSON Schema from data/
pnpm reports	Review players' quest reports and add them to data/ (see data/README.md)
pnpm icons	Copy the icons listed in scripts/icons.mts into components/icons/

Project layout

app/                    pages and routes (App Router)
  actions/              Server Actions (form posts)
  p/[shareId]/          shared plan page and its preview image
  rested/               rested XP calculator
components/             React components (planner/ holds the plan card and timer)
lib/
  theme.ts              color tokens, the only place hex values live
  schema.ts             Zod schemas for plans (model output and stored)
  prompts/              the planner's system prompt, shared with the evals
  rested.ts, timer.ts   pure logic behind the calculator and session timer
  supabase/             admin (secret key) and public (anon) clients
supabase/migrations/    SQL migrations
data/zones/             game data, one JSON file per zone (see data/README.md)
supabase/seed.sql       generated from data/ for local databases
supabase/tests/         security and quota tests run by pnpm test:db
docs/                   decisions and setup notes
assets/fonts/           fonts used to render preview images (OFL)

Contributing

See CONTRIBUTING.md. You don't need to write code; accurate quest data matters just as much.

License

The web app is AGPL 3.0. Game data in data/ is CC BY-SA 4.0. Cinzel and Inter (in assets/fonts/) are under the SIL Open Font License. Icons are from game-icons.net under CC BY 3.0, credited on the site's Open Source page.

Classic WoW Forever is a fan project, not affiliated with Blizzard Entertainment.