Picomon Stadium
An online multiplayer Pokemon Stadium game made as if it was on the Game Boy Colour. Specced, architected, designed, and developed strictly through the use of agentic AI as a project to help better learn AI driven development.
Built with Next.js 16, Turso (via Drizzle) for storage, and Ably for realtime updates.
Setup
1. Create accounts
- Ably: sign up (free, no card), create an app, and copy the root API key. This is
ABLY_API_KEY.
- Turso: sign up, create a database, and copy its URL (
libsql://...). This is TURSO_DATABASE_URL. Then create a database token. This is TURSO_AUTH_TOKEN.
2. Configure environment variables
Copy the example file:
cp .env.example .env.local
Open .env.local and fill in ABLY_API_KEY, TURSO_DATABASE_URL, and TURSO_AUTH_TOKEN. Never commit .env.local. It holds secrets and is git-ignored.
3. Install dependencies
npm install
4. Apply database migrations
npm run db:migrate
Scripts
| Command | What it does |
|---|
npm run db:migrate | Apply migrations to the Turso database |
npm run db:generate | Generate a new migration after schema changes |
npm run dev | Start the local dev server at http://localhost:3000 |
npm test | Run the test suite (Vitest) |
npm run build | Produce a production build |
Testing alone
Each browser holds one player, by design. To test with two players from one machine:
- Start the app with
npm run dev and open http://localhost:3000 in a normal window. Host a room.
- Open a private/incognito window (or use a second browser) to http://localhost:3000. Join with the room code.
Deploying to Vercel
- Import this repository in Vercel.
- Add
ABLY_API_KEY, TURSO_DATABASE_URL, and TURSO_AUTH_TOKEN as environment variables for both Production and Preview.
- Deploy.
Vercel does not run migrations during build. Run npm run db:migrate against the Turso database once before using a new deployment.
Credits
- Polished Crystal by Rangi42 and contributors: Pokémon sprites, and modifications to Pokémon data.
- Pokémon is © Nintendo, Creatures Inc. and GAME FREAK inc. This is an unofficial fan project and is not affiliated with or endorsed by them.
