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.
pnpm installpnpm 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.pnpm db:env writes .env.development.local with your local Supabase URL and keys.- For the planner, put your own
ANTHROPIC_API_KEY in .env.development.local (or .env.local).
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.
