Battle Royale for Coders — Tetris 99 meets programming in a fast-paced multiplayer coding game.

Leet 99 is a real-time multiplayer battle royale game where players race to solve bite-sized tech interview-style problems. Unsolved problems stack up — if your stack overflows, you're eliminated. Solve problems to score points and attack your opponents with devious debuffs. Last coder standing wins!

• 2-99 Players — Join rooms with friends or compete against bots
• Real-time Combat — Attacks, debuffs, and garbage problems keep everyone on edge
• Stack Overflow Mechanic — Problems pile up; overflow = elimination
• Tetris 99-style Targeting — Choose your targeting mode: Random, Attackers, Top Score, or Near Death
• Function-only Python Problems — Quick to read, fast to solve (1-5 minutes each)

Read problem → Write code → Run (test) → Submit → Attack! → Next problem

1. Start with 1 active problem + 2 queued problems in your stack
2. Solve problems to earn points and automatically attack your target
3. New problems arrive periodically — they push onto your stack
4. Stack overflow? You're eliminated!
5. Last player standing wins (or highest score when time expires)

When you solve a problem, you attack your current target:

Spend your hard-earned points to gain an edge:

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Browser   │────▶│   Next.js   │────▶│  Supabase   │
│   (Client)  │     │   (Vercel)  │     │  (Postgres) │
└──────┬──────┘     └─────────────┘     └─────────────┘
       │
       │ WebSocket
       ▼
┌─────────────┐     ┌─────────────┐
│  PartyKit   │────▶│  Judge0 CE  │
│   (Room)    │     │ (RapidAPI)  │
└─────────────┘     └─────────────┘

leet-99/
├── apps/
│   └── web/              # Next.js frontend application
├── packages/
│   ├── contracts/        # Shared TypeScript types & Zod schemas
│   ├── realtime/         # PartyKit room logic (game engine)
│   ├── supabase/         # Database queries & types
│   └── ui/               # Shared React components
├── docs/                 # Design documents & specs
└── supabase/             # Database migrations

"Riced Workstation" Aesthetic — Inspired by r/unixporn tiling WM setups:

• Dark theme (harsh white "Flashbang" for the debuff 😈)
• Sharp edges, minimal border-radius
• Dense but readable information layout
• IBM Plex fonts (Sans + Mono)
• Subtle noise grain texture

• ❌ Purple gradients on white (AI-generated startup slop)
• ❌ Rounded-everything soft UI
• ❌ Default SaaS fonts
• ❌ Empty decorative space

Client → Server:

• JOIN_ROOM — Authenticate and join
• SET_TARGET_MODE — Change targeting mode
• RUN_CODE — Run public tests
• SUBMIT_CODE — Submit for scoring
• SPEND_POINTS — Purchase shop item
• SPECTATE_PLAYER — Watch another player

Server → Client:

• ROOM_SNAPSHOT — Full state sync
• PLAYER_UPDATE — Player state change
• JUDGE_RESULT — Code execution result
• ATTACK_RECEIVED — Incoming attack
• MATCH_END — Game over + standings

• Node.js 20+
• pnpm 8+
• RapidAPI account (for Judge0)
• Supabase project
• PartyKit account

Copy .env.example to .env.local and configure:

# PartyKit
NEXT_PUBLIC_PARTYKIT_HOST=your-project.partykit.dev

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-key

# Judge0 (RapidAPI)
RAPIDAPI_KEY=your-rapidapi-key
RAPIDAPI_HOST=judge0-ce.p.rapidapi.com

# Install dependencies
pnpm install

# Start development servers
pnpm dev

# Deploy PartyKit
npx partykit deploy

# Deploy to Vercel
vercel deploy

Sim bots keep lobbies lively for demos:

• Solve Time: Easy 30-60s, Medium 45-90s, Hard 60-120s
• Failure Rate: ~20% of submissions fail
• Targeting: Always random
• Shop: Never buys items

Bots participate fully in scoring, stacks, and elimination.

• Design Document — Full game design spec
• Frontend UI Spec — UI/UX guidelines and layouts
• Backend API Spec — Complete API reference

• ✅ Players can create/join rooms via URL
• ✅ 2+ players see each other in minimap with synced game state
• ✅ Problems push onto stack; RUN_CODE tests public, SUBMIT_CODE tests all
• ✅ Correct submissions award points, advance problems, send attacks
• ✅ Stack overflow eliminates players
• ✅ Winner determined: last alive or highest score
• ✅ Bots fill lobbies for demos
• ✅ Deployed publicly

May the best coder survive! 🧑‍💻⚔️