chore(release): 2.19.0 [skip ci]

## [2.19.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.18.0...v2.19.0) (2025-10-10) ### Features * add player ownership helper to player-manager API ([6b59a82](6b59a828aa)) ### Code Refactoring * migrate session-manager.ts to use centralized player ownership ([d3b7cc2](d3b7cc25ca))
feat: add player ownership helper to player-manager API
2025-10-10 13:57:10 +00:00 · 2025-10-10 08:56:15 -05:00 · 2025-10-10 08:55:24 -05:00 · 2025-10-10 13:54:04 +00:00 · 2025-10-10 08:53:11 -05:00 · 2025-10-10 13:51:00 +00:00
434 changed files with 42355 additions and 23442 deletions
--- a/.claude/terminology.md
+++ b/.claude/terminology.md
@@ -0,0 +1,57 @@
+# Soroban Abacus Flashcards - Terminology Reference
+
+## User vs Player vs Room Member
+
+**CRITICAL**: Do not confuse these three concepts!
+
+### Quick Reference
+
+- **USER** = Identity/account (one per person, identified by `guestId` cookie)
+- **PLAYER** = Game avatar/profile (multiple per user, from `players` table)
+- **ROOM MEMBER** = USER's participation in a multiplayer room
+
+### Key Rule
+
+**When a USER joins a room, their ACTIVE PLAYERS join the game.**
+
+Example:
+- USER "Jane" has 3 players: Alice, Bob, Charlie
+- Alice and Bob are active (`isActive: true`)
+- When Jane joins a room, Alice and Bob participate in the game
+- The `arcade_sessions.activePlayers` array contains `[alice_id, bob_id]`
+
+### Database Schema
+
+```
+users (identity)
+  ├─ players (avatars/profiles) - where isActive = true
+  └─ room_members (room participation)
+
+arcade_sessions
+  ├─ userId: references users.id
+  ├─ activePlayers: Array<player.id> ← PLAYER IDs, not USER IDs!
+  └─ roomId: references arcade_rooms.id
+```
+
+### Common Mistakes to Avoid
+
+❌ Using USER ID in `activePlayers` - should be PLAYER IDs
+❌ Assuming one USER = one PLAYER - users can have multiple players
+❌ Tracking game moves/scores by USER - should track by PLAYER
+❌ Confusing room_members.displayName with players.name - different concepts
+
+### Full Documentation
+
+See: `docs/terminology-user-player-room.md` for complete explanation with examples.
+
+## Other Project-Specific Terms
+
+### Arcade vs Games
+
+- **`/games/*`** - Single player or local multiplayer (same device)
+- **`/arcade/*`** - Online multiplayer with sessions and rooms
+
+### Session Types
+
+- **Solo Session**: `arcade_sessions.roomId = null`, user playing alone
+- **Room Session**: `arcade_sessions.roomId = room_xyz`, shared game state across room members
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,458 @@
+## [2.19.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.18.0...v2.19.0) (2025-10-10)
+
+
+### Features
+
+* add player ownership helper to player-manager API ([6b59a82](https://github.com/antialias/soroban-abacus-flashcards/commit/6b59a828aabe687abb797c1f1d69d8a4d0abe49b))
+
+
+### Code Refactoring
+
+* migrate session-manager.ts to use centralized player ownership ([d3b7cc2](https://github.com/antialias/soroban-abacus-flashcards/commit/d3b7cc25caee7e005de046792202aa474edbc90f))
+
+## [2.18.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.17.3...v2.18.0) (2025-10-10)
+
+
+### Features
+
+* add centralized player ownership utilities module ([52e0de0](https://github.com/antialias/soroban-abacus-flashcards/commit/52e0de022fcd332fc4cfffa7bfcfe6adc69cb3ff))
+
+## [2.17.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.17.2...v2.17.3) (2025-10-10)
+
+
+### Bug Fixes
+
+* correct build-info.json import path in type declaration ([22f0be4](https://github.com/antialias/soroban-abacus-flashcards/commit/22f0be4d045c6afdcb98b876f709d63a904f9449))
+
+
+### Documentation
+
+* add plan for centralizing player ownership logic ([d3ff89a](https://github.com/antialias/soroban-abacus-flashcards/commit/d3ff89a0ee53c32cc68ed01bf460919aa889d6a0))
+
+## [2.17.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.17.1...v2.17.2) (2025-10-10)
+
+
+### Bug Fixes
+
+* correct playerMetadata userId assignment for room-based multiplayer ([53797db](https://github.com/antialias/soroban-abacus-flashcards/commit/53797dbb2d5ccb80e61cbc186ca0a344fe1fbd96))
+
+## [2.17.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.17.0...v2.17.1) (2025-10-10)
+
+
+### Bug Fixes
+
+* correct hover avatar and turn indicator to show only current player ([0596ef6](https://github.com/antialias/soroban-abacus-flashcards/commit/0596ef65879a303f1f71863ef307af69bf270c70))
+
+## [2.17.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.7...v2.17.0) (2025-10-10)
+
+
+### Features
+
+* hide hover avatar when card is flipped to reveal value ([a2aada2](https://github.com/antialias/soroban-abacus-flashcards/commit/a2aada2e6922fb3af363e0d191275e06b8f8f040))
+
+## [2.16.7](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.6...v2.16.7) (2025-10-10)
+
+
+### Bug Fixes
+
+* compile TypeScript server files to JavaScript for production ([83b9a4d](https://github.com/antialias/soroban-abacus-flashcards/commit/83b9a4d976fa540782826afa13a35c92e706bf1e))
+* remove standalone output mode incompatible with custom server ([c8da5a8](https://github.com/antialias/soroban-abacus-flashcards/commit/c8da5a8340c8798bba452b43244bc0e04ce8b0c5))
+* update Dockerfile for non-standalone production builds ([14746c5](https://github.com/antialias/soroban-abacus-flashcards/commit/14746c568e58f4a847e0da2d866dbaeabf5a0e8b))
+
+## [2.16.6](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.5...v2.16.6) (2025-10-10)
+
+
+### Bug Fixes
+
+* correct static files and public path in Docker image ([c287b19](https://github.com/antialias/soroban-abacus-flashcards/commit/c287b19a39e1506033db6de39aa4d3761cb65d62))
+
+## [2.16.5](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.4...v2.16.5) (2025-10-09)
+
+
+### Bug Fixes
+
+* correct node_modules path for pnpm symlinks in Docker ([c12351f](https://github.com/antialias/soroban-abacus-flashcards/commit/c12351f2c99daaed710a1136eb13f6ccc54cbcff))
+
+## [2.16.4](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.3...v2.16.4) (2025-10-09)
+
+
+### Bug Fixes
+
+* correct Docker CMD to use root-level server.js ([48b47e9](https://github.com/antialias/soroban-abacus-flashcards/commit/48b47e9bdb0da44746282cd7cf7599a69bf5130d))
+
+## [2.16.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.2...v2.16.3) (2025-10-09)
+
+
+### Bug Fixes
+
+* use game state playerMetadata instead of GameModeContext in UI components ([388c254](https://github.com/antialias/soroban-abacus-flashcards/commit/388c25451d11b85236c1f7682fe2f7a62a15d5eb))
+
+## [2.16.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.1...v2.16.2) (2025-10-09)
+
+
+### Bug Fixes
+
+* use only local user's players in LocalMemoryPairsProvider ([c26138f](https://github.com/antialias/soroban-abacus-flashcards/commit/c26138ffb55a237a99cb6ff399c8a2ac54a22b51))
+
+## [2.16.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.16.0...v2.16.1) (2025-10-09)
+
+
+### Bug Fixes
+
+* convert LocalMemoryPairsProvider to pure client-side with useReducer ([b128db1](https://github.com/antialias/soroban-abacus-flashcards/commit/b128db1783a8dcffe7879745c3342add2f9ffe29))
+
+## [2.16.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.15.0...v2.16.0) (2025-10-09)
+
+
+### Features
+
+* fade out hover avatar when player stops hovering ([820eeb4](https://github.com/antialias/soroban-abacus-flashcards/commit/820eeb4fb03ad8be6a86dd0a26e089052224f427))
+
+## [2.15.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.3...v2.15.0) (2025-10-09)
+
+
+### Features
+
+* implement smooth hover avatar animations with react-spring ([442c6b4](https://github.com/antialias/soroban-abacus-flashcards/commit/442c6b4529ba5c820b1fe8a64805a3d85489a8ea))
+
+## [2.14.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.2...v2.14.3) (2025-10-09)
+
+
+### Bug Fixes
+
+* enable smooth spring animations between card hovers ([8d53b58](https://github.com/antialias/soroban-abacus-flashcards/commit/8d53b589aa17ebc6d0a9251b3006fd8a90f90a61))
+
+## [2.14.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.1...v2.14.2) (2025-10-09)
+
+
+### Bug Fixes
+
+* correct avatar positioning to prevent fly-in animation ([573d0df](https://github.com/antialias/soroban-abacus-flashcards/commit/573d0df20dcdac41021c46feb423dbf3782728f6))
+
+## [2.14.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.14.0...v2.14.1) (2025-10-09)
+
+
+### Bug Fixes
+
+* prevent avatar fly-in and hide local player's own hover ([7f65a67](https://github.com/antialias/soroban-abacus-flashcards/commit/7f65a67cef3d7f0ebce1bd7417972a6138acfc46))
+
+## [2.14.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.13.0...v2.14.0) (2025-10-09)
+
+
+### Features
+
+* improve hover avatars with smooth animation and 3D elevation ([71b11f4](https://github.com/antialias/soroban-abacus-flashcards/commit/71b11f4ef08a5f9c3f1c1aaabca21ef023d5c0ce))
+
+## [2.13.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.12.3...v2.13.0) (2025-10-09)
+
+
+### Features
+
+* implement networked hover presence for multiplayer gameplay ([62f3730](https://github.com/antialias/soroban-abacus-flashcards/commit/62f3730542334a0580f5dad1c73adc333614ee58))
+
+
+### Code Refactoring
+
+* move canModifyPlayers logic into provider layer ([db9f909](https://github.com/antialias/soroban-abacus-flashcards/commit/db9f9096b446b078e1b4dfe970723bef54a6f4ae))
+* properly separate LocalMemoryPairsProvider and RoomMemoryPairsProvider ([98822ec](https://github.com/antialias/soroban-abacus-flashcards/commit/98822ecda52bf004d9950e3f4c92c834fd820e49))
+
+## [2.12.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.12.2...v2.12.3) (2025-10-09)
+
+
+### Bug Fixes
+
+* always show game control buttons in room-based sessions ([14ba422](https://github.com/antialias/soroban-abacus-flashcards/commit/14ba422919abd648e2a134ce167a5e6fd9f84e73))
+
+## [2.12.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.12.1...v2.12.2) (2025-10-09)
+
+
+### Bug Fixes
+
+* use RoomMemoryPairsProvider in room page ([c279731](https://github.com/antialias/soroban-abacus-flashcards/commit/c27973191f0144604e17a8a14adf0a88df476e27))
+
+## [2.12.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.12.0...v2.12.1) (2025-10-09)
+
+
+### Bug Fixes
+
+* export MemoryPairsContext to fix provider hook error ([80ad33e](https://github.com/antialias/soroban-abacus-flashcards/commit/80ad33eec0b6946702eaa9cf1b1c246852864b00))
+
+## [2.12.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.11.0...v2.12.0) (2025-10-09)
+
+
+### Features
+
+* add networked hover state infrastructure for multiplayer presence ([d149799](https://github.com/antialias/soroban-abacus-flashcards/commit/d14979907c5df9b793a1c110028fc5b54457f507))
+
+## [2.11.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.10.1...v2.11.0) (2025-10-09)
+
+
+### Features
+
+* add pause/resume game state architecture ([05eacac](https://github.com/antialias/soroban-abacus-flashcards/commit/05eacac438dbaf405ce91e188c53dbbe2e9f9507))
+* add Resume button and config change warning to setup UI ([b5ee04f](https://github.com/antialias/soroban-abacus-flashcards/commit/b5ee04f57651f53517468fcc4c456f0ccb65a8e2))
+* implement pause/resume in game providers with optimistic updates ([ce30fca](https://github.com/antialias/soroban-abacus-flashcards/commit/ce30fcaf55270f9089249bd13ba73a25fbfa5ab4))
+
+
+### Bug Fixes
+
+* convert guestId to internal userId for player ownership check ([3a01f46](https://github.com/antialias/soroban-abacus-flashcards/commit/3a01f4637d2081c66fe37c7f8cfee229442ec744))
+* implement shared session architecture for room-based multiplayer ([2856f4b](https://github.com/antialias/soroban-abacus-flashcards/commit/2856f4b83fbcc6483d96cc6e7da2fe5bc911625d))
+
+## [2.10.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.10.1...v2.10.2) (2025-10-09)
+
+
+### Bug Fixes
+
+* convert guestId to internal userId for player ownership check ([3a01f46](https://github.com/antialias/soroban-abacus-flashcards/commit/3a01f4637d2081c66fe37c7f8cfee229442ec744))
+* implement shared session architecture for room-based multiplayer ([2856f4b](https://github.com/antialias/soroban-abacus-flashcards/commit/2856f4b83fbcc6483d96cc6e7da2fe5bc911625d))
+
+## [2.10.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.10.0...v2.10.1) (2025-10-09)
+
+
+### Bug Fixes
+
+* enforce player ownership authorization for multiplayer games ([71b0aac](https://github.com/antialias/soroban-abacus-flashcards/commit/71b0aac13c970c03fe8d296d41e9472ad72a00fa))
+
+## [2.10.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.9.0...v2.10.0) (2025-10-09)
+
+
+### Features
+
+* implement rich Radix UI tooltips for player avatars ([d03c789](https://github.com/antialias/soroban-abacus-flashcards/commit/d03c7898799b378f912f47d7267a00bc7ce3d580))
+
+## [2.9.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.7...v2.9.0) (2025-10-09)
+
+
+### Features
+
+* implement auto-save for player settings modal ([a83dc09](https://github.com/antialias/soroban-abacus-flashcards/commit/a83dc097e43c265a297281da54754f58ac831754))
+
+## [2.8.7](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.6...v2.8.7) (2025-10-09)
+
+
+### Bug Fixes
+
+* enable real-time player name updates across room members ([5171be3](https://github.com/antialias/soroban-abacus-flashcards/commit/5171be3d37980eb1c98aa0d1e1d6e06f589763d1))
+
+## [2.8.6](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.5...v2.8.6) (2025-10-09)
+
+
+### Bug Fixes
+
+* prevent duplicate display of network avatars in nav ([d474ef0](https://github.com/antialias/soroban-abacus-flashcards/commit/d474ef07d69cf0b4f5dedd404616e3bbee7289fe))
+
+## [2.8.5](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.4...v2.8.5) (2025-10-09)
+
+
+### Bug Fixes
+
+* remove redirect loop by not redirecting from room page ([10cf715](https://github.com/antialias/soroban-abacus-flashcards/commit/10cf71527f7cede7fd93e502dbfc59df99b5a524))
+
+## [2.8.4](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.3...v2.8.4) (2025-10-09)
+
+
+### Bug Fixes
+
+* prevent redirect loops by checking if already at target URL ([c5268b7](https://github.com/antialias/soroban-abacus-flashcards/commit/c5268b79dee66aa02e14e2024fe1c6242a172ed3))
+
+## [2.8.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.2...v2.8.3) (2025-10-08)
+
+
+### Bug Fixes
+
+* remove ArcadeGuardedPage from room page to prevent redirect loop ([4686f59](https://github.com/antialias/soroban-abacus-flashcards/commit/4686f59d245b2b502dc0764c223a5ce84bf1af44))
+
+## [2.8.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.1...v2.8.2) (2025-10-08)
+
+
+### Bug Fixes
+
+* revert to showing only active players in room games ([87cc0b6](https://github.com/antialias/soroban-abacus-flashcards/commit/87cc0b64fb5f3debaf1d2f122aecfefc62922fed))
+
+## [2.8.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.8.0...v2.8.1) (2025-10-08)
+
+
+### Bug Fixes
+
+* include all players from room members in room games ([28a2e7d](https://github.com/antialias/soroban-abacus-flashcards/commit/28a2e7d6511e70b83adf7d0465789a91026bc1f7))
+
+## [2.8.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.7.4...v2.8.0) (2025-10-08)
+
+
+### Features
+
+* implement room-wide multi-user game state synchronization ([8175c43](https://github.com/antialias/soroban-abacus-flashcards/commit/8175c43533c474fff48eb128c97747033bfb434a))
+
+
+### Tests
+
+* add comprehensive tests for arcade guard and room navigation ([b49630f](https://github.com/antialias/soroban-abacus-flashcards/commit/b49630f3cb02ebbac75b4680948bbface314dccb))
+
+## [2.7.4](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.7.3...v2.7.4) (2025-10-08)
+
+
+### Bug Fixes
+
+* respect enabled flag in useArcadeGuard WebSocket redirects ([01ff114](https://github.com/antialias/soroban-abacus-flashcards/commit/01ff114258ff7ab43ef2bd79b41c7035fe02ac70))
+
+
+### Code Refactoring
+
+* move room management pages to /arcade-rooms ([4316687](https://github.com/antialias/soroban-abacus-flashcards/commit/431668729cfb145d6e0c13947de2a82f27fa400d))
+
+## [2.7.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.7.2...v2.7.3) (2025-10-08)
+
+
+### Bug Fixes
+
+* set room sessions to use /arcade/room URL ([9dac431](https://github.com/antialias/soroban-abacus-flashcards/commit/9dac431c1f91c246f67a059cda3cff6cbef40a43))
+
+## [2.7.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.7.1...v2.7.2) (2025-10-08)
+
+
+### Bug Fixes
+
+* add hasAttemptedFetch flag to prevent premature redirect ([c30f585](https://github.com/antialias/soroban-abacus-flashcards/commit/c30f58581028878350282cad5231d614590d9f2b))
+
+## [2.7.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.7.0...v2.7.1) (2025-10-08)
+
+
+### Bug Fixes
+
+* resolve race condition in /arcade/room redirect ([5ed2ab2](https://github.com/antialias/soroban-abacus-flashcards/commit/5ed2ab21cab408147081a493c8dd6b1de48b2d01))
+
+## [2.7.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.6.0...v2.7.0) (2025-10-08)
+
+
+### Features
+
+* extend GameModeContext to support room-based multiplayer ([ee6094d](https://github.com/antialias/soroban-abacus-flashcards/commit/ee6094d59d26a9e80ba5d023ca6dc13143bea308))
+
+## [2.6.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.5.0...v2.6.0) (2025-10-08)
+
+
+### Features
+
+* refactor room addressing to /arcade/room ([e7d2a73](https://github.com/antialias/soroban-abacus-flashcards/commit/e7d2a73ddf2048691325a18e3d71a7ece444c131))
+
+## [2.5.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.4.6...v2.5.0) (2025-10-08)
+
+
+### Features
+
+* display room info and network players in mini app nav ([5e3261f](https://github.com/antialias/soroban-abacus-flashcards/commit/5e3261f3bec8c19ec88c9a35a7e6ef8eda88a55e))
+
+## [2.4.6](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.4.5...v2.4.6) (2025-10-08)
+
+
+### Bug Fixes
+
+* real-time room member updates via globalThis socket.io sharing ([94a1d9b](https://github.com/antialias/soroban-abacus-flashcards/commit/94a1d9b11058bfb4b54a4753e143cf85f215e913))
+
+## [2.4.5](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.4.4...v2.4.5) (2025-10-08)
+
+
+### Bug Fixes
+
+* send all members (not just online) in socket broadcasts ([3fa6cce](https://github.com/antialias/soroban-abacus-flashcards/commit/3fa6cce17a7acd940cf5a9e6433bf6c4b497540c))
+
+## [2.4.4](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.4.3...v2.4.4) (2025-10-08)
+
+
+### Bug Fixes
+
+* correctly access getSocketIO from dynamic import ([30abf33](https://github.com/antialias/soroban-abacus-flashcards/commit/30abf33ee86b36f2a98014e5b017fa8e466a2107))
+
+## [2.4.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.4.2...v2.4.3) (2025-10-08)
+
+
+### Bug Fixes
+
+* resolve socket-server import path for Next.js build ([12c3c37](https://github.com/antialias/soroban-abacus-flashcards/commit/12c3c37ff8e1d3df71d72e527c08fa975043c504))
+
+## [2.4.2](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.4.1...v2.4.2) (2025-10-08)
+
+
+### Bug Fixes
+
+* broadcast member join/leave events immediately via API ([ebfc88c](https://github.com/antialias/soroban-abacus-flashcards/commit/ebfc88c5ea0a8a0fdda039fa129e1054b9c42e65))
+
+## [2.4.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.4.0...v2.4.1) (2025-10-08)
+
+
+### Bug Fixes
+
+* make leave room button actually remove user from room ([49f12f8](https://github.com/antialias/soroban-abacus-flashcards/commit/49f12f8cab631fedd33f1bc09febfdc95e444625))
+
+## [2.4.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.3.1...v2.4.0) (2025-10-08)
+
+
+### Features
+
+* add arcade room/session info and network players to nav ([6800747](https://github.com/antialias/soroban-abacus-flashcards/commit/6800747f80a29c91ba0311a8330d594c1074097d))
+* add real-time WebSocket updates for room membership ([7ebb2be](https://github.com/antialias/soroban-abacus-flashcards/commit/7ebb2be3927762a5fe9b6fb7fb15d6b88abb7b6a))
+* implement modal room enforcement (one room per user) ([f005fbb](https://github.com/antialias/soroban-abacus-flashcards/commit/f005fbbb773f4d250b80d71593490976af82d5a5))
+* improve room navigation and membership UI ([bc219c2](https://github.com/antialias/soroban-abacus-flashcards/commit/bc219c2ad66707f03e7a6cf587b9d190c736e26d))
+
+
+### Bug Fixes
+
+* auto-cleanup orphaned arcade sessions without valid rooms ([3c002ab](https://github.com/antialias/soroban-abacus-flashcards/commit/3c002ab29d1b72a0e1ffb70bb0744dc560e7bdc2))
+* show correct join/leave button based on room membership ([5751dfe](https://github.com/antialias/soroban-abacus-flashcards/commit/5751dfef5c81981937cd5300c4256e5b74bb7488))
+
+## [2.3.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.3.0...v2.3.1) (2025-10-07)
+
+
+### Bug Fixes
+
+* add missing DOMPoint properties to getPointAtLength mock ([1e17278](https://github.com/antialias/soroban-abacus-flashcards/commit/1e17278f942b3fbcc5d05be746178f2e780f0bd9))
+* add missing name property to Passenger test mocks ([f8ca248](https://github.com/antialias/soroban-abacus-flashcards/commit/f8ca2488447e89151085942f708f6acf350a2747))
+* add non-null assertions to skillConfiguration utilities ([9c71092](https://github.com/antialias/soroban-abacus-flashcards/commit/9c7109227822884d25f8546739c80c6e7491e28d))
+* add optional chaining to stepBeadHighlights access ([a5fac5c](https://github.com/antialias/soroban-abacus-flashcards/commit/a5fac5c75c8cd67b218a5fd5ad98818dad74ab67))
+* add showAsAbacus property to ComplementQuestion type ([4adcc09](https://github.com/antialias/soroban-abacus-flashcards/commit/4adcc096430fbb03f0a8b2f0aef4be239aff9cd0))
+* add userId to optimistic player in useCreatePlayer ([5310463](https://github.com/antialias/soroban-abacus-flashcards/commit/5310463becd0974291cff49522ae5669a575410d))
+* change TypeScript moduleResolution from bundler to node ([327aee0](https://github.com/antialias/soroban-abacus-flashcards/commit/327aee0b4b5c0b0b2bf3eeb48d861bb3068f6127))
+* convert Jest mocks to Vitest in useSteamJourney tests ([e067271](https://github.com/antialias/soroban-abacus-flashcards/commit/e06727160c70a1ab38a003104d1fef8fb83ff92d))
+* convert player IDs from number to string in arcade tests ([72db1f4](https://github.com/antialias/soroban-abacus-flashcards/commit/72db1f4a2c3f930025cd5ced3fcf7c810dcc569d))
+* rewrite layout.nav.test to match actual RootLayout props ([a085de8](https://github.com/antialias/soroban-abacus-flashcards/commit/a085de816fcdeb055addabb8aec391b111cb5f94))
+* update useArcadeGuard tests with proper useViewerId mock ([4eb49d1](https://github.com/antialias/soroban-abacus-flashcards/commit/4eb49d1d44e1d85526ef6564f88a8fbcebffb4d2))
+* use Object.defineProperty for NODE_ENV in middleware tests ([e73191a](https://github.com/antialias/soroban-abacus-flashcards/commit/e73191a7298dbb6dd15da594267ea6221062c36b))
+* wrap Buffer in Uint8Array for Next.js Response API ([98384d2](https://github.com/antialias/soroban-abacus-flashcards/commit/98384d264e4a10d1836aa9f2e69151b122ffa7b0))
+
+
+### Documentation
+
+* add explicit package.json script references to regime docs ([3353bca](https://github.com/antialias/soroban-abacus-flashcards/commit/3353bcadc2849104248c624973274ed90b86722a))
+* establish mandatory code quality regime for Claude Code ([dd11043](https://github.com/antialias/soroban-abacus-flashcards/commit/dd1104310f4e0e85640730ea0e96e4adda4bc505))
+* expand quality regime to define "done" for all work ([f92f7b5](https://github.com/antialias/soroban-abacus-flashcards/commit/f92f7b592af38ba9d0f5b1db3a061d63d92a5093))
+
+## [2.3.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.2.1...v2.3.0) (2025-10-07)
+
+
+### Features
+
+* add Biome + ESLint linting setup ([fc1838f](https://github.com/antialias/soroban-abacus-flashcards/commit/fc1838f4f53a4f8d8f1c5303de3a63f12d9c9303))
+
+
+### Styles
+
+* apply Biome formatting to entire codebase ([60d70cd](https://github.com/antialias/soroban-abacus-flashcards/commit/60d70cd2f2f2b1d250c4c645889af4334968cb7e))
+
+## [2.2.1](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.2.0...v2.2.1) (2025-10-07)
+
+
+### Bug Fixes
+
+* remove remaining typst-dependent files ([d1b9b72](https://github.com/antialias/soroban-abacus-flashcards/commit/d1b9b72cfc2f2ba36c40d7ae54bc6fdfcc5f34da))
+
+## [2.2.0](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.1.3...v2.2.0) (2025-10-07)
+
+
+### Features
+
+* remove typst-related code and routes ([be6fb1a](https://github.com/antialias/soroban-abacus-flashcards/commit/be6fb1a881b983f9830d36c079b7b41f35153b8a))
+
 ## [2.1.3](https://github.com/antialias/soroban-abacus-flashcards/compare/v2.1.2...v2.1.3) (2025-10-07)


--- a/32
+++ b/32
@@ -34,20 +34,44 @@ RUN turbo build --filter=@soroban/web
 FROM node:18-alpine AS runner
 WORKDIR /app

+# Install Python and build tools for better-sqlite3 (needed at runtime)
+RUN apk add --no-cache python3 py3-setuptools make g++
+
 # Create non-root user
 RUN addgroup --system --gid 1001 nodejs
 RUN adduser --system --uid 1001 nextjs

-# Copy built application
-COPY --from=builder --chown=nextjs:nodejs /app/apps/web/.next/standalone ./
-COPY --from=builder --chown=nextjs:nodejs /app/apps/web/.next/static ./apps/web/.next/static
+# Copy built Next.js application
+COPY --from=builder --chown=nextjs:nodejs /app/apps/web/.next ./apps/web/.next
 COPY --from=builder --chown=nextjs:nodejs /app/apps/web/public ./apps/web/public

+# Copy server files (compiled from TypeScript)
+COPY --from=builder --chown=nextjs:nodejs /app/apps/web/server.js ./apps/web/
+COPY --from=builder --chown=nextjs:nodejs /app/apps/web/socket-server.js ./apps/web/
+COPY --from=builder --chown=nextjs:nodejs /app/apps/web/src ./apps/web/src
+
+# Copy database migrations
+COPY --from=builder --chown=nextjs:nodejs /app/apps/web/drizzle ./apps/web/drizzle
+
+# Copy node_modules (for dependencies)
+COPY --from=builder --chown=nextjs:nodejs /app/node_modules ./node_modules
+COPY --from=builder --chown=nextjs:nodejs /app/apps/web/node_modules ./apps/web/node_modules
+
+# Copy package.json files for module resolution
+COPY --from=builder --chown=nextjs:nodejs /app/package.json ./
+COPY --from=builder --chown=nextjs:nodejs /app/apps/web/package.json ./apps/web/
+
 # Set up environment
+WORKDIR /app/apps/web
+
+# Create data directory for SQLite database
+RUN mkdir -p data && chown nextjs:nodejs data
+
 USER nextjs
 EXPOSE 3000
 ENV PORT 3000
 ENV HOSTNAME "0.0.0.0"
+ENV NODE_ENV production

 # Start the application
-CMD ["node", "apps/web/server.js"]
+CMD ["node", "server.js"]
--- a/apps/web/.claude/ARCADE_ARCHITECTURE.md
+++ b/apps/web/.claude/ARCADE_ARCHITECTURE.md
@@ -0,0 +1,492 @@
+# Arcade Game Architecture
+
+## Overview
+
+The arcade system supports two distinct game modes that must remain completely isolated from each other:
+
+1. **Local Play** - Games without network synchronization (can be single-player OR local multiplayer)
+2. **Room-Based Play** - Networked games with real-time synchronization across room members
+
+## Core Terminology
+
+Following `docs/terminology-user-player-room.md`:
+
+- **USER** - Identity (guest or authenticated account), retrieved via `useViewerId()`, one per browser/account
+- **PLAYER** - Game avatar/profile (e.g., "Alice 👧", "Bob 👦"), stored in `players` table
+- **PLAYER ROSTER** - All PLAYERS belonging to a USER (can have many)
+- **ACTIVE PLAYERS** - PLAYERS where `isActive = true` - these are the ones that actually participate in games
+- **ROOM MEMBER** - A USER's participation in a multiplayer room (tracked in `room_members` table)
+
+**Important:** A USER can have many PLAYERS in their roster, but only the ACTIVE PLAYERS (where `isActive = true`) participate in games. This enables "hot-potato" style local multiplayer where multiple people share the same device. This is LOCAL play (not networked), even though multiple PLAYERS participate.
+
+In arcade sessions:
+- `arcade_sessions.userId` - The USER who owns the session
+- `arcade_sessions.activePlayers` - Array of PLAYER IDs (only active players with `isActive = true`)
+- `arcade_sessions.roomId` - If present, the room ID for networked play (references `arcade_rooms.id`)
+
+## Critical Architectural Requirements
+
+### 1. Mode Isolation (MUST ENFORCE)
+
+**Local Play** (`/arcade/[game-name]`)
+- MUST NOT sync game state across the network
+- MUST NOT use room data, even if the USER is currently a member of an active room
+- MUST create isolated, per-USER game sessions
+- Game state lives only in the current browser tab/session
+- CAN have multiple ACTIVE PLAYERS from the same USER (local multiplayer / hot-potato)
+- State is NOT shared across the network, only within the browser session
+
+**Room-Based Play** (`/arcade/room`)
+- MUST sync game state across all room members via network
+- MUST use the USER's current active room
+- MUST coordinate moves via server WebSocket
+- Game state is shared across all ACTIVE PLAYERS from all USERS in the room
+- When a PLAYER makes a move, all room members see it in real-time
+- CAN ALSO have multiple ACTIVE PLAYERS per USER (networked + local multiplayer combined)
+
+### 2. Room ID Usage Rules
+
+```typescript
+// ❌ WRONG: Always checking for room data
+const { roomData } = useRoomData()
+useArcadeSession({ roomId: roomData?.id })  // This causes the bug!
+
+// ✅ CORRECT: Explicit mode control via separate providers
+<LocalMemoryPairsProvider>     {/* Never passes roomId */}
+<RoomMemoryPairsProvider>       {/* Always passes roomId */}
+```
+
+**Key principle:** The presence of a `roomId` parameter in `useArcadeSession` determines synchronization behavior:
+- `roomId` present → room-wide network sync enabled (room-based play)
+- `roomId` undefined → local play only (no network sync)
+
+### 3. Composition Over Flags (PREFERRED APPROACH)
+
+**✅ Option 1: Separate Providers (CLEAREST - USE THIS)**
+
+Create two distinct provider components:
+
+```typescript
+// context/LocalMemoryPairsProvider.tsx
+export function LocalMemoryPairsProvider({ children }) {
+  const { data: viewerId } = useViewerId()
+  const { activePlayers } = useGameMode()  // Gets active players (isActive = true)
+  // NEVER fetch room data for local play
+
+  const { state, sendMove } = useArcadeSession<MemoryPairsState>({
+    userId: viewerId || '',
+    roomId: undefined,  // Explicitly undefined - no network sync
+    initialState,
+    applyMove: applyMoveOptimistically,
+  })
+
+  // ... rest of provider logic
+  // Note: activePlayers contains only PLAYERS with isActive = true
+}
+
+// context/RoomMemoryPairsProvider.tsx
+export function RoomMemoryPairsProvider({ children }) {
+  const { data: viewerId } = useViewerId()
+  const { roomData } = useRoomData()  // OK to fetch for room-based play
+  const { activePlayers } = useGameMode()  // Gets active players (isActive = true)
+
+  const { state, sendMove } = useArcadeSession<MemoryPairsState>({
+    userId: viewerId || '',
+    roomId: roomData?.id,  // Pass roomId for network sync
+    initialState,
+    applyMove: applyMoveOptimistically,
+  })
+
+  // ... rest of provider logic
+}
+```
+
+Then use them explicitly:
+```typescript
+// /arcade/matching/page.tsx (Local Play)
+export default function MatchingPage() {
+  return (
+    <ArcadeGuardedPage>
+      <LocalMemoryPairsProvider>
+        <MemoryPairsGame />
+      </LocalMemoryPairsProvider>
+    </ArcadeGuardedPage>
+  )
+}
+
+// /arcade/room/page.tsx (Room-Based Play)
+export default function RoomPage() {
+  // ... room validation logic
+  if (roomData.gameName === 'matching') {
+    return (
+      <RoomMemoryPairsProvider>
+        <MemoryPairsGame />
+      </RoomMemoryPairsProvider>
+    )
+  }
+}
+```
+
+**Benefits of separate providers:**
+- Compile-time safety - impossible to mix modes
+- Clear intent - any developer can see which mode at a glance
+- No runtime conditionals needed
+- Easier to test - each provider tests separately
+
+**❌ Avoid:** Runtime flag checking scattered throughout code
+```typescript
+// Anti-pattern: Too many conditionals
+if (isRoomBased) { ... } else { ... }
+```
+
+### 4. How Synchronization Works
+
+#### Local Play Flow
+```
+USER Action → useArcadeSession (roomId: undefined)
+           → WebSocket emit('join-arcade-session', { userId })
+           → Server creates isolated session for userId
+           → Session key = userId
+           → session.activePlayers = USER's active player IDs (isActive = true)
+           → State changes only affect this USER's browser tabs
+
+Note: Multiple ACTIVE PLAYERS from same USER can participate (local multiplayer),
+      but state is NEVER synced across network
+```
+
+#### Room-Based Play Flow
+```
+USER Action (on behalf of PLAYER)
+         → useArcadeSession (roomId: 'room_xyz')
+         → WebSocket emit('join-arcade-session', { userId, roomId })
+         → Server creates/joins shared session for roomId
+         → session.activePlayers = ALL active players from ALL room members
+         → Socket joins TWO rooms: `arcade:${userId}` AND `game:${roomId}`
+         → PLAYER makes move
+         → Server validates PLAYER ownership (is this PLAYER owned by this USER?)
+         → State changes broadcast to:
+            - arcade:${userId} - All tabs of this USER (for optimistic reconciliation)
+            - game:${roomId} - All USERS in the room (for network sync)
+
+Note: Each USER can still have multiple ACTIVE PLAYERS (local + networked multiplayer)
+```
+
+The server-side logic uses `roomId` to determine session scope:
+- No `roomId`: Session key = `userId` (isolated to USER's browser)
+- With `roomId`: Session key = `roomId` (shared across all room members)
+
+See `docs/MULTIPLAYER_SYNC_ARCHITECTURE.md` for detailed socket room mechanics.
+
+### 5. USER vs PLAYER in Game Logic
+
+**Important distinction:**
+- **Session ownership**: Tracked by USER ID (`useViewerId()`)
+- **Player roster**: All PLAYERS for a USER (can be many)
+- **Active players**: PLAYERS with `isActive = true` (these join the game)
+- **Game actions**: Performed by PLAYER ID (from `players` table)
+- **Move validation**: Server checks that PLAYER ID belongs to the requesting USER
+- **Local multiplayer**: One USER with multiple ACTIVE PLAYERS (hot-potato style, same device)
+- **Networked multiplayer**: Multiple USERS, each with their own ACTIVE PLAYERS, in a room
+
+```typescript
+// ✅ Correct: USER owns session, ACTIVE PLAYERS participate
+const { data: viewerId } = useViewerId()  // USER ID
+const { activePlayers } = useGameMode()   // ACTIVE PLAYER IDs (isActive = true)
+
+// activePlayers might be [player_001, player_002]
+// even though USER has 5 total PLAYERS in their roster
+
+const { state, sendMove } = useArcadeSession({
+  userId: viewerId,  // Session owned by USER
+  roomId: undefined, // Local play (or roomData?.id for room-based)
+  // ...
+})
+
+// When PLAYER flips card:
+sendMove({
+  type: 'FLIP_CARD',
+  playerId: currentPlayerId,  // PLAYER ID from activePlayers
+  data: { cardId: '...' }
+})
+```
+
+**Example Scenarios:**
+
+1. **Single-player local game:**
+   - USER: "guest_abc"
+   - Player roster: ["player_001" (active), "player_002" (inactive), "player_003" (inactive)]
+   - Active PLAYERS in game: ["player_001"]
+   - Mode: Local play (no roomId)
+
+2. **Local multiplayer (hot-potato):**
+   - USER: "guest_abc"
+   - Player roster: ["player_001" (active), "player_002" (active), "player_003" (active), "player_004" (inactive)]
+   - Active PLAYERS in game: ["player_001", "player_002", "player_003"] (3 kids sharing device)
+   - Mode: Local play (no roomId)
+   - Game rotates turns between the 3 active PLAYERS, but NO network sync
+
+3. **Room-based networked play:**
+   - USER A: "guest_abc"
+     - Player roster: 5 total PLAYERS
+     - Active PLAYERS: ["player_001", "player_002"]
+   - USER B: "guest_def"
+     - Player roster: 3 total PLAYERS
+     - Active PLAYERS: ["player_003"]
+   - Mode: Room-based play (roomId: "room_xyz")
+   - Total PLAYERS in game: 3 (player_001, player_002, player_003)
+   - All 3 synced across network
+
+4. **Room-based + local multiplayer combined:**
+   - USER A: "guest_abc" with 3 active PLAYERS (3 kids at Device A)
+   - USER B: "guest_def" with 2 active PLAYERS (2 kids at Device B)
+   - Mode: Room-based play (roomId: "room_xyz")
+   - 5 total active PLAYERS across 2 devices, all synced over network
+
+## Common Mistakes to Avoid
+
+### Mistake 1: Conditional Room Usage
+```typescript
+// ❌ BAD: Room sync leaks into local play
+const { roomData } = useRoomData()
+useArcadeSession({
+  roomId: roomData?.id  // Local play will sync if USER is in a room!
+})
+```
+
+### Mistake 2: Shared Components Without Mode Context
+```typescript
+// ❌ BAD: Same provider used for both modes
+export default function LocalGamePage() {
+  return <GameProvider><Game /></GameProvider>  // Which mode?
+}
+```
+
+### Mistake 3: Confusing "multiplayer" with "networked"
+```typescript
+// ❌ BAD: Thinking multiple PLAYERS means room-based
+if (activePlayers.length > 1) {
+  // Must be room-based!  WRONG!
+  // Could be local multiplayer (hot-potato style)
+}
+
+// ✅ CORRECT: Check for roomId to determine network sync
+const isNetworked = !!roomId
+const isLocalMultiplayer = activePlayers.length > 1 && !roomId
+```
+
+### Mistake 4: Using all PLAYERS instead of only active ones
+```typescript
+// ❌ BAD: Including inactive players
+const allPlayers = await db.query.players.findMany({
+  where: eq(players.userId, userId)
+})
+
+// ✅ CORRECT: Only active players join the game
+const activePlayers = await db.query.players.findMany({
+  where: and(
+    eq(players.userId, userId),
+    eq(players.isActive, true)
+  )
+})
+```
+
+### Mistake 5: Mixing USER ID and PLAYER ID
+```typescript
+// ❌ BAD: Using USER ID for game actions
+sendMove({
+  type: 'FLIP_CARD',
+  playerId: viewerId,  // WRONG! viewerId is USER ID, not PLAYER ID
+  data: { cardId: '...' }
+})
+
+// ✅ CORRECT: Use PLAYER ID from game state
+sendMove({
+  type: 'FLIP_CARD',
+  playerId: state.currentPlayer,  // PLAYER ID from activePlayers
+  data: { cardId: '...' }
+})
+```
+
+### Mistake 6: Server-Side Ambiguity
+```typescript
+// ❌ BAD: Server can't distinguish intent
+socket.on('join-arcade-session', ({ userId, roomId }) => {
+  // If roomId exists, did USER want local or room-based play?
+  // This happens when provider always passes roomData?.id
+})
+```
+
+## Testing Requirements
+
+Tests MUST verify mode isolation:
+
+### Local Play Tests
+```typescript
+it('should NOT sync state when USER is in a room but playing locally', async () => {
+  // Setup: USER is a member of an active room
+  // Action: USER navigates to /arcade/matching
+  // Assert: Game state is NOT shared with other room members
+  // Assert: Other room members' actions do NOT affect this game
+})
+
+it('should create isolated sessions for concurrent local games', () => {
+  // Setup: Two USERS who are members of the same room
+  // Action: Both navigate to /arcade/matching separately
+  // Assert: Each has independent game state
+  // Assert: USER A's moves do NOT appear in USER B's game
+})
+
+it('should support local multiplayer without network sync', () => {
+  // Setup: USER with 3 active PLAYERS in roster (hot-potato style)
+  // Action: USER plays at /arcade/matching with the 3 active PLAYERS
+  // Assert: All 3 active PLAYERS participate in the same session
+  // Assert: Inactive PLAYERS do NOT participate
+  // Assert: State is NOT synced across network
+  // Assert: Game rotates turns between active PLAYERS locally
+})
+
+it('should only include active players in game', () => {
+  // Setup: USER has 5 PLAYERS in roster, but only 2 are active
+  // Action: USER starts a local game
+  // Assert: Only the 2 active PLAYERS are in activePlayers array
+  // Assert: Inactive PLAYERS are not included
+})
+
+it('should sync across USER tabs but not across network', () => {
+  // Setup: USER opens /arcade/matching in 2 browser tabs
+  // Action: PLAYER makes move in Tab 1
+  // Assert: Tab 2 sees the move (multi-tab sync)
+  // Assert: Other USERS do NOT see the move (no network sync)
+})
+```
+
+### Room-Based Play Tests
+```typescript
+it('should sync state across all room members', async () => {
+  // Setup: Two USERS are members of the same room
+  // Action: USER A's PLAYER flips card at /arcade/room
+  // Assert: USER B sees the card flip in real-time
+})
+
+it('should sync across multiple active PLAYERS from multiple USERS', () => {
+  // Setup: USER A has 2 active PLAYERS, USER B has 1 active PLAYER in same room
+  // Action: USER A's PLAYER 1 makes move
+  // Assert: All 3 PLAYERS see the move (networked)
+})
+
+it('should only include active players in room games', () => {
+  // Setup: USER A (5 PLAYERS, 2 active), USER B (3 PLAYERS, 1 active) join room
+  // Action: Game starts
+  // Assert: session.activePlayers = [userA_player1, userA_player2, userB_player1]
+  // Assert: Inactive PLAYERS are NOT included
+})
+
+it('should handle combined local + networked multiplayer', () => {
+  // Setup: USER A (3 active PLAYERS), USER B (2 active PLAYERS) in same room
+  // Action: Any PLAYER makes a move
+  // Assert: All 5 active PLAYERS see the move across both devices
+})
+
+it('should fail gracefully when no room exists', () => {
+  // Setup: USER is not a member of any room
+  // Action: Navigate to /arcade/room
+  // Assert: Shows "No active room" message
+  // Assert: Does not create a session
+})
+
+it('should validate PLAYER ownership', async () => {
+  // Setup: USER A in room with active PLAYER 'alice'
+  // Action: USER A attempts move for PLAYER 'bob' (owned by USER B)
+  // Assert: Server rejects the move
+  // Assert: Error indicates unauthorized PLAYER
+})
+```
+
+## Implementation Checklist
+
+When adding a new game or modifying existing ones:
+
+- [ ] Create separate `LocalGameProvider` and `RoomGameProvider` components
+- [ ] Local provider never calls `useRoomData()`
+- [ ] Local provider passes `roomId: undefined` to `useArcadeSession`
+- [ ] Room provider calls `useRoomData()` and passes `roomId: roomData?.id`
+- [ ] Both providers use `useGameMode()` to get active players
+- [ ] Local play page uses `LocalGameProvider`
+- [ ] `/arcade/room` page uses `RoomGameProvider`
+- [ ] Game components correctly use PLAYER IDs (not USER IDs) for moves
+- [ ] Game supports multiple active PLAYERS from same USER (local multiplayer)
+- [ ] Inactive PLAYERS are never included in game sessions
+- [ ] Tests verify mode isolation (local doesn't network sync, room-based does)
+- [ ] Tests verify PLAYER ownership validation
+- [ ] Tests verify only active PLAYERS participate
+- [ ] Tests verify local multiplayer works (multiple active PLAYERS, one USER)
+- [ ] Documentation updated if behavior changes
+
+## File Organization
+
+```
+src/app/arcade/
+├── [game-name]/                    # Local play games
+│   ├── page.tsx                   # Uses LocalGameProvider
+│   └── context/
+│       ├── LocalGameProvider.tsx  # roomId: undefined
+│       └── RoomGameProvider.tsx   # roomId: roomData?.id
+├── room/                           # Room-based play
+│   └── page.tsx                   # Uses RoomGameProvider
+└── ...
+```
+
+## Architecture Decision Records
+
+### Why separate providers instead of auto-detect from route?
+
+While we could detect mode based on the route (`/arcade/room` vs `/arcade/matching`), separate providers are clearer and prevent accidental misuse. Future developers can immediately see the intent, and the type system can enforce correctness.
+
+### Why being in a room doesn't mean all games sync?
+
+A USER being a room member does NOT mean all their games should network sync. They should be able to play local games while remaining in a room for future room-based sessions. Mode is determined by the page they're on, not their room membership status.
+
+### Why not use a single shared provider with mode props?
+
+We tried that. It led to the current bug where local play accidentally synced with rooms. Separate providers make the distinction compile-time safe rather than runtime conditional, and eliminate the possibility of accidentally passing `roomId` when we shouldn't.
+
+### Why do we track sessions by USER but moves by PLAYER?
+
+- **Sessions** are per-USER because each USER can have their own game session
+- **Moves** are per-PLAYER because PLAYERS are the game avatars that score points
+- **Only active PLAYERS** (isActive = true) participate in games
+- This allows:
+  - One USER with multiple active PLAYERS (local multiplayer / hot-potato)
+  - Multiple USERS in one room (networked play)
+  - Combined: Multiple USERS each with multiple active PLAYERS (local + networked)
+  - Proper ownership validation (server checks USER owns PLAYER)
+  - PLAYERS can be toggled active/inactive without deleting them
+
+### Why use "local" vs "room-based" instead of "solo" vs "multiplayer"?
+
+- **"Solo"** is misleading - a USER can have multiple active PLAYERS in local play (hot-potato style)
+- **"Multiplayer"** is ambiguous - it could mean local multiplayer OR networked multiplayer
+- **"Local play"** clearly means: no network sync (but can have multiple active PLAYERS)
+- **"Room-based play"** clearly means: network sync across room members
+
+## Related Files
+
+- `src/hooks/useArcadeSession.ts` - Session management with optional roomId
+- `src/hooks/useArcadeSocket.ts` - WebSocket connection with sync logic (socket rooms: `arcade:${userId}` and `game:${roomId}`)
+- `src/hooks/useRoomData.ts` - Fetches USER's current room membership
+- `src/hooks/useViewerId.ts` - Retrieves current USER ID
+- `src/contexts/GameModeContext.tsx` - Provides active PLAYER information
+- `src/app/arcade/matching/context/ArcadeMemoryPairsContext.tsx` - Game context (needs refactoring to separate providers)
+- `src/app/arcade/matching/page.tsx` - Local play entry point
+- `src/app/arcade/room/page.tsx` - Room-based play entry point
+- `docs/terminology-user-player-room.md` - Terminology guide (USER/PLAYER/MEMBER)
+- `docs/MULTIPLAYER_SYNC_ARCHITECTURE.md` - Technical details of room-based sync
+
+## Version History
+
+- **2025-10-09**: Initial documentation
+  - Issue identified: Local play was syncing with rooms over network
+  - Root cause: Same provider always fetched `roomData` and passed `roomId` to `useArcadeSession`
+  - Solution: Separate providers for local vs room-based play
+  - Terminology clarification: "local" vs "room-based" (not "solo" vs "multiplayer")
+  - Active players: Only PLAYERS with `isActive = true` participate in games
--- a/apps/web/.claude/ARCADE_SETUP_PATTERN.md
+++ b/apps/web/.claude/ARCADE_SETUP_PATTERN.md
@@ -0,0 +1,416 @@
+# Arcade Setup Pattern
+
+## Overview
+
+This document describes the **standard synchronized setup pattern** for arcade games. Following this pattern ensures that:
+
+1. ✅ **Setup is synchronized** - All room members see the same setup screen and config changes in real-time
+2. ✅ **No local state hacks** - Configuration lives entirely in session state, no React state merging
+3. ✅ **Optimistic updates** - Config changes feel instant with client-side prediction
+4. ✅ **Consistent pattern** - All games follow the same architecture
+
+**Reference Implementation**: `src/app/arcade/matching/*` (Matching game)
+
+---
+
+## Core Concept
+
+Setup configuration is **game state**, not UI state. Configuration changes are **moves** that are validated, synchronized, and can be made by any room member.
+
+### Key Principles
+
+1. **Game state includes configuration** during ALL phases (setup, playing, results)
+2. **No local React state** for configuration - use session state directly
+3. **Standard move types** that all games should implement
+4. **Setup phase is collaborative** - any room member can configure the game
+
+---
+
+## Required Move Types
+
+Every arcade game must support these standard moves:
+
+### 1. `GO_TO_SETUP`
+
+Transitions game to setup phase, allowing reconfiguration.
+
+```typescript
+{
+  type: 'GO_TO_SETUP',
+  playerId: string,
+  data: {}
+}
+```
+
+**Behavior:**
+- Can be called from any phase (setup, playing, results)
+- Sets `gamePhase: 'setup'`
+- Resets game progression (scores, cards, etc.)
+- Preserves configuration (players can modify it)
+- Synchronized across all room members
+
+### 2. `SET_CONFIG`
+
+Updates a configuration field during setup phase.
+
+```typescript
+{
+  type: 'SET_CONFIG',
+  playerId: string,
+  data: {
+    field: string,  // Config field name
+    value: any      // New value
+  }
+}
+```
+
+**Behavior:**
+- Only allowed during setup phase
+- Validates field name and value
+- Updates immediately with optimistic update
+- Synchronized across all room members
+
+### 3. `START_GAME`
+
+Starts the game with current configuration.
+
+```typescript
+{
+  type: 'START_GAME',
+  playerId: string,
+  data: {
+    activePlayers: string[],
+    playerMetadata: { [playerId: string]: PlayerMetadata },
+    // ... game-specific initial data
+  }
+}
+```
+
+**Behavior:**
+- Only allowed during setup phase
+- Uses current session state configuration
+- Initializes game-specific state
+- Sets `gamePhase: 'playing'`
+
+---
+
+## Implementation Checklist
+
+### 1. Update Validation Types
+
+Add move types to your game's validation types:
+
+```typescript
+// src/lib/arcade/validation/types.ts
+
+export interface YourGameGoToSetupMove extends GameMove {
+  type: 'GO_TO_SETUP'
+  data: Record<string, never>
+}
+
+export interface YourGameSetConfigMove extends GameMove {
+  type: 'SET_CONFIG'
+  data: {
+    field: 'configField1' | 'configField2' | 'configField3'
+    value: any
+  }
+}
+
+export type YourGameMove =
+  | YourGameStartGameMove
+  | YourGameGoToSetupMove
+  | YourGameSetConfigMove
+  | ... // other game-specific moves
+```
+
+### 2. Implement Validators
+
+Add validators for setup moves in your game's validator class:
+
+```typescript
+// src/lib/arcade/validation/YourGameValidator.ts
+
+export class YourGameValidator implements GameValidator<YourGameState, YourGameMove> {
+  validateMove(state, move, context) {
+    switch (move.type) {
+      case 'GO_TO_SETUP':
+        return this.validateGoToSetup(state)
+
+      case 'SET_CONFIG':
+        return this.validateSetConfig(state, move.data.field, move.data.value)
+
+      case 'START_GAME':
+        return this.validateStartGame(state, move.data)
+
+      // ... other moves
+    }
+  }
+
+  private validateGoToSetup(state: YourGameState): ValidationResult {
+    return {
+      valid: true,
+      newState: {
+        ...state,
+        gamePhase: 'setup',
+        // Reset game progression, preserve configuration
+        // ... reset scores, game data, etc.
+      },
+    }
+  }
+
+  private validateSetConfig(
+    state: YourGameState,
+    field: string,
+    value: any
+  ): ValidationResult {
+    // Only during setup
+    if (state.gamePhase !== 'setup') {
+      return { valid: false, error: 'Cannot change config outside setup' }
+    }
+
+    // Validate field-specific values
+    switch (field) {
+      case 'configField1':
+        if (!isValidValue(value)) {
+          return { valid: false, error: 'Invalid value' }
+        }
+        break
+      // ... validate other fields
+    }
+
+    return {
+      valid: true,
+      newState: { ...state, [field]: value },
+    }
+  }
+
+  private validateStartGame(state: YourGameState, data: any): ValidationResult {
+    if (state.gamePhase !== 'setup') {
+      return { valid: false, error: 'Can only start from setup' }
+    }
+
+    // Use current state configuration to initialize game
+    const initialGameData = initializeYourGame(state.configField1, state.configField2)
+
+    return {
+      valid: true,
+      newState: {
+        ...state,
+        gamePhase: 'playing',
+        ...initialGameData,
+      },
+    }
+  }
+}
+```
+
+### 3. Add Optimistic Updates
+
+Update `applyMoveOptimistically` in your providers:
+
+```typescript
+// src/app/arcade/your-game/context/YourGameProvider.tsx
+
+function applyMoveOptimistically(state: YourGameState, move: GameMove): YourGameState {
+  switch (move.type) {
+    case 'GO_TO_SETUP':
+      return {
+        ...state,
+        gamePhase: 'setup',
+        // Reset game state, preserve config
+      }
+
+    case 'SET_CONFIG':
+      const { field, value } = move.data
+      return {
+        ...state,
+        [field]: value,
+      }
+
+    case 'START_GAME':
+      return {
+        ...state,
+        gamePhase: 'playing',
+        // ... initialize game data from move
+      }
+
+    // ... other moves
+  }
+}
+```
+
+### 4. Remove Local State from Providers
+
+**❌ OLD PATTERN (Don't do this):**
+
+```typescript
+// DON'T: Local React state for configuration
+const [localDifficulty, setLocalDifficulty] = useState(6)
+
+// DON'T: Merge hack
+const effectiveState = state.gamePhase === 'setup'
+  ? { ...state, difficulty: localDifficulty }
+  : state
+
+// DON'T: Direct setter
+const setDifficulty = (value) => setLocalDifficulty(value)
+```
+
+**✅ NEW PATTERN (Do this):**
+
+```typescript
+// DO: Use session state directly
+const { state, sendMove } = useArcadeSession(...)
+
+// DO: Send move for config changes
+const setDifficulty = useCallback((value) => {
+  const playerId = activePlayers[0] || ''
+  sendMove({
+    type: 'SET_CONFIG',
+    playerId,
+    data: { field: 'difficulty', value },
+  })
+}, [activePlayers, sendMove])
+
+// DO: Use state directly (no merging!)
+const contextValue = { state: { ...state, gameMode }, ... }
+```
+
+### 5. Update Action Creators
+
+All configuration actions should send moves:
+
+```typescript
+export function YourGameProvider({ children }) {
+  const { state, sendMove } = useArcadeSession(...)
+
+  const setConfigField = useCallback((value) => {
+    const playerId = activePlayers[0] || ''
+    sendMove({
+      type: 'SET_CONFIG',
+      playerId,
+      data: { field: 'configField', value },
+    })
+  }, [activePlayers, sendMove])
+
+  const goToSetup = useCallback(() => {
+    const playerId = activePlayers[0] || state.currentPlayer || ''
+    sendMove({
+      type: 'GO_TO_SETUP',
+      playerId,
+      data: {},
+    })
+  }, [activePlayers, state.currentPlayer, sendMove])
+
+  const startGame = useCallback(() => {
+    // Use current session state config (not local state!)
+    const initialData = initializeGame(state.config1, state.config2)
+
+    const playerId = activePlayers[0]
+    sendMove({
+      type: 'START_GAME',
+      playerId,
+      data: {
+        ...initialData,
+        activePlayers,
+        playerMetadata: capturePlayerMetadata(players, activePlayers),
+      },
+    })
+  }, [state.config1, state.config2, activePlayers, sendMove])
+
+  return <YourGameContext.Provider value={...} />
+}
+```
+
+---
+
+## Benefits of This Pattern
+
+### 1. **Synchronized Setup**
+- User A clicks "Setup" → All room members see setup screen
+- User B changes difficulty → All room members see the change
+- User A clicks "Start" → All room members start playing
+
+### 2. **No Special Cases**
+- Setup works like gameplay (moves + validation)
+- No conditional logic based on phase
+- No React state merging hacks
+
+### 3. **Easy to Extend**
+- New games copy the same pattern
+- Well-documented and tested
+- Consistent developer experience
+
+### 4. **Optimistic Updates**
+- Config changes feel instant
+- Client-side prediction + server validation
+- Rollback on validation failure
+
+---
+
+## Testing Checklist
+
+When implementing this pattern, test these scenarios:
+
+### Local Mode
+- [ ] Click setup button during game → returns to setup
+- [ ] Change config fields → updates immediately
+- [ ] Start game → uses current config
+
+### Room Mode (Multi-User)
+- [ ] User A clicks setup → User B sees setup screen
+- [ ] User A changes difficulty → User B sees change in real-time
+- [ ] User B changes game type → User A sees change in real-time
+- [ ] User A starts game → Both users see game with same config
+
+### Edge Cases
+- [ ] Change config rapidly → no race conditions
+- [ ] User with 0 players can see/modify setup
+- [ ] Setup → Play → Setup preserves last config
+- [ ] Invalid config values are rejected by validator
+
+---
+
+## Migration Guide
+
+If you have an existing game using local state, follow these steps:
+
+### Step 1: Add Move Types
+Add `GO_TO_SETUP` and `SET_CONFIG` to your validation types.
+
+### Step 2: Implement Validators
+Add validators for the new moves in your game validator class.
+
+### Step 3: Add Optimistic Updates
+Update `applyMoveOptimistically` to handle the new moves.
+
+### Step 4: Remove Local State
+1. Delete all `useState` calls for configuration
+2. Delete the `effectiveState` merging logic
+3. Update action creators to send moves instead
+
+### Step 5: Test
+Run through the testing checklist above.
+
+---
+
+## Reference Implementation
+
+See the Matching game for a complete reference implementation:
+
+- **Types**: `src/lib/arcade/validation/types.ts`
+- **Validator**: `src/lib/arcade/validation/MatchingGameValidator.ts`
+- **Provider**: `src/app/arcade/matching/context/RoomMemoryPairsProvider.tsx`
+- **Optimistic Updates**: `applyMoveOptimistically` function in provider
+
+Look for comments marked with:
+- `// STANDARD ARCADE PATTERN: GO_TO_SETUP`
+- `// STANDARD ARCADE PATTERN: SET_CONFIG`
+- `// NO LOCAL STATE`
+- `// NO MORE effectiveState merging!`
+
+---
+
+## Questions?
+
+If something is unclear or you encounter issues implementing this pattern, refer to the Matching game implementation or update this document with clarifications.
--- a/apps/web/.claude/CLAUDE.md
+++ b/apps/web/.claude/CLAUDE.md
@@ -0,0 +1,86 @@
+# Claude Code Instructions for apps/web
+
+## MANDATORY: Quality Checks for ALL Work
+
+**BEFORE declaring ANY work complete, fixed, or working**, you MUST run and pass these checks:
+
+### When This Applies
+- Before every commit
+- Before saying "it's done" or "it's fixed"
+- Before marking a task as complete
+- Before telling the user something is working
+- After any code changes, no matter how small
+
+```bash
+npm run pre-commit
+```
+
+This single command runs all quality checks in the correct order:
+1. `npm run type-check` - TypeScript type checking (must have 0 errors)
+2. `npm run format` - Auto-format all code with Biome
+3. `npm run lint:fix` - Auto-fix linting issues with Biome + ESLint
+4. `npm run lint` - Verify 0 errors, 0 warnings
+
+**DO NOT COMMIT** until all checks pass with zero errors and zero warnings.
+
+## Available Scripts
+
+```bash
+npm run type-check    # TypeScript: tsc --noEmit
+npm run format        # Biome: format all files
+npm run format:check  # Biome: check formatting without fixing
+npm run lint          # Biome + ESLint: check for errors/warnings
+npm run lint:fix      # Biome + ESLint: auto-fix issues
+npm run check         # Biome: full check (format + lint + imports)
+npm run pre-commit    # Run all checks (type + format + lint)
+```
+
+## Workflow
+
+When asked to make ANY changes:
+
+1. Make your code changes
+2. Run `npm run pre-commit`
+3. If it fails, fix the issues and run again
+4. Only after all checks pass can you:
+   - Say the work is "done" or "complete"
+   - Mark tasks as finished
+   - Create commits
+   - Tell the user it's working
+5. Push immediately after committing
+
+**Nothing is complete until `npm run pre-commit` passes.**
+
+## Details
+
+See `.claude/CODE_QUALITY_REGIME.md` for complete documentation.
+
+## No Pre-Commit Hooks
+
+This project does not use git pre-commit hooks for religious reasons.
+You (Claude Code) are responsible for enforcing code quality before commits.
+
+## Quick Reference: package.json Scripts
+
+**Primary workflow:**
+```bash
+npm run pre-commit  # ← Use this before every commit
+```
+
+**Individual checks (if needed):**
+```bash
+npm run type-check     # TypeScript: tsc --noEmit
+npm run format         # Biome: format code (--write)
+npm run lint           # Biome + ESLint: check only
+npm run lint:fix       # Biome + ESLint: auto-fix
+```
+
+**Additional tools:**
+```bash
+npm run format:check   # Check formatting without changing files
+npm run check          # Biome check (format + lint + organize imports)
+```
+
+---
+
+**Remember: Always run `npm run pre-commit` before creating commits.**
--- a/apps/web/.claude/CODE_QUALITY_REGIME.md
+++ b/apps/web/.claude/CODE_QUALITY_REGIME.md
@@ -0,0 +1,143 @@
+# Code Quality Regime
+
+**MANDATORY**: Before declaring ANY work complete, fixed, or working, Claude MUST run these checks and fix all issues.
+
+## Definition of "Done"
+
+Work is NOT complete until:
+- ✅ All TypeScript errors are fixed (0 errors)
+- ✅ All code is formatted with Biome
+- ✅ All linting passes (0 errors, 0 warnings)
+- ✅ `npm run pre-commit` exits successfully
+
+**Until these checks pass, the work is considered incomplete.**
+
+## Quality Check Checklist (Always Required)
+
+Run these before:
+- Committing code
+- Saying work is "done" or "complete"
+- Marking tasks as finished
+- Telling the user something is "working" or "fixed"
+
+Run these commands in order. All must pass with 0 errors and 0 warnings:
+
+```bash
+# 1. Type check
+npm run type-check
+
+# 2. Format code
+npm run format
+
+# 3. Lint and fix
+npm run lint:fix
+
+# 4. Verify clean state
+npm run lint && npm run type-check
+```
+
+## Quick Command (Run All Checks)
+
+```bash
+npm run pre-commit
+```
+
+**What it does:**
+```json
+"pre-commit": "npm run type-check && npm run format && npm run lint:fix && npm run lint"
+```
+
+This single command runs:
+1. `npm run type-check` → `tsc --noEmit` (TypeScript errors)
+2. `npm run format` → `npx @biomejs/biome format . --write` (auto-format)
+3. `npm run lint:fix` → `npx @biomejs/biome lint . --write && npx eslint . --fix` (auto-fix)
+4. `npm run lint` → `npx @biomejs/biome lint . && npx eslint .` (verify clean)
+
+Fails fast if any step fails.
+
+## The Regime Rules
+
+### 1. TypeScript Errors: ZERO TOLERANCE
+- Run `npm run type-check` before every commit
+- Fix ALL TypeScript errors
+- No `@ts-ignore` or `@ts-expect-error` without explicit justification
+
+### 2. Formatting: AUTOMATIC
+- Run `npm run format` before every commit
+- Biome handles all formatting automatically
+- Never commit unformatted code
+
+### 3. Linting: ZERO ERRORS, ZERO WARNINGS
+- Run `npm run lint:fix` to auto-fix issues
+- Then run `npm run lint` to verify 0 errors, 0 warnings
+- Fix any remaining issues manually
+
+### 4. Commit Order
+1. Make code changes
+2. Run `npm run pre-commit`
+3. If any check fails, fix and repeat
+4. Only commit when all checks pass
+5. Push immediately after commit
+
+## Why No Pre-Commit Hooks?
+
+This project intentionally avoids pre-commit hooks due to religious constraints.
+Instead, Claude Code is responsible for enforcing this regime through:
+
+1. **This documentation** - Always visible and reference-able
+2. **Package.json scripts** - Easy to run checks
+3. **Session persistence** - This file lives in `.claude/` and is read by every session
+
+## For Claude Code Sessions
+
+**READ THIS FILE AT THE START OF EVERY SESSION WHERE YOU WILL COMMIT CODE**
+
+When asked to commit:
+1. Check if you've run `npm run pre-commit` (or all 4 steps individually)
+2. If not, STOP and run the checks first
+3. Fix all issues before proceeding with the commit
+4. Only create commits when all checks pass
+
+## Complete Scripts Reference
+
+From `apps/web/package.json`:
+
+```json
+{
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "format": "npx @biomejs/biome format . --write",
+    "format:check": "npx @biomejs/biome format .",
+    "lint": "npx @biomejs/biome lint . && npx eslint .",
+    "lint:fix": "npx @biomejs/biome lint . --write && npx eslint . --fix",
+    "check": "npx @biomejs/biome check .",
+    "pre-commit": "npm run type-check && npm run format && npm run lint:fix && npm run lint"
+  }
+}
+```
+
+**Tools used:**
+- TypeScript: `tsc --noEmit` (type checking only, no output)
+- Biome: Fast formatter + linter (Rust-based, 10-100x faster than Prettier)
+- ESLint: React Hooks rules only (`rules-of-hooks` validation)
+
+## Emergency Override
+
+If you absolutely MUST commit with failing checks:
+1. Document WHY in the commit message
+2. Create a follow-up task to fix the issues
+3. Only use for emergency hotfixes
+
+## Verification
+
+After following this regime, you should see:
+```
+✓ Type check passed (0 errors)
+✓ Formatting applied
+✓ Linting passed (0 errors, 0 warnings)
+✓ Ready to commit
+```
+
+---
+
+**This regime is non-negotiable. Every commit must pass these checks.**
--- a/apps/web/.claude/PLAYER_OWNERSHIP_CENTRALIZATION_PLAN.md
+++ b/apps/web/.claude/PLAYER_OWNERSHIP_CENTRALIZATION_PLAN.md
@@ -0,0 +1,176 @@
+# Player Ownership Centralization Plan
+
+## Problem Statement
+
+Player ownership logic is currently scattered across multiple locations in the codebase, leading to bugs and inconsistencies. The same pattern appears in:
+
+1. **Server-side** (`session-manager.ts:232-239`): Builds `playerOwnership` map from database
+2. **Client-side** (`RoomMemoryPairsProvider.tsx:370-403`): Builds `playerOwnership` from `roomData.memberPlayers`
+3. **UI Components** (`PlayerStatusBar.tsx:31`, `MemoryGrid.tsx:388`): Check `player.userId === viewerId`
+4. **Validation** (`MatchingGameValidator.ts:88-102`): Validates player ownership
+
+## Current Implementations
+
+### Server-Side (session-manager.ts)
+```typescript
+// Lines 232-238
+const players = await db.query.players.findMany({
+  columns: { id: true, userId: true }
+})
+playerOwnership = Object.fromEntries(players.map(p => [p.id, p.userId]))
+```
+
+### Client-Side (RoomMemoryPairsProvider.tsx)
+```typescript
+// Lines 370-403
+const buildPlayerMetadata = useCallback((playerIds: string[]) => {
+  const playerOwnership = new Map<string, string>()
+  if (roomData?.memberPlayers) {
+    for (const [userId, userPlayers] of Object.entries(roomData.memberPlayers)) {
+      for (const player of userPlayers) {
+        playerOwnership.set(player.id, userId)
+      }
+    }
+  }
+  // ... use playerOwnership to assign correct userId
+}, [players, roomData, viewerId])
+```
+
+## Centralization Strategy
+
+### Phase 1: Create Shared Utilities Module
+**File**: `src/lib/arcade/player-ownership.ts`
+
+Create a module with:
+1. **Server-side utility**: `buildPlayerOwnershipMap(roomId?: string)`
+   - Fetches from database
+   - Returns `Record<playerId, userId>`
+   - Used by `session-manager.ts`
+
+2. **Client-side utility**: `buildPlayerOwnershipFromRoomData(roomData)`
+   - Builds from `RoomData.memberPlayers`
+   - Returns `Map<playerId, userId>` or `Record<playerId, userId>`
+   - Used by React components
+
+3. **Shared types**: `PlayerOwnershipMap = Record<string, string>`
+
+4. **Helper functions**:
+   - `isPlayerOwnedByUser(playerId, userId, ownershipMap)`
+   - `getPlayerOwner(playerId, ownershipMap)`
+   - `buildPlayerMetadata(playerIds, ownershipMap, playersMap)` - combines ownership + player data
+
+### Phase 2: Update Server-Side Code
+**Files**:
+- `src/lib/arcade/session-manager.ts`
+- `src/lib/arcade/player-manager.ts`
+
+Changes:
+1. Import utilities from `player-ownership.ts`
+2. Replace inline ownership building with `buildPlayerOwnershipMap()`
+3. Add new function to `player-manager.ts`: `getPlayerOwnershipMap(roomId)`
+
+### Phase 3: Update Client-Side Providers
+**Files**:
+- `src/app/arcade/matching/context/RoomMemoryPairsProvider.tsx`
+- Any other game providers that need this logic
+
+Changes:
+1. Import utilities from `player-ownership.ts`
+2. Replace `buildPlayerMetadata` with centralized version
+3. Use shared helper functions for ownership checks
+
+### Phase 4: Update UI Components
+**Files**:
+- `src/app/arcade/matching/components/PlayerStatusBar.tsx`
+- `src/app/arcade/matching/components/MemoryGrid.tsx`
+- `src/components/PageWithNav.tsx`
+- `src/contexts/GameModeContext.tsx`
+
+Changes:
+1. Use centralized `isPlayerOwnedByUser()` helper
+2. Consistent API across all components
+
+### Phase 5: Add to API Endpoints (if needed)
+**Files**:
+- `src/app/api/arcade/rooms/[roomId]/route.ts`
+- Any endpoints that return player data
+
+Changes:
+1. Include `playerOwnership` map in API responses where practical
+2. Document in API response types
+
+## Benefits
+
+1. **Single Source of Truth**: All ownership logic in one place
+2. **Consistency**: Same algorithm server-side and client-side
+3. **Testability**: Can unit test ownership logic in isolation
+4. **Type Safety**: Shared types across client/server boundary
+5. **Maintainability**: Bug fixes only need to be made once
+6. **Documentation**: Central location for ownership algorithm docs
+
+## Implementation Order (One Commit Per Phase)
+
+1. ✅ **Commit 1**: Create `src/lib/arcade/player-ownership.ts` with all utilities and tests
+2. ✅ **Commit 2**: Update `session-manager.ts` to use new utilities
+3. ✅ **Commit 3**: Update `player-manager.ts` to export ownership helper
+4. ✅ **Commit 4**: Update `RoomMemoryPairsProvider.tsx` to use utilities
+5. ✅ **Commit 5**: Update UI components to use helper functions
+6. ✅ **Commit 6**: Update API endpoints to include ownership data (if needed)
+7. ✅ **Commit 7**: Add comprehensive integration tests
+
+## Key Design Decisions
+
+### Server vs Client Implementations
+
+**Why separate implementations?**
+- Server uses database queries (async)
+- Client uses in-memory `RoomData` (sync)
+- Different data sources, same logic
+
+**Shared interface:**
+```typescript
+type PlayerOwnershipMap = Record<string, string> // playerId -> userId
+
+// Server-side (async)
+async function buildPlayerOwnershipMap(roomId: string): Promise<PlayerOwnershipMap>
+
+// Client-side (sync)
+function buildPlayerOwnershipFromRoomData(
+  roomData: RoomData
+): PlayerOwnershipMap
+```
+
+### Type Consistency
+
+Both return the same structure:
+```typescript
+{
+  "player-id-1": "user-id-1",
+  "player-id-2": "user-id-1",
+  "player-id-3": "user-id-2"
+}
+```
+
+This allows validators, helpers, and checks to work identically regardless of source.
+
+## Migration Path
+
+1. Create new module alongside existing code
+2. Add tests for new utilities
+3. Gradually migrate files one at a time
+4. Remove old implementations after migration complete
+5. Deprecate old patterns in documentation
+
+## Testing Strategy
+
+1. **Unit tests** for utilities in isolation
+2. **Integration tests** for server-side flow
+3. **Component tests** for client-side usage
+4. **E2E tests** for full multiplayer scenarios
+
+## Documentation
+
+Add to existing docs:
+- Update `ARCADE_ARCHITECTURE.md` with new utilities section
+- Update `MULTIPLAYER_SYNC_ARCHITECTURE.md` with ownership flow
+- Add JSDoc comments to all exported functions
--- a/apps/web/.claude/settings.local.json
+++ b/apps/web/.claude/settings.local.json
@@ -0,0 +1,23 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test:*)",
+      "Read(//Users/antialias/projects/**)",
+      "Bash(npm run lint:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(git pull:*)",
+      "Bash(git stash:*)",
+      "Bash(npm run format:*)",
+      "Bash(npm run pre-commit:*)",
+      "Bash(npm run type-check:*)",
+      "Bash(npx tsc:*)",
+      "Bash(npx @biomejs/biome format:*)",
+      "Bash(npx @biomejs/biome check:*)",
+      "Bash(npm run lint:fix:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}
--- a/apps/web/.gitignore
+++ b/apps/web/.gitignore
@@ -0,0 +1,50 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# vitest
+/.vitest
+
+# storybook
+storybook-static
+
+# panda css
+styled-system
+
+# generated
+src/generated/build-info.json
+
+# biome
+.biome
--- a/apps/web/.storybook/main.ts
+++ b/apps/web/.storybook/main.ts
@@ -1,36 +1,31 @@
-import type { StorybookConfig } from '@storybook/nextjs';
+import type { StorybookConfig } from '@storybook/nextjs'

-import { join, dirname } from "path"
+import { dirname, join } from 'path'

 /**
-* This function is used to resolve the absolute path of a package.
-* It is needed in projects that use Yarn PnP or are set up within a monorepo.
-*/
+ * This function is used to resolve the absolute path of a package.
+ * It is needed in projects that use Yarn PnP or are set up within a monorepo.
+ */
 function getAbsolutePath(value: string): any {
  return dirname(require.resolve(join(value, 'package.json')))
 }
 const config: StorybookConfig = {
-  "stories": [
-    "../src/**/*.mdx",
-    "../src/**/*.stories.@(js|jsx|mjs|ts|tsx)"
-  ],
-  "addons": [
+  stories: ['../src/**/*.mdx', '../src/**/*.stories.@(js|jsx|mjs|ts|tsx)'],
+  addons: [
    getAbsolutePath('@storybook/addon-docs'),
-    getAbsolutePath('@storybook/addon-onboarding')
+    getAbsolutePath('@storybook/addon-onboarding'),
  ],
-  "framework": {
-    "name": getAbsolutePath('@storybook/nextjs'),
-    "options": {
-      "nextConfigPath": "../next.config.js"
-    }
+  framework: {
+    name: getAbsolutePath('@storybook/nextjs'),
+    options: {
+      nextConfigPath: '../next.config.js',
+    },
  },
-  "staticDirs": [
-    "../public"
-  ],
-  "typescript": {
-    "reactDocgen": "react-docgen-typescript"
+  staticDirs: ['../public'],
+  typescript: {
+    reactDocgen: 'react-docgen-typescript',
  },
-  "webpackFinal": async (config) => {
+  webpackFinal: async (config) => {
    // Handle PandaCSS styled-system imports
    if (config.resolve) {
      config.resolve.alias = {
@@ -39,10 +34,10 @@ const config: StorybookConfig = {
        '../../styled-system/css': join(__dirname, '../styled-system/css/index.mjs'),
        '../../styled-system/patterns': join(__dirname, '../styled-system/patterns/index.mjs'),
        '../styled-system/css': join(__dirname, '../styled-system/css/index.mjs'),
-        '../styled-system/patterns': join(__dirname, '../styled-system/patterns/index.mjs')
+        '../styled-system/patterns': join(__dirname, '../styled-system/patterns/index.mjs'),
      }
    }
    return config
-  }
-};
-export default config;
+  },
+}
+export default config
--- a/apps/web/.storybook/preview.ts
+++ b/apps/web/.storybook/preview.ts
@@ -5,11 +5,11 @@ const preview: Preview = {
  parameters: {
    controls: {
      matchers: {
-       color: /(background|color)$/i,
-       date: /Date$/i,
+        color: /(background|color)$/i,
+        date: /Date$/i,
      },
    },
  },
-};
+}

-export default preview;
+export default preview
--- a/apps/web/LINTING.md
+++ b/apps/web/LINTING.md
@@ -0,0 +1,104 @@
+# Linting & Formatting Setup
+
+This project uses **Biome** for formatting and general linting, with **ESLint** handling React Hooks rules only.
+
+## Tools
+
+- **@biomejs/biome** - Fast formatter + linter + import organizer
+- **eslint** + **eslint-plugin-react-hooks** - React Hooks validation only
+
+## Scripts
+
+```bash
+# Check formatting and lint (non-destructive)
+npm run check
+
+# Lint all files
+npm run lint
+
+# Fix lint issues
+npm run lint:fix
+
+# Format all files
+npm run format
+
+# Check formatting (dry run)
+npm run format:check
+```
+
+## Configuration Files
+
+- `biome.jsonc` - Biome configuration (format + lint)
+- `eslint.config.js` - Minimal ESLint flat config for React Hooks only
+- `.gitignore` - Includes patterns for Biome cache
+
+## What Each Tool Does
+
+### Biome
+- Code formatting (Prettier-compatible)
+- General JavaScript/TypeScript linting
+- Import organization (alphabetical, remove unused)
+- Dead code detection
+- Performance optimizations
+
+### ESLint (React Hooks only)
+- `react-hooks/rules-of-hooks` - Ensures hooks are called unconditionally
+- `react-hooks/exhaustive-deps` - Warns about incomplete dependency arrays
+
+## IDE Integration
+
+### VS Code
+Install the Biome extension:
+```
+code --install-extension biomejs.biome
+```
+
+Add to `.vscode/settings.json`:
+```json
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.formatOnSave": true,
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}
+```
+
+## CI/CD
+
+Add to your GitHub Actions workflow:
+
+```yaml
+- name: Lint
+  run: npm run lint
+
+- name: Check formatting
+  run: npm run format:check
+```
+
+## Migration from ESLint + Prettier
+
+This setup replaces most ESLint and Prettier functionality:
+- ✅ Removed `eslint-config-next` inline config from `package.json`
+- ✅ No `.eslintrc.js` or `.prettierrc` files needed
+- ✅ ESLint now only runs React Hooks rules
+- ✅ Biome handles all formatting and general linting
+
+## Why This Setup?
+
+1. **Speed** - Biome is 10-100x faster than ESLint + Prettier
+2. **Simplicity** - Single tool for most concerns
+3. **Accuracy** - ESLint still catches React-specific issues Biome can't yet handle
+4. **Low Maintenance** - Minimal config overlap
+
+## Customization
+
+To add custom lint rules, edit:
+- `biome.jsonc` for general rules
+- `eslint.config.js` for React Hooks rules
--- a/apps/web/tests/api-abacus-settings.e2e.test.ts
+++ b/apps/web/tests/api-abacus-settings.e2e.test.ts
@@ -2,9 +2,9 @@
 * @vitest-environment node
 */

-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { db, schema } from '../src/db'
 import { eq } from 'drizzle-orm'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { db, schema } from '../src/db'

 /**
 * API Abacus Settings E2E Tests
@@ -19,10 +19,7 @@ describe('Abacus Settings API', () => {
  beforeEach(async () => {
    // Create a test user with unique guest ID
    testGuestId = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
-    const [user] = await db
-      .insert(schema.users)
-      .values({ guestId: testGuestId })
-      .returning()
+    const [user] = await db.insert(schema.users).values({ guestId: testGuestId }).returning()
    testUserId = user.id
  })

@@ -218,10 +215,7 @@ describe('Abacus Settings API', () => {
    it('ensures settings are isolated per user', async () => {
      // Create another user
      const testGuestId2 = `test-guest-2-${Date.now()}-${Math.random().toString(36).slice(2)}`
-      const [user2] = await db
-        .insert(schema.users)
-        .values({ guestId: testGuestId2 })
-        .returning()
+      const [user2] = await db.insert(schema.users).values({ guestId: testGuestId2 }).returning()

      try {
        // Create settings for both users
@@ -272,7 +266,7 @@ describe('Abacus Settings API', () => {
      }).rejects.toThrow(/FOREIGN KEY constraint failed/)
    })

-    it('prevents modifying another user\'s settings via userId injection', async () => {
+    it("prevents modifying another user's settings via userId injection", async () => {
      // Create victim user
      const victimGuestId = `victim-${Date.now()}-${Math.random().toString(36).slice(2)}`
      const [victimUser] = await db
--- a/apps/web/tests/api-arcade-rooms.e2e.test.ts
+++ b/apps/web/tests/api-arcade-rooms.e2e.test.ts
@@ -0,0 +1,455 @@
+/**
+ * @vitest-environment node
+ */
+
+import { eq } from 'drizzle-orm'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { db, schema } from '../src/db'
+import { createRoom } from '../src/lib/arcade/room-manager'
+import { addRoomMember } from '../src/lib/arcade/room-membership'
+
+/**
+ * Arcade Rooms API E2E Tests
+ *
+ * Tests the full arcade room system:
+ * - Room CRUD operations
+ * - Member management
+ * - Access control
+ * - Room code lookups
+ */
+
+describe('Arcade Rooms API', () => {
+  let testUserId1: string
+  let testUserId2: string
+  let testGuestId1: string
+  let testGuestId2: string
+  let testRoomId: string
+
+  beforeEach(async () => {
+    // Create test users
+    testGuestId1 = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
+    testGuestId2 = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
+
+    const [user1] = await db.insert(schema.users).values({ guestId: testGuestId1 }).returning()
+    const [user2] = await db.insert(schema.users).values({ guestId: testGuestId2 }).returning()
+
+    testUserId1 = user1.id
+    testUserId2 = user2.id
+  })
+
+  afterEach(async () => {
+    // Clean up rooms (cascade deletes members)
+    if (testRoomId) {
+      await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, testRoomId))
+    }
+
+    // Clean up users
+    await db.delete(schema.users).where(eq(schema.users.id, testUserId1))
+    await db.delete(schema.users).where(eq(schema.users.id, testUserId2))
+  })
+
+  describe('Room Creation', () => {
+    it('creates a room with valid data', async () => {
+      const room = await createRoom({
+        name: 'Test Room',
+        createdBy: testGuestId1,
+        creatorName: 'Test User',
+        gameName: 'matching',
+        gameConfig: { difficulty: 6 },
+      })
+
+      testRoomId = room.id
+
+      expect(room).toBeDefined()
+      expect(room.name).toBe('Test Room')
+      expect(room.createdBy).toBe(testGuestId1)
+      expect(room.gameName).toBe('matching')
+      expect(room.status).toBe('lobby')
+      expect(room.isLocked).toBe(false)
+      expect(room.ttlMinutes).toBe(60)
+      expect(room.code).toMatch(/^[A-Z0-9]{6}$/)
+    })
+
+    it('creates room with custom TTL', async () => {
+      const room = await createRoom({
+        name: 'Custom TTL Room',
+        createdBy: testGuestId1,
+        creatorName: 'Test User',
+        gameName: 'matching',
+        gameConfig: {},
+        ttlMinutes: 120,
+      })
+
+      testRoomId = room.id
+
+      expect(room.ttlMinutes).toBe(120)
+    })
+
+    it('generates unique room codes', async () => {
+      const room1 = await createRoom({
+        name: 'Room 1',
+        createdBy: testGuestId1,
+        creatorName: 'User 1',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+
+      const room2 = await createRoom({
+        name: 'Room 2',
+        createdBy: testGuestId2,
+        creatorName: 'User 2',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+
+      // Clean up both rooms
+      testRoomId = room1.id
+      await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, room2.id))
+
+      expect(room1.code).not.toBe(room2.code)
+    })
+  })
+
+  describe('Room Retrieval', () => {
+    beforeEach(async () => {
+      // Create a test room
+      const room = await createRoom({
+        name: 'Retrieval Test Room',
+        createdBy: testGuestId1,
+        creatorName: 'Test User',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+      testRoomId = room.id
+    })
+
+    it('retrieves room by ID', async () => {
+      const room = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.id, testRoomId),
+      })
+
+      expect(room).toBeDefined()
+      expect(room?.id).toBe(testRoomId)
+      expect(room?.name).toBe('Retrieval Test Room')
+    })
+
+    it('retrieves room by code', async () => {
+      const createdRoom = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.id, testRoomId),
+      })
+
+      const room = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.code, createdRoom!.code),
+      })
+
+      expect(room).toBeDefined()
+      expect(room?.id).toBe(testRoomId)
+    })
+
+    it('returns undefined for non-existent room', async () => {
+      const room = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.id, 'nonexistent-room-id'),
+      })
+
+      expect(room).toBeUndefined()
+    })
+  })
+
+  describe('Room Updates', () => {
+    beforeEach(async () => {
+      const room = await createRoom({
+        name: 'Update Test Room',
+        createdBy: testGuestId1,
+        creatorName: 'Test User',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+      testRoomId = room.id
+    })
+
+    it('updates room name', async () => {
+      const [updated] = await db
+        .update(schema.arcadeRooms)
+        .set({ name: 'Updated Name' })
+        .where(eq(schema.arcadeRooms.id, testRoomId))
+        .returning()
+
+      expect(updated.name).toBe('Updated Name')
+    })
+
+    it('locks room', async () => {
+      const [updated] = await db
+        .update(schema.arcadeRooms)
+        .set({ isLocked: true })
+        .where(eq(schema.arcadeRooms.id, testRoomId))
+        .returning()
+
+      expect(updated.isLocked).toBe(true)
+    })
+
+    it('updates room status', async () => {
+      const [updated] = await db
+        .update(schema.arcadeRooms)
+        .set({ status: 'playing' })
+        .where(eq(schema.arcadeRooms.id, testRoomId))
+        .returning()
+
+      expect(updated.status).toBe('playing')
+    })
+
+    it('updates lastActivity on any change', async () => {
+      const originalRoom = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.id, testRoomId),
+      })
+
+      // Wait a bit to ensure different timestamp (at least 1 second for SQLite timestamp resolution)
+      await new Promise((resolve) => setTimeout(resolve, 1100))
+
+      const [updated] = await db
+        .update(schema.arcadeRooms)
+        .set({ name: 'Activity Test', lastActivity: new Date() })
+        .where(eq(schema.arcadeRooms.id, testRoomId))
+        .returning()
+
+      expect(updated.lastActivity.getTime()).toBeGreaterThan(originalRoom!.lastActivity.getTime())
+    })
+  })
+
+  describe('Room Deletion', () => {
+    it('deletes room', async () => {
+      const room = await createRoom({
+        name: 'Delete Test Room',
+        createdBy: testGuestId1,
+        creatorName: 'Test User',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+
+      await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, room.id))
+
+      const deleted = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.id, room.id),
+      })
+
+      expect(deleted).toBeUndefined()
+    })
+
+    it('cascades delete to room members', async () => {
+      const room = await createRoom({
+        name: 'Cascade Test Room',
+        createdBy: testGuestId1,
+        creatorName: 'Test User',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+
+      // Add member
+      await addRoomMember({
+        roomId: room.id,
+        userId: testGuestId1,
+        displayName: 'Test User',
+      })
+
+      // Verify member exists
+      const membersBefore = await db.query.roomMembers.findMany({
+        where: eq(schema.roomMembers.roomId, room.id),
+      })
+      expect(membersBefore).toHaveLength(1)
+
+      // Delete room
+      await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, room.id))
+
+      // Verify members deleted
+      const membersAfter = await db.query.roomMembers.findMany({
+        where: eq(schema.roomMembers.roomId, room.id),
+      })
+      expect(membersAfter).toHaveLength(0)
+    })
+  })
+
+  describe('Room Members', () => {
+    beforeEach(async () => {
+      const room = await createRoom({
+        name: 'Members Test Room',
+        createdBy: testGuestId1,
+        creatorName: 'Test User 1',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+      testRoomId = room.id
+    })
+
+    it('adds member to room', async () => {
+      const result = await addRoomMember({
+        roomId: testRoomId,
+        userId: testGuestId1,
+        displayName: 'Test User 1',
+        isCreator: true,
+      })
+
+      expect(result.member).toBeDefined()
+      expect(result.member.roomId).toBe(testRoomId)
+      expect(result.member.userId).toBe(testGuestId1)
+      expect(result.member.displayName).toBe('Test User 1')
+      expect(result.member.isCreator).toBe(true)
+      expect(result.member.isOnline).toBe(true)
+    })
+
+    it('adds multiple members to room', async () => {
+      await addRoomMember({
+        roomId: testRoomId,
+        userId: testGuestId1,
+        displayName: 'User 1',
+      })
+
+      await addRoomMember({
+        roomId: testRoomId,
+        userId: testGuestId2,
+        displayName: 'User 2',
+      })
+
+      const members = await db.query.roomMembers.findMany({
+        where: eq(schema.roomMembers.roomId, testRoomId),
+      })
+
+      expect(members).toHaveLength(2)
+    })
+
+    it('updates existing member instead of creating duplicate', async () => {
+      // Add member first time
+      await addRoomMember({
+        roomId: testRoomId,
+        userId: testGuestId1,
+        displayName: 'First Time',
+      })
+
+      // Add same member again
+      await addRoomMember({
+        roomId: testRoomId,
+        userId: testGuestId1,
+        displayName: 'Second Time',
+      })
+
+      const members = await db.query.roomMembers.findMany({
+        where: eq(schema.roomMembers.roomId, testRoomId),
+      })
+
+      // Should still only have 1 member
+      expect(members).toHaveLength(1)
+    })
+
+    it('removes member from room', async () => {
+      const result = await addRoomMember({
+        roomId: testRoomId,
+        userId: testGuestId1,
+        displayName: 'Test User',
+      })
+
+      await db.delete(schema.roomMembers).where(eq(schema.roomMembers.id, result.member.id))
+
+      const members = await db.query.roomMembers.findMany({
+        where: eq(schema.roomMembers.roomId, testRoomId),
+      })
+
+      expect(members).toHaveLength(0)
+    })
+
+    it('tracks online status', async () => {
+      const result = await addRoomMember({
+        roomId: testRoomId,
+        userId: testGuestId1,
+        displayName: 'Test User',
+      })
+
+      expect(result.member.isOnline).toBe(true)
+
+      // Set offline
+      const [updated] = await db
+        .update(schema.roomMembers)
+        .set({ isOnline: false })
+        .where(eq(schema.roomMembers.id, result.member.id))
+        .returning()
+
+      expect(updated.isOnline).toBe(false)
+    })
+  })
+
+  describe('Access Control', () => {
+    beforeEach(async () => {
+      const room = await createRoom({
+        name: 'Access Test Room',
+        createdBy: testGuestId1,
+        creatorName: 'Creator',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+      testRoomId = room.id
+    })
+
+    it('identifies room creator correctly', async () => {
+      const room = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.id, testRoomId),
+      })
+
+      expect(room?.createdBy).toBe(testGuestId1)
+    })
+
+    it('distinguishes creator from other users', async () => {
+      const room = await db.query.arcadeRooms.findFirst({
+        where: eq(schema.arcadeRooms.id, testRoomId),
+      })
+
+      expect(room?.createdBy).not.toBe(testGuestId2)
+    })
+  })
+
+  describe('Room Listing', () => {
+    beforeEach(async () => {
+      // Create multiple test rooms
+      const room1 = await createRoom({
+        name: 'Matching Room',
+        createdBy: testGuestId1,
+        creatorName: 'User 1',
+        gameName: 'matching',
+        gameConfig: {},
+      })
+
+      const room2 = await createRoom({
+        name: 'Memory Quiz Room',
+        createdBy: testGuestId2,
+        creatorName: 'User 2',
+        gameName: 'memory-quiz',
+        gameConfig: {},
+      })
+
+      testRoomId = room1.id
+
+      // Clean up room2 after test
+      afterEach(async () => {
+        await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, room2.id))
+      })
+    })
+
+    it('lists all active rooms', async () => {
+      const rooms = await db.query.arcadeRooms.findMany({
+        where: eq(schema.arcadeRooms.status, 'lobby'),
+      })
+
+      expect(rooms.length).toBeGreaterThanOrEqual(2)
+    })
+
+    it('excludes locked rooms from listing', async () => {
+      // Lock one room
+      await db
+        .update(schema.arcadeRooms)
+        .set({ isLocked: true })
+        .where(eq(schema.arcadeRooms.id, testRoomId))
+
+      const unlockedRooms = await db.query.arcadeRooms.findMany({
+        where: eq(schema.arcadeRooms.isLocked, false),
+      })
+
+      expect(unlockedRooms.every((r) => !r.isLocked)).toBe(true)
+    })
+  })
+})
--- a/apps/web/tests/api-players.e2e.test.ts
+++ b/apps/web/tests/api-players.e2e.test.ts
@@ -2,9 +2,9 @@
 * @vitest-environment node
 */

-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { db, schema } from '../src/db'
 import { eq } from 'drizzle-orm'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { db, schema } from '../src/db'

 /**
 * API Players E2E Tests
@@ -20,10 +20,7 @@ describe('Players API', () => {
  beforeEach(async () => {
    // Create a test user with unique guest ID
    testGuestId = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
-    const [user] = await db
-      .insert(schema.users)
-      .values({ guestId: testGuestId })
-      .returning()
+    const [user] = await db.insert(schema.users).values({ guestId: testGuestId }).returning()
    testUserId = user.id
  })

@@ -406,7 +403,7 @@ describe('Players API', () => {
      }).rejects.toThrow(/FOREIGN KEY constraint failed/)
    })

-    it('prevents modifying another user\'s player via userId injection (DB layer alone is insufficient)', async () => {
+    it("prevents modifying another user's player via userId injection (DB layer alone is insufficient)", async () => {
      // Create victim user and their player
      const victimGuestId = `victim-${Date.now()}-${Math.random().toString(36).slice(2)}`
      const [victimUser] = await db
@@ -426,7 +423,7 @@ describe('Players API', () => {
          })
          .returning()

-        const [victimPlayer] = await db
+        const [_victimPlayer] = await db
          .insert(schema.players)
          .values({
            userId: victimUser.id,
@@ -464,10 +461,7 @@ describe('Players API', () => {
    it('ensures players are isolated per user', async () => {
      // Create another user
      const user2GuestId = `user2-${Date.now()}-${Math.random().toString(36).slice(2)}`
-      const [user2] = await db
-        .insert(schema.users)
-        .values({ guestId: user2GuestId })
-        .returning()
+      const [user2] = await db.insert(schema.users).values({ guestId: user2GuestId }).returning()

      try {
        // Create players for both users
--- a/apps/web/tests/api-user-stats.e2e.test.ts
+++ b/apps/web/tests/api-user-stats.e2e.test.ts
@@ -2,9 +2,9 @@
 * @vitest-environment node
 */

-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { db, schema } from '../src/db'
 import { eq } from 'drizzle-orm'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { db, schema } from '../src/db'

 /**
 * API User Stats E2E Tests
@@ -19,10 +19,7 @@ describe('User Stats API', () => {
  beforeEach(async () => {
    // Create a test user with unique guest ID
    testGuestId = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
-    const [user] = await db
-      .insert(schema.users)
-      .values({ guestId: testGuestId })
-      .returning()
+    const [user] = await db.insert(schema.users).values({ guestId: testGuestId }).returning()
    testUserId = user.id
  })

@@ -33,10 +30,7 @@ describe('User Stats API', () => {

  describe('GET /api/user-stats', () => {
    it('creates stats with defaults if none exist', async () => {
-      const [stats] = await db
-        .insert(schema.userStats)
-        .values({ userId: testUserId })
-        .returning()
+      const [stats] = await db.insert(schema.userStats).values({ userId: testUserId }).returning()

      expect(stats).toBeDefined()
      expect(stats.gamesPlayed).toBe(0)
--- a/apps/web/tests/middleware.e2e.test.ts
+++ b/apps/web/tests/middleware.e2e.test.ts
@@ -2,10 +2,10 @@
 * @vitest-environment node
 */

-import { describe, it, expect, beforeEach } from 'vitest'
 import { NextRequest } from 'next/server'
+import { beforeEach, describe, expect, it } from 'vitest'
+import { GUEST_COOKIE_NAME, verifyGuestToken } from '../src/lib/guest-token'
 import { middleware } from '../src/middleware'
-import { verifyGuestToken, GUEST_COOKIE_NAME } from '../src/lib/guest-token'

 describe('Middleware E2E', () => {
  beforeEach(() => {
@@ -74,7 +74,10 @@ describe('Middleware E2E', () => {

  it('sets secure flag in production', async () => {
    const originalEnv = process.env.NODE_ENV
-    process.env.NODE_ENV = 'production'
+    Object.defineProperty(process.env, 'NODE_ENV', {
+      value: 'production',
+      configurable: true,
+    })

    const req = new NextRequest('http://localhost:3000/')
    const res = await middleware(req)
@@ -82,12 +85,18 @@ describe('Middleware E2E', () => {
    const cookie = res.cookies.get(GUEST_COOKIE_NAME)
    expect(cookie?.secure).toBe(true)

-    process.env.NODE_ENV = originalEnv
+    Object.defineProperty(process.env, 'NODE_ENV', {
+      value: originalEnv,
+      configurable: true,
+    })
  })

  it('does not set secure flag in development', async () => {
    const originalEnv = process.env.NODE_ENV
-    process.env.NODE_ENV = 'development'
+    Object.defineProperty(process.env, 'NODE_ENV', {
+      value: 'development',
+      configurable: true,
+    })

    const req = new NextRequest('http://localhost:3000/')
    const res = await middleware(req)
@@ -95,7 +104,10 @@ describe('Middleware E2E', () => {
    const cookie = res.cookies.get(GUEST_COOKIE_NAME)
    expect(cookie?.secure).toBe(false)

-    process.env.NODE_ENV = originalEnv
+    Object.defineProperty(process.env, 'NODE_ENV', {
+      value: originalEnv,
+      configurable: true,
+    })
  })

  it('sets maxAge correctly', async () => {
--- a/apps/web/tests/orphaned-session.e2e.test.ts
+++ b/apps/web/tests/orphaned-session.e2e.test.ts
@@ -0,0 +1,203 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { eq } from 'drizzle-orm'
+import { db, schema } from '../src/db'
+import { createArcadeSession, getArcadeSession } from '../src/lib/arcade/session-manager'
+import { cleanupExpiredRooms, createRoom } from '../src/lib/arcade/room-manager'
+
+/**
+ * E2E Test: Orphaned Session After Room TTL Deletion
+ *
+ * This test simulates the exact scenario reported by the user:
+ * 1. User creates a game session in a room
+ * 2. Room expires via TTL cleanup
+ * 3. User navigates to /arcade
+ * 4. System should NOT redirect to the orphaned game
+ * 5. User should see the arcade lobby normally
+ */
+describe('E2E: Orphaned Session Cleanup on Navigation', () => {
+  const testUserId = 'e2e-user-id'
+  const testGuestId = 'e2e-guest-id'
+  let testRoomId: string
+
+  beforeEach(async () => {
+    // Create test user (simulating new or returning visitor)
+    await db
+      .insert(schema.users)
+      .values({
+        id: testUserId,
+        guestId: testGuestId,
+        createdAt: new Date(),
+      })
+      .onConflictDoNothing()
+  })
+
+  afterEach(async () => {
+    // Clean up test data
+    await db.delete(schema.arcadeSessions).where(eq(schema.arcadeSessions.userId, testUserId))
+    await db.delete(schema.users).where(eq(schema.users.id, testUserId))
+    if (testRoomId) {
+      try {
+        await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, testRoomId))
+      } catch {
+        // Room may already be deleted
+      }
+    }
+  })
+
+  it('should not redirect user to orphaned game after room TTL cleanup', async () => {
+    // === SETUP PHASE ===
+    // User creates or joins a room
+    const room = await createRoom({
+      name: 'My Game Room',
+      createdBy: testGuestId,
+      creatorName: 'Test Player',
+      gameName: 'matching',
+      gameConfig: { difficulty: 6, gameType: 'abacus-numeral', turnTimer: 30 },
+      ttlMinutes: 1, // Short TTL for testing
+    })
+    testRoomId = room.id
+
+    // User starts a game session
+    const session = await createArcadeSession({
+      userId: testGuestId,
+      gameName: 'matching',
+      gameUrl: '/arcade/matching',
+      initialState: {
+        gamePhase: 'playing',
+        cards: [],
+        gameCards: [],
+        flippedCards: [],
+        matchedPairs: 0,
+        totalPairs: 6,
+        currentPlayer: 'player-1',
+        difficulty: 6,
+        gameType: 'abacus-numeral',
+        turnTimer: 30,
+      },
+      activePlayers: ['player-1'],
+      roomId: room.id,
+    })
+
+    // Verify session was created
+    expect(session).toBeDefined()
+    expect(session.roomId).toBe(room.id)
+
+    // === TTL EXPIRATION PHASE ===
+    // Simulate time passing - room's TTL expires
+    // Set lastActivity to past so cleanup detects it
+    await db
+      .update(schema.arcadeRooms)
+      .set({
+        lastActivity: new Date(Date.now() - 2 * 60 * 1000), // 2 minutes ago
+      })
+      .where(eq(schema.arcadeRooms.id, room.id))
+
+    // Run cleanup (simulating background cleanup job)
+    const deletedCount = await cleanupExpiredRooms()
+    expect(deletedCount).toBeGreaterThan(0) // Room should be deleted
+
+    // === USER NAVIGATION PHASE ===
+    // User navigates to /arcade (arcade lobby)
+    // The useArcadeRedirect hook calls getArcadeSession to check for active session
+    const activeSession = await getArcadeSession(testGuestId)
+
+    // === ASSERTION PHASE ===
+    // Expected behavior: NO active session returned
+    // This prevents redirect to /arcade/matching which would be broken
+    expect(activeSession).toBeUndefined()
+
+    // Verify the orphaned session was cleaned up from database
+    const [orphanedSessionCheck] = await db
+      .select()
+      .from(schema.arcadeSessions)
+      .where(eq(schema.arcadeSessions.userId, testUserId))
+      .limit(1)
+
+    expect(orphanedSessionCheck).toBeUndefined()
+  })
+
+  it('should allow user to start new game after orphaned session cleanup', async () => {
+    // === SETUP: Create and orphan a session ===
+    const oldRoom = await createRoom({
+      name: 'Old Room',
+      createdBy: testGuestId,
+      creatorName: 'Test Player',
+      gameName: 'matching',
+      gameConfig: { difficulty: 6 },
+      ttlMinutes: 1,
+    })
+
+    await createArcadeSession({
+      userId: testGuestId,
+      gameName: 'matching',
+      gameUrl: '/arcade/matching',
+      initialState: { gamePhase: 'setup' },
+      activePlayers: ['player-1'],
+      roomId: oldRoom.id,
+    })
+
+    // Delete room (TTL cleanup)
+    await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, oldRoom.id))
+
+    // === ACTION: User tries to access arcade ===
+    const orphanedSession = await getArcadeSession(testGuestId)
+    expect(orphanedSession).toBeUndefined() // Orphan cleaned up
+
+    // === ACTION: User creates new room and session ===
+    const newRoom = await createRoom({
+      name: 'New Room',
+      createdBy: testGuestId,
+      creatorName: 'Test Player',
+      gameName: 'matching',
+      gameConfig: { difficulty: 8 },
+      ttlMinutes: 60,
+    })
+    testRoomId = newRoom.id
+
+    const newSession = await createArcadeSession({
+      userId: testGuestId,
+      gameName: 'matching',
+      gameUrl: '/arcade/matching',
+      initialState: { gamePhase: 'setup' },
+      activePlayers: ['player-1', 'player-2'],
+      roomId: newRoom.id,
+    })
+
+    // === ASSERTION: New session works correctly ===
+    expect(newSession).toBeDefined()
+    expect(newSession.roomId).toBe(newRoom.id)
+
+    const activeSession = await getArcadeSession(testGuestId)
+    expect(activeSession).toBeDefined()
+    expect(activeSession?.roomId).toBe(newRoom.id)
+  })
+
+  it('should handle race condition: getArcadeSession called while room is being deleted', async () => {
+    // Create room and session
+    const room = await createRoom({
+      name: 'Race Condition Room',
+      createdBy: testGuestId,
+      creatorName: 'Test Player',
+      gameName: 'matching',
+      gameConfig: { difficulty: 6 },
+      ttlMinutes: 60,
+    })
+    testRoomId = room.id
+
+    await createArcadeSession({
+      userId: testGuestId,
+      gameName: 'matching',
+      gameUrl: '/arcade/matching',
+      initialState: { gamePhase: 'setup' },
+      activePlayers: ['player-1'],
+      roomId: room.id,
+    })
+
+    // Simulate race: delete room while getArcadeSession is checking
+    await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, room.id))
+
+    // Should gracefully handle and return undefined
+    const result = await getArcadeSession(testGuestId)
+    expect(result).toBeUndefined()
+  })
+})
--- a/apps/web/tests/room-realtime-updates.e2e.test.ts
+++ b/apps/web/tests/room-realtime-updates.e2e.test.ts
@@ -0,0 +1,371 @@
+/**
+ * @vitest-environment node
+ */
+
+import { createServer } from 'http'
+import { eq } from 'drizzle-orm'
+import { io as ioClient, type Socket } from 'socket.io-client'
+import { afterEach, beforeEach, describe, expect, it, afterAll, beforeAll } from 'vitest'
+import { db, schema } from '../src/db'
+import { createRoom } from '../src/lib/arcade/room-manager'
+import { addRoomMember } from '../src/lib/arcade/room-membership'
+import { initializeSocketServer } from '../socket-server'
+import type { Server as SocketIOServerType } from 'socket.io'
+
+/**
+ * Real-time Room Updates E2E Tests
+ *
+ * Tests that socket broadcasts work correctly when users join/leave rooms.
+ * Simulates multiple connected users and verifies they receive real-time updates.
+ */
+
+describe('Room Real-time Updates', () => {
+  let testUserId1: string
+  let testUserId2: string
+  let testGuestId1: string
+  let testGuestId2: string
+  let testRoomId: string
+  let socket1: Socket
+  let httpServer: any
+  let io: SocketIOServerType
+  let serverPort: number
+
+  beforeAll(async () => {
+    // Create HTTP server and initialize Socket.IO for testing
+    httpServer = createServer()
+    io = initializeSocketServer(httpServer)
+
+    // Find an available port
+    await new Promise<void>((resolve) => {
+      httpServer.listen(0, () => {
+        serverPort = (httpServer.address() as any).port
+        console.log(`Test socket server listening on port ${serverPort}`)
+        resolve()
+      })
+    })
+  })
+
+  afterAll(async () => {
+    // Close all socket connections
+    if (io) {
+      io.close()
+    }
+    if (httpServer) {
+      await new Promise<void>((resolve) => {
+        httpServer.close(() => resolve())
+      })
+    }
+  })
+
+  beforeEach(async () => {
+    // Create test users
+    testGuestId1 = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
+    testGuestId2 = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
+
+    const [user1] = await db.insert(schema.users).values({ guestId: testGuestId1 }).returning()
+    const [user2] = await db.insert(schema.users).values({ guestId: testGuestId2 }).returning()
+
+    testUserId1 = user1.id
+    testUserId2 = user2.id
+
+    // Create a test room
+    const room = await createRoom({
+      name: 'Realtime Test Room',
+      createdBy: testGuestId1,
+      creatorName: 'User 1',
+      gameName: 'matching',
+      gameConfig: { difficulty: 6 },
+      ttlMinutes: 60,
+    })
+    testRoomId = room.id
+  })
+
+  afterEach(async () => {
+    // Disconnect sockets
+    if (socket1?.connected) {
+      socket1.disconnect()
+    }
+
+    // Clean up room members
+    await db.delete(schema.roomMembers).where(eq(schema.roomMembers.roomId, testRoomId))
+
+    // Clean up rooms
+    if (testRoomId) {
+      await db.delete(schema.arcadeRooms).where(eq(schema.arcadeRooms.id, testRoomId))
+    }
+
+    // Clean up users
+    await db.delete(schema.users).where(eq(schema.users.id, testUserId1))
+    await db.delete(schema.users).where(eq(schema.users.id, testUserId2))
+  })
+
+  it('should broadcast member-joined when a user joins via API', async () => {
+    // User 1 joins the room via API first (this is what happens when they click "Join Room")
+    await addRoomMember({
+      roomId: testRoomId,
+      userId: testGuestId1,
+      displayName: 'User 1',
+      isCreator: false,
+    })
+
+    // User 1 connects to socket
+    socket1 = ioClient(`http://localhost:${serverPort}`, {
+      path: '/api/socket',
+      transports: ['websocket'],
+    })
+
+    // Wait for socket to connect
+    await new Promise<void>((resolve, reject) => {
+      socket1.on('connect', () => resolve())
+      socket1.on('connect_error', (err) => reject(err))
+      setTimeout(() => reject(new Error('Connection timeout')), 2000)
+    })
+
+    // Small delay to ensure event handlers are set up
+    await new Promise((resolve) => setTimeout(resolve, 50))
+
+    // Set up listener for room-joined BEFORE emitting
+    const roomJoinedPromise = new Promise<void>((resolve, reject) => {
+      socket1.on('room-joined', () => resolve())
+      socket1.on('room-error', (err) => reject(new Error(err.error)))
+      setTimeout(() => reject(new Error('Room-joined timeout')), 3000)
+    })
+
+    // Now emit the join-room event
+    socket1.emit('join-room', { roomId: testRoomId, userId: testGuestId1 })
+
+    // Wait for confirmation
+    await roomJoinedPromise
+
+    // Set up listener for member-joined event BEFORE User 2 joins
+    const memberJoinedPromise = new Promise<any>((resolve, reject) => {
+      socket1.on('member-joined', (data) => {
+        resolve(data)
+      })
+      setTimeout(() => reject(new Error('Timeout waiting for member-joined event')), 3000)
+    })
+
+    // User 2 joins the room via addRoomMember
+    const { member: newMember } = await addRoomMember({
+      roomId: testRoomId,
+      userId: testGuestId2,
+      displayName: 'User 2',
+      isCreator: false,
+    })
+
+    // Manually trigger the broadcast (this is what the API route SHOULD do)
+    const { getRoomMembers } = await import('../src/lib/arcade/room-membership')
+    const { getRoomActivePlayers } = await import('../src/lib/arcade/player-manager')
+
+    const members = await getRoomMembers(testRoomId)
+    const memberPlayers = await getRoomActivePlayers(testRoomId)
+
+    const memberPlayersObj: Record<string, any[]> = {}
+    for (const [uid, players] of memberPlayers.entries()) {
+      memberPlayersObj[uid] = players
+    }
+
+    io.to(`room:${testRoomId}`).emit('member-joined', {
+      roomId: testRoomId,
+      userId: testGuestId2,
+      members,
+      memberPlayers: memberPlayersObj,
+    })
+
+    // Wait for the socket broadcast with timeout
+    const data = await memberJoinedPromise
+
+    // Verify the broadcast data
+    expect(data).toBeDefined()
+    expect(data.roomId).toBe(testRoomId)
+    expect(data.userId).toBe(testGuestId2)
+    expect(data.members).toBeDefined()
+    expect(Array.isArray(data.members)).toBe(true)
+
+    // Verify both users are in the members list
+    const memberUserIds = data.members.map((m: any) => m.userId)
+    expect(memberUserIds).toContain(testGuestId1)
+    expect(memberUserIds).toContain(testGuestId2)
+
+    // Verify the new member details
+    const addedMember = data.members.find((m: any) => m.userId === testGuestId2)
+    expect(addedMember).toBeDefined()
+    expect(addedMember.displayName).toBe('User 2')
+    expect(addedMember.roomId).toBe(testRoomId)
+  })
+
+  it('should broadcast member-left when a user leaves via API', async () => {
+    // User 1 joins the room first
+    await addRoomMember({
+      roomId: testRoomId,
+      userId: testGuestId1,
+      displayName: 'User 1',
+      isCreator: false,
+    })
+
+    // User 2 joins the room
+    await addRoomMember({
+      roomId: testRoomId,
+      userId: testGuestId2,
+      displayName: 'User 2',
+      isCreator: false,
+    })
+
+    // User 1 connects to socket
+    socket1 = ioClient(`http://localhost:${serverPort}`, {
+      path: '/api/socket',
+      transports: ['websocket'],
+    })
+
+    await new Promise<void>((resolve) => {
+      socket1.on('connect', () => resolve())
+    })
+
+    socket1.emit('join-room', { roomId: testRoomId, userId: testGuestId1 })
+
+    await new Promise<void>((resolve) => {
+      socket1.on('room-joined', () => resolve())
+    })
+
+    // Set up listener for member-left event
+    const memberLeftPromise = new Promise<any>((resolve) => {
+      socket1.on('member-left', (data) => {
+        resolve(data)
+      })
+    })
+
+    // User 2 leaves the room via API
+    await db.delete(schema.roomMembers).where(eq(schema.roomMembers.userId, testGuestId2))
+
+    // Manually trigger the leave broadcast (simulating what the API does)
+    const { getSocketIO } = await import('../src/lib/socket-io')
+    const io = await getSocketIO()
+    if (io) {
+      const { getRoomMembers } = await import('../src/lib/arcade/room-membership')
+      const { getRoomActivePlayers } = await import('../src/lib/arcade/player-manager')
+
+      const members = await getRoomMembers(testRoomId)
+      const memberPlayers = await getRoomActivePlayers(testRoomId)
+
+      const memberPlayersObj: Record<string, any[]> = {}
+      for (const [uid, players] of memberPlayers.entries()) {
+        memberPlayersObj[uid] = players
+      }
+
+      io.to(`room:${testRoomId}`).emit('member-left', {
+        roomId: testRoomId,
+        userId: testGuestId2,
+        members,
+        memberPlayers: memberPlayersObj,
+      })
+    }
+
+    // Wait for the socket broadcast with timeout
+    const data = await Promise.race([
+      memberLeftPromise,
+      new Promise((_, reject) =>
+        setTimeout(() => reject(new Error('Timeout waiting for member-left event')), 2000)
+      ),
+    ])
+
+    // Verify the broadcast data
+    expect(data).toBeDefined()
+    expect(data.roomId).toBe(testRoomId)
+    expect(data.userId).toBe(testGuestId2)
+    expect(data.members).toBeDefined()
+    expect(Array.isArray(data.members)).toBe(true)
+
+    // Verify User 2 is no longer in the members list
+    const memberUserIds = data.members.map((m: any) => m.userId)
+    expect(memberUserIds).toContain(testGuestId1)
+    expect(memberUserIds).not.toContain(testGuestId2)
+  })
+
+  it('should update both members and players lists in member-joined broadcast', async () => {
+    // Create an active player for User 2
+    const [player2] = await db
+      .insert(schema.players)
+      .values({
+        userId: testUserId2,
+        name: 'Player 2',
+        emoji: '🎮',
+        color: '#3b82f6',
+        isActive: true,
+      })
+      .returning()
+
+    // User 1 connects and joins room
+    socket1 = ioClient(`http://localhost:${serverPort}`, {
+      path: '/api/socket',
+      transports: ['websocket'],
+    })
+
+    await new Promise<void>((resolve) => {
+      socket1.on('connect', () => resolve())
+    })
+
+    socket1.emit('join-room', { roomId: testRoomId, userId: testGuestId1 })
+
+    await new Promise<void>((resolve) => {
+      socket1.on('room-joined', () => resolve())
+    })
+
+    const memberJoinedPromise = new Promise<any>((resolve) => {
+      socket1.on('member-joined', (data) => {
+        resolve(data)
+      })
+    })
+
+    // User 2 joins via API
+    await addRoomMember({
+      roomId: testRoomId,
+      userId: testGuestId2,
+      displayName: 'User 2',
+      isCreator: false,
+    })
+
+    // Manually trigger the broadcast (simulating what the API does)
+    const { getRoomMembers: getRoomMembers3 } = await import('../src/lib/arcade/room-membership')
+    const { getRoomActivePlayers: getRoomActivePlayers3 } = await import(
+      '../src/lib/arcade/player-manager'
+    )
+
+    const members2 = await getRoomMembers3(testRoomId)
+    const memberPlayers2 = await getRoomActivePlayers3(testRoomId)
+
+    const memberPlayersObj2: Record<string, any[]> = {}
+    for (const [uid, players] of memberPlayers2.entries()) {
+      memberPlayersObj2[uid] = players
+    }
+
+    io.to(`room:${testRoomId}`).emit('member-joined', {
+      roomId: testRoomId,
+      userId: testGuestId2,
+      members: members2,
+      memberPlayers: memberPlayersObj2,
+    })
+
+    const data = await Promise.race([
+      memberJoinedPromise,
+      new Promise((_, reject) => setTimeout(() => reject(new Error('Timeout')), 2000)),
+    ])
+
+    // Verify members list is updated
+    expect(data.members).toBeDefined()
+    const memberUserIds = data.members.map((m: any) => m.userId)
+    expect(memberUserIds).toContain(testGuestId2)
+
+    // Verify players list is updated
+    expect(data.memberPlayers).toBeDefined()
+    expect(data.memberPlayers[testGuestId2]).toBeDefined()
+    expect(Array.isArray(data.memberPlayers[testGuestId2])).toBe(true)
+
+    // User 2's players should include the active player we created
+    const user2Players = data.memberPlayers[testGuestId2]
+    expect(user2Players.length).toBeGreaterThan(0)
+    expect(user2Players.some((p: any) => p.id === player2.id)).toBe(true)
+
+    // Clean up player
+    await db.delete(schema.players).where(eq(schema.players.id, player2.id))
+  })
+})
--- a/apps/web/biome.jsonc
+++ b/apps/web/biome.jsonc
@@ -0,0 +1,69 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.2.5/schema.json",
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "a11y": {
+        "useButtonType": "off",
+        "noSvgWithoutTitle": "off",
+        "noLabelWithoutControl": "off",
+        "noStaticElementInteractions": "off",
+        "useKeyWithClickEvents": "off",
+        "useSemanticElements": "off"
+      },
+      "suspicious": {
+        "noExplicitAny": "off",
+        "noArrayIndexKey": "off",
+        "noImplicitAnyLet": "off",
+        "noAssignInExpressions": "off",
+        "useIterableCallbackReturn": "off"
+      },
+      "style": {
+        "useNodejsImportProtocol": "off",
+        "noNonNullAssertion": "off",
+        "noDescendingSpecificity": "off"
+      },
+      "correctness": {
+        "noUnusedVariables": "off",
+        "noUnusedFunctionParameters": "off",
+        "useUniqueElementIds": "off",
+        "noChildrenProp": "off",
+        "useExhaustiveDependencies": "off",
+        "noInvalidUseBeforeDeclaration": "off",
+        "useHookAtTopLevel": "off",
+        "noNestedComponentDefinitions": "off",
+        "noUnreachable": "off"
+      },
+      "security": {
+        "noDangerouslySetInnerHtml": "off"
+      },
+      "performance": {
+        "noAccumulatingSpread": "off"
+      }
+    }
+  },
+  "files": {
+    "ignoreUnknown": true
+  },
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true,
+    "defaultBranch": "main"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "jsxQuoteStyle": "double",
+      "semicolons": "asNeeded",
+      "trailingCommas": "es5"
+    }
+  }
+}
--- a/apps/web/docs/FIXES-APPLIED.md
+++ b/apps/web/docs/FIXES-APPLIED.md
@@ -0,0 +1,169 @@
+# User/Player/Room Member Inconsistencies - FIXED ✅
+
+All critical inconsistencies between users, players, and room members have been resolved.
+
+## Summary of Fixes
+
+### 1. ✅ Backend - Player Fetching
+
+**Created**: `src/lib/arcade/player-manager.ts`
+- `getActivePlayers(userId)` - Get a user's active players
+- `getRoomActivePlayers(roomId)` - Get all active players for all members in a room
+- `getRoomPlayerIds(roomId)` - Get flat list of all player IDs in a room
+- `validatePlayerInRoom(playerId, roomId)` - Validate player belongs to room member
+- `getPlayer(playerId)` - Get single player by ID
+- `getPlayers(playerIds[])` - Get multiple players by IDs
+
+### 2. ✅ API Endpoints Updated
+
+**`/api/arcade/rooms/:roomId/join` (POST)**
+```typescript
+// Now returns:
+{
+  member: RoomMember,
+  room: Room,
+  activePlayers: Player[], // USER's active players
+  alreadyMember: boolean
+}
+```
+
+**`/api/arcade/rooms/:roomId` (GET)**
+```typescript
+// Now returns:
+{
+  room: Room,
+  members: RoomMember[],
+  memberPlayers: Record<userId, Player[]>, // Map of all members' players
+  canModerate: boolean
+}
+```
+
+**`/api/arcade/rooms` (GET)**
+```typescript
+// Now returns:
+{
+  rooms: Array<{
+    ...roomData,
+    memberCount: number,  // Number of users in room
+    playerCount: number   // Total players across all users
+  }>
+}
+```
+
+### 3. ✅ Socket Events Updated
+
+**`join-room` event**
+```typescript
+// Server emits:
+socket.emit('room-joined', {
+  room,
+  members,
+  onlineMembers,
+  memberPlayers: Record<userId, Player[]>,  // All members' players
+  activePlayers: Player[]  // This user's active players
+})
+
+socket.to(`room:${roomId}`).emit('member-joined', {
+  member,
+  activePlayers: Player[],  // New member's active players
+  onlineMembers,
+  memberPlayers: Record<userId, Player[]>
+})
+```
+
+**`room-game-move` event**
+```typescript
+// Now validates:
+1. User is a room member (userId check)
+2. Player belongs to a room member (playerId validation)
+
+// Rejects move if playerId doesn't belong to any room member
+```
+
+### 4. ✅ Frontend UI Updated
+
+**Room Lobby (`/arcade/rooms/[roomId]/page.tsx`)**
+
+Before:
+```
+Member: Jane
+  Status: Online
+```
+
+After:
+```
+Member: Jane
+  Status: Online
+  Players: 👧 Alice, 👦 Bob
+```
+
+**Room Browser (`/arcade/rooms/page.tsx`)**
+
+Before:
+```
+Room: Math Masters
+  Host: Jane | Game: matching | Status: Waiting
+```
+
+After:
+```
+Room: Math Masters
+  Host: Jane | Game: matching | 👥 3 members | 🎯 7 players | Status: Waiting
+```
+
+## Key Changes Summary
+
+| Component | Change |
+|-----------|--------|
+| **Helper Functions** | Created `player-manager.ts` with 6 new functions |
+| **Join Endpoint** | Now fetches and returns user's active players |
+| **Room Detail Endpoint** | Returns player map for all members |
+| **Rooms List Endpoint** | Returns member and player counts |
+| **Socket join-room** | Broadcasts active players to room |
+| **Socket room-game-move** | Validates player IDs belong to members |
+| **Room Lobby UI** | Shows each member's players |
+| **Room Browser UI** | Shows total member and player counts |
+
+## Validation Rules Enforced
+
+1. ✅ **Room membership tracked by USER ID** - Correct
+2. ✅ **Game participation tracked by PLAYER IDs** - Fixed
+3. ✅ **When user joins room, their active players join game** - Implemented
+4. ✅ **Socket moves validate player belongs to room** - Added validation
+5. ✅ **UI shows both members and their players** - Updated
+
+## TypeScript Validation
+
+All changes pass TypeScript validation with 0 errors in modified files:
+- `src/lib/arcade/player-manager.ts` ✅
+- `src/app/api/arcade/rooms/route.ts` ✅
+- `src/app/api/arcade/rooms/[roomId]/route.ts` ✅
+- `src/app/api/arcade/rooms/[roomId]/join/route.ts` ✅
+- `src/app/arcade/rooms/page.tsx` ✅
+- `src/app/arcade/rooms/[roomId]/page.tsx` ✅
+- `socket-server.ts` ✅
+
+## Testing Checklist
+
+- [ ] Create a user with multiple active players
+- [ ] Join a room and verify all active players are shown
+- [ ] Have multiple users join the same room
+- [ ] Verify each user's players are displayed correctly
+- [ ] Verify room browser shows correct member/player counts
+- [ ] Start a game and verify all player IDs are collected
+- [ ] Test that invalid player IDs are rejected in game moves
+
+## Documentation Created
+
+1. `docs/terminology-user-player-room.md` - Complete explanation
+2. `.claude/terminology.md` - Quick reference for AI
+3. `docs/INCONSISTENCIES.md` - Analysis of issues (pre-fix)
+4. `docs/FIXES-APPLIED.md` - This document
+
+## Next Steps (Phase 4)
+
+The system is now ready for full multiplayer game integration:
+1. When room game starts, collect all player IDs from all members
+2. Set `arcade_sessions.activePlayers` to all room player IDs
+3. Game state tracks scores/moves by PLAYER ID
+4. Broadcast game updates to all room members
--- a/apps/web/docs/INCONSISTENCIES.md
+++ b/apps/web/docs/INCONSISTENCIES.md
@@ -0,0 +1,189 @@
+# Current Implementation vs Correct Design - Inconsistencies
+
+## ❌ Inconsistency 1: Room Join Doesn't Fetch Active Players
+
+**Current Code** (`/api/arcade/rooms/:roomId/join`):
+```typescript
+// Only creates room_member record with userId
+const member = await addRoomMember({
+  roomId,
+  userId: viewerId,  // ✅ Correct: USER ID
+  displayName,
+  isCreator: false,
+})
+// ❌ Missing: Does not fetch user's active players
+```
+
+**Should Be**:
+```typescript
+// 1. Create room member
+const member = await addRoomMember({ ... })
+
+// 2. Fetch user's active players
+const activePlayers = await db.query.players.findMany({
+  where: and(
+    eq(players.userId, viewerId),
+    eq(players.isActive, true)
+  )
+})
+
+// 3. Return both member and their active players
+return { member, activePlayers }
+```
+
+---
+
+## ❌ Inconsistency 2: Socket Events Use USER ID Instead of PLAYER ID
+
+**Current Code** (`socket-server.ts`):
+```typescript
+socket.on('join-room', ({ roomId, userId }) => {
+  // Uses USER ID for presence
+  await setMemberOnline(roomId, userId, true)
+  socket.emit('room-joined', { members })
+})
+
+socket.on('room-game-move', ({ roomId, userId, move }) => {
+  // ❌ Wrong: Uses USER ID for game moves
+  // Should use PLAYER ID
+})
+```
+
+**Should Be**:
+```typescript
+socket.on('join-room', ({ roomId, userId }) => {
+  // ✅ Correct: Use USER ID for room presence
+  await setMemberOnline(roomId, userId, true)
+
+  // ❌ Missing: Should also fetch and broadcast active players
+  const activePlayers = await getActivePlayers(userId)
+  socket.emit('room-joined', { members, activePlayers })
+})
+
+socket.on('room-game-move', ({ roomId, playerId, move }) => {
+  // ✅ Correct: Use PLAYER ID for game actions
+  // Validate that playerId belongs to a member in this room
+})
+```
+
+---
+
+## ❌ Inconsistency 3: Room Member Interface Missing Player Association
+
+**Current Code** (`room_members` table):
+```typescript
+interface RoomMember {
+  id: string
+  roomId: string
+  userId: string       // ✅ Correct: USER ID
+  displayName: string
+  isCreator: boolean
+  // ❌ Missing: No link to user's players
+}
+```
+
+**Need to Add** (runtime association, not DB schema):
+```typescript
+interface RoomMemberWithPlayers {
+  member: RoomMember
+  activePlayers: Player[]  // The user's active players
+}
+```
+
+---
+
+## ❌ Inconsistency 4: Client UI Shows Room Members, Not Players
+
+**Current Code** (`/arcade/rooms/[roomId]/page.tsx`):
+```typescript
+// Shows room members (users)
+{members.map((member) => (
+  <div key={member.id}>
+    {member.displayName} {/* USER's display name */}
+  </div>
+))}
+
+// ❌ Missing: Should show the PLAYERS that will participate
+```
+
+**Should Show**:
+```typescript
+{members.map((member) => (
+  <div key={member.id}>
+    <div>{member.displayName} (Room Member)</div>
+    <div>Players:
+      {member.activePlayers.map(player => (
+        <span key={player.id}>{player.emoji} {player.name}</span>
+      ))}
+    </div>
+  </div>
+))}
+```
+
+---
+
+## Summary of Required Changes
+
+### Phase 1: Backend - Player Fetching
+1. ✅ `room_members` table correctly uses USER ID (no change needed)
+2. ❌ `/api/arcade/rooms/:roomId/join` - Fetch and return active players
+3. ❌ `/api/arcade/rooms/:roomId` GET - Include active players in response
+4. ❌ Create helper: `getActivePlayers(userId) => Player[]`
+
+### Phase 2: Socket Layer - Player Association
+1. ❌ `join-room` event - Broadcast active players to room
+2. ❌ `room-game-move` event - Accept PLAYER ID, not USER ID
+3. ❌ Validate PLAYER ID belongs to a room member
+
+### Phase 3: Frontend - Player Display
+1. ❌ Room lobby - Show each member's active players
+2. ❌ Game setup - Use PLAYER IDs for `activePlayers` array
+3. ❌ Move/action events - Send PLAYER ID
+
+### Phase 4: Game Integration
+1. ❌ When room game starts, collect all PLAYER IDs from all members
+2. ❌ Arcade session `activePlayers` should contain all room PLAYER IDs
+3. ❌ Game state tracks scores/moves by PLAYER ID, not USER ID
+
+---
+
+## Test Scenarios
+
+### Scenario 1: Single Player Per User
+```
+USER Jane (guest_123)
+  └─ PLAYER Alice (active)
+
+Joins room → Room shows "Jane: Alice 👧"
+Game starts → activePlayers: ["alice_id"]
+```
+
+### Scenario 2: Multiple Players Per User
+```
+USER Jane (guest_123)
+  ├─ PLAYER Alice (active)
+  └─ PLAYER Bob (active)
+
+Joins room → Room shows "Jane: Alice 👧, Bob 👦"
+Game starts → activePlayers: ["alice_id", "bob_id"]
+```
+
+### Scenario 3: Multi-User Room
+```
+USER Jane
+  └─ PLAYER Alice, Bob (active)
+
+USER Mark
+  └─ PLAYER Mario (active)
+
+USER Sara
+  └─ PLAYER Luna, Nova, Star (active)
+
+Room shows:
+  - Jane: Alice 👧, Bob 👦
+  - Mark: Mario 🍄
+  - Sara: Luna 🌙, Nova ✨, Star ⭐
+
+Game starts → activePlayers: [alice, bob, mario, luna, nova, star]
+Total: 6 players across 3 users
+```
--- a/apps/web/docs/MULTIPLAYER_SYNC_ARCHITECTURE.md
+++ b/apps/web/docs/MULTIPLAYER_SYNC_ARCHITECTURE.md
@@ -0,0 +1,490 @@
+# Multiplayer Synchronization Architecture
+
+## Current State: Single-User Multi-Tab Sync
+
+### How it Works
+
+**Client-Side Flow:**
+
+1. User opens game in Tab A and Tab B
+2. Both tabs create WebSocket connections via `useArcadeSocket()`
+3. Both emit `join-arcade-session` with `userId`
+4. Server adds both sockets to `arcade:${userId}` room
+
+**When User Makes a Move (from Tab A):**
+
+```typescript
+// Client (Tab A)
+sendMove({ type: 'FLIP_CARD', playerId: 'player-1', data: { cardId: 'card-5' } })
+
+// Optimistic update applied locally
+state = applyMoveOptimistically(state, move)
+
+// Socket emits to server
+socket.emit('game-move', { userId, move })
+```
+
+**Server Processing:**
+
+```typescript
+// socket-server.ts line 71
+socket.on('game-move', async (data) => {
+  // Validate move
+  const result = await applyGameMove(data.userId, data.move)
+
+  if (result.success) {
+    // ✅ Broadcast to ALL tabs of this user
+    io.to(`arcade:${data.userId}`).emit('move-accepted', {
+      gameState: result.session.gameState,
+      version: result.session.version,
+      move: data.move
+    })
+  }
+})
+```
+
+**Both Tabs Receive Update:**
+
+```typescript
+// Client (Tab A and Tab B)
+socket.on('move-accepted', (data) => {
+  // Update server state
+  optimistic.handleMoveAccepted(data.gameState, data.version, data.move)
+
+  // Tab A: Remove from pending queue (was optimistic)
+  // Tab B: Just sync with server state (wasn't expecting it)
+})
+```
+
+### Key Components
+
+1. **`useOptimisticGameState`** - Manages optimistic updates
+   - Keeps `serverState` (last confirmed by server)
+   - Keeps `pendingMoves[]` (not yet confirmed)
+   - Current state = serverState + all pending moves applied
+
+2. **`useArcadeSession`** - Combines socket + optimistic state
+   - Connects socket
+   - Applies moves optimistically
+   - Sends moves to server
+   - Handles server responses
+
+3. **Socket Rooms** - Server-side broadcast channels
+   - `arcade:${userId}` - All tabs of one user
+   - Each socket can be in multiple rooms
+   - `io.to(room).emit()` broadcasts to all sockets in that room
+
+4. **Session Storage** - Database
+   - One session per user (userId is unique key)
+   - Contains `gameState`, `version`, `roomId`
+   - Optimistic locking via version number
+
+---
+
+## Required: Room-Based Multi-User Sync
+
+### The Goal
+
+Multiple users in the same room at `/arcade/room` should all see synchronized game state:
+
+- User A (2 tabs): Tab A1, Tab A2
+- User B (1 tab): Tab B1
+- User C (2 tabs): Tab C1, Tab C2
+
+When User A makes a move in Tab A1:
+- **All of User A's tabs** see the move (Tab A1, Tab A2)
+- **All of User B's tabs** see the move (Tab B1)
+- **All of User C's tabs** see the move (Tab C1, Tab C2)
+
+### The Challenge
+
+Current architecture only broadcasts within one user:
+```typescript
+// ❌ Only reaches User A's tabs
+io.to(`arcade:${userA}`).emit('move-accepted', ...)
+```
+
+We need to broadcast to the entire room:
+```typescript
+// ✅ Reaches all users in the room
+io.to(`game:${roomId}`).emit('move-accepted', ...)
+```
+
+### The Solution
+
+#### 1. Add Room-Based Game Socket Room
+
+When a user joins `/arcade/room`, they join TWO socket rooms:
+
+```typescript
+// socket-server.ts - extend join-arcade-session
+socket.on('join-arcade-session', async ({ userId, roomId }) => {
+  // Join user's personal room (for multi-tab sync)
+  socket.join(`arcade:${userId}`)
+
+  // If this session is part of a room, also join the game room
+  if (roomId) {
+    socket.join(`game:${roomId}`)
+    console.log(`🎮 User ${userId} joined game room ${roomId}`)
+  }
+
+  // Send current session state...
+})
+```
+
+#### 2. Broadcast to Both Rooms
+
+When processing moves for room-based sessions:
+
+```typescript
+// socket-server.ts - modify game-move handler
+socket.on('game-move', async (data) => {
+  const result = await applyGameMove(data.userId, data.move)
+
+  if (result.success && result.session) {
+    const moveAcceptedData = {
+      gameState: result.session.gameState,
+      version: result.session.version,
+      move: data.move,
+    }
+
+    // Broadcast to user's own tabs (for optimistic update reconciliation)
+    io.to(`arcade:${data.userId}`).emit('move-accepted', moveAcceptedData)
+
+    // If this is a room-based session, ALSO broadcast to all room members
+    if (result.session.roomId) {
+      io.to(`game:${result.session.roomId}`).emit('move-accepted', moveAcceptedData)
+      console.log(`📢 Broadcasted move to room ${result.session.roomId}`)
+    }
+  }
+})
+```
+
+**Why broadcast to both?**
+- `arcade:${userId}` - So the acting user's tabs can reconcile their optimistic updates
+- `game:${roomId}` - So all other users in the room receive the update
+
+#### 3. Client Handles Own vs. Other Moves
+
+The client already handles this correctly via optimistic updates:
+
+```typescript
+// User A (Tab A1) - Makes move
+sendMove({ type: 'FLIP_CARD', ... })
+// → Applies optimistically immediately
+// → Sends to server
+// → Receives move-accepted
+// → Reconciles: removes from pending queue
+
+// User B (Tab B1) - Sees move from User A
+// → Receives move-accepted (unexpected)
+// → Reconciles: clears pending queue, syncs with server state
+// → Result: sees User A's move immediately
+```
+
+The beauty is that `handleMoveAccepted()` already handles both cases:
+- **Own move**: Remove from pending queue
+- **Other's move**: Clear pending queue (since server state is now ahead)
+
+#### 4. Pass roomId in join-arcade-session
+
+Client needs to send roomId when joining:
+
+```typescript
+// hooks/useArcadeSocket.ts
+const joinSession = useCallback((userId: string, roomId?: string) => {
+  if (!socket) return
+  socket.emit('join-arcade-session', { userId, roomId })
+}, [socket])
+
+// hooks/useArcadeSession.ts
+useEffect(() => {
+  if (connected && autoJoin && userId) {
+    // Get roomId from session or room context
+    const roomId = getRoomId() // Need to provide this
+    joinSession(userId, roomId)
+  }
+}, [connected, autoJoin, userId, joinSession])
+```
+
+---
+
+## Implementation Plan
+
+### Phase 1: Server-Side Changes
+
+**File: `socket-server.ts`**
+
+1. ✅ Accept `roomId` in `join-arcade-session` event
+   ```typescript
+   socket.on('join-arcade-session', async ({ userId, roomId }) => {
+     socket.join(`arcade:${userId}`)
+
+     // Join game room if session is room-based
+     if (roomId) {
+       socket.join(`game:${roomId}`)
+     }
+
+     // Rest of logic...
+   })
+   ```
+
+2. ✅ Broadcast to room in `game-move` handler
+   ```typescript
+   if (result.success && result.session) {
+     const moveData = {
+       gameState: result.session.gameState,
+       version: result.session.version,
+       move: data.move,
+     }
+
+     // Broadcast to user's tabs
+     io.to(`arcade:${data.userId}`).emit('move-accepted', moveData)
+
+     // ALSO broadcast to room if room-based session
+     if (result.session.roomId) {
+       io.to(`game:${result.session.roomId}`).emit('move-accepted', moveData)
+     }
+   }
+   ```
+
+3. ✅ Handle room disconnects
+   ```typescript
+   socket.on('disconnect', () => {
+     // Leave all rooms (handled automatically by socket.io)
+     // But log for debugging
+     if (currentUserId && currentRoomId) {
+       console.log(`User ${currentUserId} left game room ${currentRoomId}`)
+     }
+   })
+   ```
+
+### Phase 2: Client-Side Changes
+
+**File: `hooks/useArcadeSocket.ts`**
+
+1. ✅ Add roomId parameter to joinSession
+   ```typescript
+   export interface UseArcadeSocketReturn {
+     // ... existing
+     joinSession: (userId: string, roomId?: string) => void
+   }
+
+   const joinSession = useCallback((userId: string, roomId?: string) => {
+     if (!socket) return
+     socket.emit('join-arcade-session', { userId, roomId })
+   }, [socket])
+   ```
+
+**File: `hooks/useArcadeSession.ts`**
+
+2. ✅ Accept roomId in options
+   ```typescript
+   export interface UseArcadeSessionOptions<TState> {
+     userId: string
+     roomId?: string // NEW
+     initialState: TState
+     applyMove: (state: TState, move: GameMove) => TState
+     // ... rest
+   }
+
+   export function useArcadeSession<TState>(options: UseArcadeSessionOptions<TState>) {
+     const { userId, roomId, ...optimisticOptions } = options
+
+     // Auto-join with roomId
+     useEffect(() => {
+       if (connected && autoJoin && userId) {
+         joinSession(userId, roomId)
+       }
+     }, [connected, autoJoin, userId, roomId, joinSession])
+
+     // ... rest
+   }
+   ```
+
+**File: `app/arcade/matching/context/ArcadeMemoryPairsContext.tsx`**
+
+3. ✅ Get roomId from room data and pass to session
+   ```typescript
+   import { useRoomData } from '@/hooks/useRoomData'
+
+   export function ArcadeMemoryPairsProvider({ children }: { children: ReactNode }) {
+     const { data: viewerId } = useViewerId()
+     const { roomData } = useRoomData()
+
+     // Arcade session integration
+     const { state, sendMove, ... } = useArcadeSession<MemoryPairsState>({
+       userId: viewerId || '',
+       roomId: roomData?.id, // NEW - pass room ID
+       initialState,
+       applyMove: applyMoveOptimistically,
+     })
+
+     // ... rest stays the same
+   }
+   ```
+
+### Phase 3: Testing
+
+1. **Multi-Tab Test (Single User)**
+   - Open `/arcade/room` in 2 tabs as User A
+   - Make move in Tab 1
+   - Verify Tab 2 updates immediately
+
+2. **Multi-User Test (Different Users)**
+   - User A opens `/arcade/room` in 1 tab
+   - User B opens `/arcade/room` in 1 tab (same room)
+   - User A makes move
+   - Verify User B sees move immediately
+
+3. **Multi-User Multi-Tab Test**
+   - User A: 2 tabs (Tab A1, Tab A2)
+   - User B: 2 tabs (Tab B1, Tab B2)
+   - User A makes move in Tab A1
+   - Verify all 4 tabs update
+
+4. **Rapid Move Test**
+   - User A and User B both make moves rapidly
+   - Verify no conflicts
+   - Verify all moves are processed in order
+
+---
+
+## Edge Cases to Handle
+
+### 1. User Leaves Room Mid-Game
+
+**Current behavior:** Session persists, user can rejoin
+
+**Required behavior:**
+- If user leaves room (HTTP POST to `/api/arcade/rooms/[roomId]/leave`):
+  - Delete their session
+  - Emit `session-ended` to their tabs
+  - Other users continue playing
+
+### 2. Version Conflicts
+
+**Already handled** by optimistic locking:
+- Each move increments version
+- Client tracks server version
+- If conflict detected, reconciliation happens automatically
+
+### 3. Session Without Room
+
+**Already handled** by session-manager.ts:
+- Sessions without `roomId` are considered orphaned
+- They're cleaned up on next access (lines 111-115)
+
+### 4. Multiple Users Same Move
+
+**Handled by server validation:**
+- Server processes moves sequentially
+- First valid move wins
+- Second move gets rejected if it's now invalid
+- Client rolls back rejected move
+
+---
+
+## Benefits of This Architecture
+
+1. **Reuses existing optimistic update system**
+   - No changes needed to client-side optimistic logic
+   - Already handles own vs. others' moves
+
+2. **Minimal changes required**
+   - Add `roomId` parameter (3 places)
+   - Add one `io.to()` broadcast (1 place)
+   - Wire up roomId from context (1 place)
+
+3. **Backward compatible**
+   - Non-room sessions still work (roomId is optional)
+   - Solo play unaffected
+
+4. **Scalable**
+   - Socket.io handles multiple rooms efficiently
+   - No N² broadcasting (room-based is O(N))
+
+5. **Already tested pattern**
+   - Multi-tab sync proves the broadcast pattern works
+   - Just extending to more sockets (different users)
+
+---
+
+## Security Considerations
+
+### 1. Validate Room Membership
+
+Before processing moves, verify user is in the room:
+
+```typescript
+// session-manager.ts - in applyGameMove()
+const session = await getArcadeSession(userId)
+
+if (session.roomId) {
+  // Verify user is a member of this room
+  const membership = await getRoomMember(session.roomId, userId)
+  if (!membership) {
+    return { success: false, error: 'User not in room' }
+  }
+}
+```
+
+### 2. Verify Player Ownership
+
+Ensure users can only make moves for their own players:
+
+```typescript
+// Already handled in validator
+// move.playerId must be in session.activePlayers
+// activePlayers are owned by the userId making the move
+```
+
+This is already enforced by how activePlayers are set up in the room.
+
+---
+
+## Performance Considerations
+
+### 1. Broadcasting Overhead
+
+- **Current**: 1 user × N tabs = N broadcasts per move
+- **New**: M users × N tabs each = (M×N) broadcasts per move
+- **Impact**: Linear with room size, not quadratic
+- **Acceptable**: Socket.io is optimized for this
+
+### 2. Database Queries
+
+- No change: Still 1 database write per move
+- Session is stored per-user, not per-room
+- Room data is separate (cached, not updated per move)
+
+### 3. Memory
+
+- Each socket joins 2 rooms instead of 1
+- Negligible: Socket.io uses efficient room data structures
+
+---
+
+## Testing Checklist
+
+### Unit Tests
+
+- [ ] `useArcadeSocket` accepts and passes roomId
+- [ ] `useArcadeSession` accepts and passes roomId
+- [ ] Server joins `game:${roomId}` room when roomId provided
+
+### Integration Tests
+
+- [ ] Single user, 2 tabs: both tabs sync
+- [ ] 2 users, 1 tab each: both users sync
+- [ ] 2 users, 2 tabs each: all 4 tabs sync
+- [ ] User leaves room: session deleted, others continue
+- [ ] Rapid concurrent moves: all processed correctly
+
+### Manual Tests
+
+- [ ] Open room in 2 browsers (different users)
+- [ ] Play full game to completion
+- [ ] Verify scores sync correctly
+- [ ] Verify turn changes sync correctly
+- [ ] Verify game completion syncs correctly
--- a/apps/web/docs/terminology-user-player-room.md
+++ b/apps/web/docs/terminology-user-player-room.md
@@ -0,0 +1,153 @@
+# User vs Player vs Room Member - Terminology Guide
+
+**Critical Distinction**: Users, Players, and Room Members are three different concepts in the system.
+
+## Core Concepts
+
+### 1. **USER** (Identity Layer)
+- **Table**: `users`
+- **Purpose**: Identity - guest or authenticated account
+- **Identified by**: `guestId` (HttpOnly cookie)
+- **Retrieved via**: `useViewerId()` hook
+- **Scope**: One per browser/account
+- **Example**: A person visiting the site
+
+### 2. **PLAYER** (Game Avatar Layer)
+- **Table**: `players`
+- **Purpose**: Game profiles/avatars that represent a participant in the game
+- **Belongs to**: USER (via `userId` FK)
+- **Properties**: name, emoji, color, `isActive`
+- **Scope**: A USER can have MULTIPLE players (e.g., "Alice 👧", "Bob 👦", "Charlie 🧒")
+- **Used in**: All game contexts - both local and online multiplayer
+- **Active Players**: Players where `isActive = true` are the ones currently participating
+
+### 3. **ROOM MEMBER** (Room Participation Layer)
+- **Table**: `room_members`
+- **Purpose**: Tracks a USER's participation in a multiplayer room
+- **Identified by**: `userId` (references the guest/user)
+- **Properties**: `displayName`, `isCreator`, `isOnline`, `joinedAt`
+- **Scope**: One record per USER per room
+
+## How They Work Together
+
+### When a USER joins a room:
+
+1. **Room Member Created**: A `room_members` record is created with the USER's ID
+2. **Active Players Join**: The USER's ACTIVE PLAYERS (where `isActive = true`) participate in the game
+3. **Arcade Session**: The `arcade_sessions.activePlayers` field contains the PLAYER IDs (from `players` table)
+
+### Example Flow:
+
+```
+USER: guest_abc123 (Jane)
+  ├─ PLAYER: player_001 (name: "Alice 👧", isActive: true)
+  ├─ PLAYER: player_002 (name: "Bob 👦", isActive: true)
+  └─ PLAYER: player_003 (name: "Charlie 🧒", isActive: false)
+
+When USER joins ROOM "Math Masters":
+  → ROOM_MEMBER created: {userId: "guest_abc123", displayName: "Jane", roomId: "room_xyz"}
+  → PLAYERS joining game: ["player_001", "player_002"] (only active ones)
+  → ARCADE_SESSION.activePlayers: ["player_001", "player_002"]
+```
+
+### Multi-User Room Example:
+
+```
+ROOM "Math Masters" (room_xyz):
+
+  ROOM_MEMBER 1:
+    userId: guest_abc123 (Jane)
+    └─ PLAYERS in game: ["player_001" (Alice), "player_002" (Bob)]
+
+  ROOM_MEMBER 2:
+    userId: guest_def456 (Mark)
+    └─ PLAYERS in game: ["player_003" (Mario)]
+
+  ROOM_MEMBER 3:
+    userId: guest_ghi789 (Sara)
+    └─ PLAYERS in game: ["player_004" (Luna), "player_005" (Nova), "player_006" (Star)]
+
+Total PLAYERS in this game: 6 players across 3 users
+```
+
+## Database Schema Relationships
+
+```
+users (1) ──< (many) players
+  │
+  └──< (many) room_members
+                 │
+                 └──< belongs to arcade_rooms
+
+arcade_sessions:
+  - userId: references users.id
+  - activePlayers: JSON array of player.id values
+  - roomId: references arcade_rooms.id (null for solo play)
+```
+
+## Implementation Rules
+
+### ✅ Correct Usage
+
+- **Room membership**: Track by USER ID
+- **Game participation**: Track by PLAYER IDs
+- **Presence/online status**: Track by USER ID (room member)
+- **Scores/moves**: Track by PLAYER ID
+- **Room creator**: Track by USER ID
+
+### ❌ Common Mistakes
+
+- ❌ Using USER ID where PLAYER ID is needed
+- ❌ Assuming one USER = one PLAYER
+- ❌ Tracking scores by USER instead of PLAYER
+- ❌ Mixing room_members.displayName with players.name
+
+## API Design Patterns
+
+### When a USER joins a room:
+
+```typescript
+// 1. Add user as room member
+POST /api/arcade/rooms/:roomId/join
+Body: {
+  userId: string        // USER ID (from useViewerId)
+  displayName: string   // Room member display name
+}
+
+// 2. System retrieves user's active players
+const activePlayers = await db.query.players.findMany({
+  where: and(
+    eq(players.userId, userId),
+    eq(players.isActive, true)
+  )
+})
+
+// 3. Game starts with those player IDs
+const session = {
+  userId,
+  activePlayers: activePlayers.map(p => p.id), // PLAYER IDs
+  roomId
+}
+```
+
+### Socket Events
+
+```typescript
+// User joins room (presence)
+socket.emit('join-room', { roomId, userId })
+
+// Player makes a move (game action)
+socket.emit('game-move', {
+  roomId,
+  playerId, // PLAYER ID, not USER ID
+  move
+})
+```
+
+## Summary
+
+- **USER** = Identity/account (one per person)
+- **PLAYER** = Game avatar/profile (multiple per user)
+- **ROOM MEMBER** = USER's participation in a room
+- **When USER joins room** → Their ACTIVE PLAYERS join the game
+- **`activePlayers` field** → Array of PLAYER IDs from `players` table
--- a/apps/web/drizzle/0004_shiny_madelyne_pryor.sql
+++ b/apps/web/drizzle/0004_shiny_madelyne_pryor.sql
@@ -0,0 +1,15 @@
+-- Step 1: Clean up any duplicate room memberships
+-- Keep only the most recent membership for each user (by last_seen timestamp)
+DELETE FROM `room_members`
+WHERE `id` NOT IN (
+  SELECT `id` FROM (
+    SELECT `id`, ROW_NUMBER() OVER (
+      PARTITION BY `user_id`
+      ORDER BY `last_seen` DESC, `joined_at` DESC
+    ) as rn
+    FROM `room_members`
+  ) WHERE rn = 1
+);--> statement-breakpoint
+
+-- Step 2: Add unique constraint to enforce one room per user
+CREATE UNIQUE INDEX `idx_room_members_user_id_unique` ON `room_members` (`user_id`);
--- a/apps/web/drizzle/meta/0000_snapshot.json
+++ b/apps/web/drizzle/meta/0000_snapshot.json
@@ -53,16 +53,12 @@
      "indexes": {
        "users_guest_id_unique": {
          "name": "users_guest_id_unique",
-          "columns": [
-            "guest_id"
-          ],
+          "columns": ["guest_id"],
          "isUnique": true
        },
        "users_email_unique": {
          "name": "users_email_unique",
-          "columns": [
-            "email"
-          ],
+          "columns": ["email"],
          "isUnique": true
        }
      },
@@ -128,9 +124,7 @@
      "indexes": {
        "players_user_id_idx": {
          "name": "players_user_id_idx",
-          "columns": [
-            "user_id"
-          ],
+          "columns": ["user_id"],
          "isUnique": false
        }
      },
@@ -139,12 +133,8 @@
          "name": "players_user_id_users_id_fk",
          "tableFrom": "players",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -208,12 +198,8 @@
          "name": "user_stats_user_id_users_id_fk",
          "tableFrom": "user_stats",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -233,4 +219,4 @@
  "internal": {
    "indexes": {}
  }
-}
+}
--- a/apps/web/drizzle/meta/0001_snapshot.json
+++ b/apps/web/drizzle/meta/0001_snapshot.json
@@ -53,16 +53,12 @@
      "indexes": {
        "users_guest_id_unique": {
          "name": "users_guest_id_unique",
-          "columns": [
-            "guest_id"
-          ],
+          "columns": ["guest_id"],
          "isUnique": true
        },
        "users_email_unique": {
          "name": "users_email_unique",
-          "columns": [
-            "email"
-          ],
+          "columns": ["email"],
          "isUnique": true
        }
      },
@@ -128,9 +124,7 @@
      "indexes": {
        "players_user_id_idx": {
          "name": "players_user_id_idx",
-          "columns": [
-            "user_id"
-          ],
+          "columns": ["user_id"],
          "isUnique": false
        }
      },
@@ -139,12 +133,8 @@
          "name": "players_user_id_users_id_fk",
          "tableFrom": "players",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -208,12 +198,8 @@
          "name": "user_stats_user_id_users_id_fk",
          "tableFrom": "user_stats",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -335,12 +321,8 @@
          "name": "abacus_settings_user_id_users_id_fk",
          "tableFrom": "abacus_settings",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -360,4 +342,4 @@
  "internal": {
    "indexes": {}
  }
-}
+}
--- a/apps/web/drizzle/meta/0002_snapshot.json
+++ b/apps/web/drizzle/meta/0002_snapshot.json
@@ -53,16 +53,12 @@
      "indexes": {
        "users_guest_id_unique": {
          "name": "users_guest_id_unique",
-          "columns": [
-            "guest_id"
-          ],
+          "columns": ["guest_id"],
          "isUnique": true
        },
        "users_email_unique": {
          "name": "users_email_unique",
-          "columns": [
-            "email"
-          ],
+          "columns": ["email"],
          "isUnique": true
        }
      },
@@ -128,9 +124,7 @@
      "indexes": {
        "players_user_id_idx": {
          "name": "players_user_id_idx",
-          "columns": [
-            "user_id"
-          ],
+          "columns": ["user_id"],
          "isUnique": false
        }
      },
@@ -139,12 +133,8 @@
          "name": "players_user_id_users_id_fk",
          "tableFrom": "players",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -208,12 +198,8 @@
          "name": "user_stats_user_id_users_id_fk",
          "tableFrom": "user_stats",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -335,12 +321,8 @@
          "name": "abacus_settings_user_id_users_id_fk",
          "tableFrom": "abacus_settings",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -431,12 +413,8 @@
          "name": "arcade_sessions_user_id_users_id_fk",
          "tableFrom": "arcade_sessions",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -456,4 +434,4 @@
  "internal": {
    "indexes": {}
  }
-}
+}
--- a/apps/web/drizzle/meta/0003_snapshot.json
+++ b/apps/web/drizzle/meta/0003_snapshot.json
@@ -53,16 +53,12 @@
      "indexes": {
        "users_guest_id_unique": {
          "name": "users_guest_id_unique",
-          "columns": [
-            "guest_id"
-          ],
+          "columns": ["guest_id"],
          "isUnique": true
        },
        "users_email_unique": {
          "name": "users_email_unique",
-          "columns": [
-            "email"
-          ],
+          "columns": ["email"],
          "isUnique": true
        }
      },
@@ -128,9 +124,7 @@
      "indexes": {
        "players_user_id_idx": {
          "name": "players_user_id_idx",
-          "columns": [
-            "user_id"
-          ],
+          "columns": ["user_id"],
          "isUnique": false
        }
      },
@@ -139,12 +133,8 @@
          "name": "players_user_id_users_id_fk",
          "tableFrom": "players",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -208,12 +198,8 @@
          "name": "user_stats_user_id_users_id_fk",
          "tableFrom": "user_stats",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -335,12 +321,8 @@
          "name": "abacus_settings_user_id_users_id_fk",
          "tableFrom": "abacus_settings",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -458,9 +440,7 @@
      "indexes": {
        "arcade_rooms_code_unique": {
          "name": "arcade_rooms_code_unique",
-          "columns": [
-            "code"
-          ],
+          "columns": ["code"],
          "isUnique": true
        }
      },
@@ -537,12 +517,8 @@
          "name": "room_members_room_id_arcade_rooms_id_fk",
          "tableFrom": "room_members",
          "tableTo": "arcade_rooms",
-          "columnsFrom": [
-            "room_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["room_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        }
@@ -640,12 +616,8 @@
          "name": "arcade_sessions_user_id_users_id_fk",
          "tableFrom": "arcade_sessions",
          "tableTo": "users",
-          "columnsFrom": [
-            "user_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
          "onDelete": "cascade",
          "onUpdate": "no action"
        },
@@ -653,12 +625,8 @@
          "name": "arcade_sessions_room_id_arcade_rooms_id_fk",
          "tableFrom": "arcade_sessions",
          "tableTo": "arcade_rooms",
-          "columnsFrom": [
-            "room_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
+          "columnsFrom": ["room_id"],
+          "columnsTo": ["id"],
          "onDelete": "set null",
          "onUpdate": "no action"
        }
@@ -678,4 +646,4 @@
  "internal": {
    "indexes": {}
  }
-}
+}
--- a/apps/web/drizzle/meta/0004_snapshot.json
+++ b/apps/web/drizzle/meta/0004_snapshot.json
@@ -0,0 +1,660 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "cbd94d51-1454-467c-a471-ccbfca886a1a",
+  "prevId": "68cc273f-0d84-4a46-ae41-124a3e06096b",
+  "tables": {
+    "abacus_settings": {
+      "name": "abacus_settings",
+      "columns": {
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "color_scheme": {
+          "name": "color_scheme",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'place-value'"
+        },
+        "bead_shape": {
+          "name": "bead_shape",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'diamond'"
+        },
+        "color_palette": {
+          "name": "color_palette",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'default'"
+        },
+        "hide_inactive_beads": {
+          "name": "hide_inactive_beads",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "colored_numerals": {
+          "name": "colored_numerals",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "scale_factor": {
+          "name": "scale_factor",
+          "type": "real",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 1
+        },
+        "show_numbers": {
+          "name": "show_numbers",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "animated": {
+          "name": "animated",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "interactive": {
+          "name": "interactive",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "gestures": {
+          "name": "gestures",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "sound_enabled": {
+          "name": "sound_enabled",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "sound_volume": {
+          "name": "sound_volume",
+          "type": "real",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0.8
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "abacus_settings_user_id_users_id_fk": {
+          "name": "abacus_settings_user_id_users_id_fk",
+          "tableFrom": "abacus_settings",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "arcade_rooms": {
+      "name": "arcade_rooms",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "code": {
+          "name": "code",
+          "type": "text(6)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "creator_name": {
+          "name": "creator_name",
+          "type": "text(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_activity": {
+          "name": "last_activity",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "ttl_minutes": {
+          "name": "ttl_minutes",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 60
+        },
+        "is_locked": {
+          "name": "is_locked",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "game_name": {
+          "name": "game_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "game_config": {
+          "name": "game_config",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'lobby'"
+        },
+        "current_session_id": {
+          "name": "current_session_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "total_games_played": {
+          "name": "total_games_played",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        }
+      },
+      "indexes": {
+        "arcade_rooms_code_unique": {
+          "name": "arcade_rooms_code_unique",
+          "columns": ["code"],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "arcade_sessions": {
+      "name": "arcade_sessions",
+      "columns": {
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "current_game": {
+          "name": "current_game",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "game_url": {
+          "name": "game_url",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "game_state": {
+          "name": "game_state",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "active_players": {
+          "name": "active_players",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "room_id": {
+          "name": "room_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "started_at": {
+          "name": "started_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_activity_at": {
+          "name": "last_activity_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "expires_at": {
+          "name": "expires_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_active": {
+          "name": "is_active",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        },
+        "version": {
+          "name": "version",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 1
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "arcade_sessions_user_id_users_id_fk": {
+          "name": "arcade_sessions_user_id_users_id_fk",
+          "tableFrom": "arcade_sessions",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "arcade_sessions_room_id_arcade_rooms_id_fk": {
+          "name": "arcade_sessions_room_id_arcade_rooms_id_fk",
+          "tableFrom": "arcade_sessions",
+          "tableTo": "arcade_rooms",
+          "columnsFrom": ["room_id"],
+          "columnsTo": ["id"],
+          "onDelete": "set null",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "players": {
+      "name": "players",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "emoji": {
+          "name": "emoji",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "color": {
+          "name": "color",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_active": {
+          "name": "is_active",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "players_user_id_idx": {
+          "name": "players_user_id_idx",
+          "columns": ["user_id"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "players_user_id_users_id_fk": {
+          "name": "players_user_id_users_id_fk",
+          "tableFrom": "players",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "room_members": {
+      "name": "room_members",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "room_id": {
+          "name": "room_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "display_name": {
+          "name": "display_name",
+          "type": "text(50)",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_creator": {
+          "name": "is_creator",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "joined_at": {
+          "name": "joined_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_seen": {
+          "name": "last_seen",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_online": {
+          "name": "is_online",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": true
+        }
+      },
+      "indexes": {
+        "room_members_user_id_unique": {
+          "name": "room_members_user_id_unique",
+          "columns": ["user_id"],
+          "isUnique": true
+        },
+        "idx_room_members_user_id_unique": {
+          "name": "idx_room_members_user_id_unique",
+          "columns": ["user_id"],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {
+        "room_members_room_id_arcade_rooms_id_fk": {
+          "name": "room_members_room_id_arcade_rooms_id_fk",
+          "tableFrom": "room_members",
+          "tableTo": "arcade_rooms",
+          "columnsFrom": ["room_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "user_stats": {
+      "name": "user_stats",
+      "columns": {
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "games_played": {
+          "name": "games_played",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "total_wins": {
+          "name": "total_wins",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "favorite_game_type": {
+          "name": "favorite_game_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "best_time": {
+          "name": "best_time",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "highest_accuracy": {
+          "name": "highest_accuracy",
+          "type": "real",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "user_stats_user_id_users_id_fk": {
+          "name": "user_stats_user_id_users_id_fk",
+          "tableFrom": "user_stats",
+          "tableTo": "users",
+          "columnsFrom": ["user_id"],
+          "columnsTo": ["id"],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "users": {
+      "name": "users",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "guest_id": {
+          "name": "guest_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "upgraded_at": {
+          "name": "upgraded_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "email": {
+          "name": "email",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "users_guest_id_unique": {
+          "name": "users_guest_id_unique",
+          "columns": ["guest_id"],
+          "isUnique": true
+        },
+        "users_email_unique": {
+          "name": "users_email_unique",
+          "columns": ["email"],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}
--- a/apps/web/drizzle/meta/_journal.json
+++ b/apps/web/drizzle/meta/_journal.json
@@ -29,6 +29,13 @@
      "when": 1759781243105,
      "tag": "0003_naive_reptil",
      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "6",
+      "when": 1759930182541,
+      "tag": "0004_shiny_madelyne_pryor",
+      "breakpoints": true
    }
  ]
-}
+}
--- a/apps/web/e2e/arcade-modal-session.spec.ts
+++ b/apps/web/e2e/arcade-modal-session.spec.ts
@@ -1,4 +1,4 @@
-import { test, expect } from '@playwright/test'
+import { expect, test } from '@playwright/test'

 /**
 * Arcade Modal Session E2E Tests
@@ -77,7 +77,12 @@ test.describe('Arcade Modal Session - Redirects', () => {

    // Activate a player
    const addPlayerButton = page.locator('button:has-text("Add Player"), button:has-text("+")')
-    if (await addPlayerButton.first().isVisible({ timeout: 2000 }).catch(() => false)) {
+    if (
+      await addPlayerButton
+        .first()
+        .isVisible({ timeout: 2000 })
+        .catch(() => false)
+    ) {
      await addPlayerButton.first().click()
      await page.waitForTimeout(500)
    }
@@ -226,7 +231,9 @@ test.describe('Arcade Modal Session - Return to Arcade Button', () => {
    await page.waitForLoadState('networkidle')
  })

-  test('should end session and return to arcade when clicking "Return to Arcade"', async ({ page }) => {
+  test('should end session and return to arcade when clicking "Return to Arcade"', async ({
+    page,
+  }) => {
    // Start a game
    await page.goto('/arcade/matching')
    await page.waitForLoadState('networkidle')
@@ -253,7 +260,12 @@ test.describe('Arcade Modal Session - Return to Arcade Button', () => {

      // Now should be able to modify players again
      const addPlayerButton = page.locator('button:has-text("Add Player"), button:has-text("+")')
-      if (await addPlayerButton.first().isVisible({ timeout: 2000 }).catch(() => false)) {
+      if (
+        await addPlayerButton
+          .first()
+          .isVisible({ timeout: 2000 })
+          .catch(() => false)
+      ) {
        await expect(addPlayerButton.first()).toBeEnabled()
      }
    }
@@ -265,8 +277,15 @@ test.describe('Arcade Modal Session - Return to Arcade Button', () => {
    await page.waitForLoadState('networkidle')

    // Return to arcade
-    const returnButton = page.locator('button:has-text("Return to Arcade"), button:has-text("Setup")')
-    if (await returnButton.first().isVisible({ timeout: 2000 }).catch(() => false)) {
+    const returnButton = page.locator(
+      'button:has-text("Return to Arcade"), button:has-text("Setup")'
+    )
+    if (
+      await returnButton
+        .first()
+        .isVisible({ timeout: 2000 })
+        .catch(() => false)
+    ) {
      await returnButton.first().click()
      await page.waitForTimeout(1000)
    }
--- a/apps/web/e2e/mini-nav-persistence.spec.ts
+++ b/apps/web/e2e/mini-nav-persistence.spec.ts
@@ -1,7 +1,9 @@
-import { test, expect } from '@playwright/test'
+import { expect, test } from '@playwright/test'

 test.describe('Mini Navigation Game Name Persistence', () => {
-  test('should not show game name when navigating back to games page from a specific game', async ({ page }) => {
+  test('should not show game name when navigating back to games page from a specific game', async ({
+    page,
+  }) => {
    // Override baseURL for this test to match running dev server
    const baseURL = 'http://localhost:3000'

@@ -73,7 +75,9 @@ test.describe('Mini Navigation Game Name Persistence', () => {
    await expect(page.locator('text=🧠 Memory Lightning')).not.toBeVisible()
  })

-  test('should not persist game name when navigating through intermediate pages', async ({ page }) => {
+  test('should not persist game name when navigating through intermediate pages', async ({
+    page,
+  }) => {
    // Override baseURL for this test to match running dev server
    const baseURL = 'http://localhost:3000'

@@ -108,4 +112,4 @@ test.describe('Mini Navigation Game Name Persistence', () => {
    await expect(memoryLightningName).not.toBeVisible()
    await expect(memoryPairsName).not.toBeVisible()
  })
-})
+})
--- a/apps/web/e2e/nav-slot.spec.ts
+++ b/apps/web/e2e/nav-slot.spec.ts
@@ -1,7 +1,9 @@
-import { test, expect } from '@playwright/test'
+import { expect, test } from '@playwright/test'

 test.describe('Game navigation slots', () => {
-  test('should show Memory Pairs game name in nav when navigating to matching game', async ({ page }) => {
+  test('should show Memory Pairs game name in nav when navigating to matching game', async ({
+    page,
+  }) => {
    await page.goto('/games/matching')

    // Wait for the page to load
@@ -13,7 +15,9 @@ test.describe('Game navigation slots', () => {
    await expect(gameNav).toContainText('Memory Pairs')
  })

-  test('should show Memory Lightning game name in nav when navigating to memory quiz', async ({ page }) => {
+  test('should show Memory Lightning game name in nav when navigating to memory quiz', async ({
+    page,
+  }) => {
    await page.goto('/games/memory-quiz')

    // Wait for the page to load
@@ -70,4 +74,4 @@ test.describe('Game navigation slots', () => {
    const gameNavs = page.locator('h1:has-text("Memory Pairs"), h1:has-text("Memory Lightning")')
    await expect(gameNavs).toHaveCount(0)
  })
-})
+})
--- a/apps/web/e2e/sound-settings-persistence.spec.ts
+++ b/apps/web/e2e/sound-settings-persistence.spec.ts
@@ -1,4 +1,4 @@
-import { test, expect } from '@playwright/test'
+import { expect, test } from '@playwright/test'

 test.describe('Sound Settings Persistence', () => {
  test.beforeEach(async ({ page }) => {
@@ -14,13 +14,13 @@ test.describe('Sound Settings Persistence', () => {
    await page.getByRole('button', { name: /style/i }).click()

    // Find and toggle the sound switch (should be off by default)
-    const soundSwitch = page.locator('[role="switch"]').filter({ hasText: /sound/i }).or(
-      page.locator('input[type="checkbox"]').filter({ hasText: /sound/i })
-    ).or(
-      page.getByLabel(/sound/i)
-    ).or(
-      page.locator('button').filter({ hasText: /sound/i })
-    ).first()
+    const soundSwitch = page
+      .locator('[role="switch"]')
+      .filter({ hasText: /sound/i })
+      .or(page.locator('input[type="checkbox"]').filter({ hasText: /sound/i }))
+      .or(page.getByLabel(/sound/i))
+      .or(page.locator('button').filter({ hasText: /sound/i }))
+      .first()

    await soundSwitch.click()

@@ -37,13 +37,13 @@ test.describe('Sound Settings Persistence', () => {
    await page.reload()
    await page.getByRole('button', { name: /style/i }).click()

-    const soundSwitchAfterReload = page.locator('[role="switch"]').filter({ hasText: /sound/i }).or(
-      page.locator('input[type="checkbox"]').filter({ hasText: /sound/i })
-    ).or(
-      page.getByLabel(/sound/i)
-    ).or(
-      page.locator('button').filter({ hasText: /sound/i })
-    ).first()
+    const soundSwitchAfterReload = page
+      .locator('[role="switch"]')
+      .filter({ hasText: /sound/i })
+      .or(page.locator('input[type="checkbox"]').filter({ hasText: /sound/i }))
+      .or(page.getByLabel(/sound/i))
+      .or(page.locator('button').filter({ hasText: /sound/i }))
+      .first()

    await expect(soundSwitchAfterReload).toBeChecked()
  })
@@ -55,9 +55,10 @@ test.describe('Sound Settings Persistence', () => {
    await page.getByRole('button', { name: /style/i }).click()

    // Find volume slider
-    const volumeSlider = page.locator('input[type="range"]').or(
-      page.locator('[role="slider"]')
-    ).first()
+    const volumeSlider = page
+      .locator('input[type="range"]')
+      .or(page.locator('[role="slider"]'))
+      .first()

    // Set volume to a specific value (e.g., 0.6)
    await volumeSlider.fill('60') // Assuming 0-100 range
@@ -75,9 +76,10 @@ test.describe('Sound Settings Persistence', () => {
    await page.reload()
    await page.getByRole('button', { name: /style/i }).click()

-    const volumeSliderAfterReload = page.locator('input[type="range"]').or(
-      page.locator('[role="slider"]')
-    ).first()
+    const volumeSliderAfterReload = page
+      .locator('input[type="range"]')
+      .or(page.locator('[role="slider"]'))
+      .first()

    const volumeValue = await volumeSliderAfterReload.inputValue()
    expect(parseFloat(volumeValue)).toBeCloseTo(60, 0) // Allow for some variance
@@ -116,4 +118,4 @@ test.describe('Sound Settings Persistence', () => {
    expect(storedConfig.soundEnabled).toBe(true)
    expect(storedConfig.soundVolume).toBe(0.8)
  })
-})
+})
--- a/apps/web/eslint.config.js
+++ b/apps/web/eslint.config.js
@@ -0,0 +1,42 @@
+// Minimal ESLint flat config ONLY for react-hooks rules
+
+import tsParser from '@typescript-eslint/parser'
+import reactHooks from 'eslint-plugin-react-hooks'
+
+const config = [
+  { ignores: ['dist', '.next', 'coverage', 'node_modules', 'styled-system', 'storybook-static'] },
+  {
+    files: ['**/*.tsx', '**/*.ts', '**/*.jsx', '**/*.js'],
+    languageOptions: {
+      parser: tsParser,
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        React: 'readonly',
+        JSX: 'readonly',
+        console: 'readonly',
+        process: 'readonly',
+        module: 'readonly',
+        require: 'readonly',
+        window: 'readonly',
+        document: 'readonly',
+        localStorage: 'readonly',
+        sessionStorage: 'readonly',
+        fetch: 'readonly',
+        global: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+      },
+    },
+    plugins: {
+      'react-hooks': reactHooks,
+    },
+    rules: {
+      'react-hooks/rules-of-hooks': 'error',
+      'react-hooks/exhaustive-deps': 'off',
+    },
+  },
+]
+
+export default config
--- a/apps/web/next.config.js
+++ b/apps/web/next.config.js
@@ -1,6 +1,5 @@
 /** @type {import('next').NextConfig} */
 const nextConfig = {
-  output: 'standalone',
  eslint: {
    ignoreDuringBuilds: true,
  },
@@ -64,4 +63,4 @@ const nextConfig = {
  },
 }

-module.exports = nextConfig
+module.exports = nextConfig
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -3,10 +3,15 @@
  "version": "0.1.0",
  "private": true,
  "scripts": {
-    "dev": "concurrently \"node server.js\" \"npx @pandacss/dev --watch\"",
-    "build": "node scripts/generate-build-info.js && next build",
+    "dev": "tsc -p tsconfig.server.json && tsc-alias -p tsconfig.server.json && concurrently \"node server.js\" \"npx @pandacss/dev --watch\"",
+    "build": "node scripts/generate-build-info.js && tsc -p tsconfig.server.json && tsc-alias -p tsconfig.server.json && next build",
    "start": "NODE_ENV=production node server.js",
-    "lint": "next lint",
+    "lint": "npx @biomejs/biome lint . && npx eslint .",
+    "lint:fix": "npx @biomejs/biome lint . --write && npx eslint . --fix",
+    "format": "npx @biomejs/biome format . --write",
+    "format:check": "npx @biomejs/biome format .",
+    "check": "npx @biomejs/biome check .",
+    "pre-commit": "npm run type-check && npm run format && npm run lint:fix && npm run lint",
    "test": "vitest",
    "test:run": "vitest run",
    "type-check": "tsc --noEmit",
@@ -85,6 +90,7 @@
    "happy-dom": "^18.0.1",
    "jsdom": "^27.0.0",
    "storybook": "^9.1.7",
+    "tsc-alias": "^1.8.16",
    "tsx": "^4.20.5",
    "typescript": "^5.0.0",
    "vitest": "^1.0.0"
--- a/apps/web/panda.config.ts
+++ b/apps/web/panda.config.ts
@@ -36,17 +36,23 @@ export default defineConfig({
            wood: { value: '#8B4513' },
            bead: { value: '#2C1810' },
            inactive: { value: '#D3D3D3' },
-            bar: { value: '#654321' }
-          }
+            bar: { value: '#654321' },
+          },
        },
        fonts: {
-          body: { value: 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif' },
-          heading: { value: 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif' },
-          mono: { value: 'Monaco, "Cascadia Code", "Roboto Mono", Consolas, "Courier New", monospace' }
+          body: {
+            value: 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+          },
+          heading: {
+            value: 'Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+          },
+          mono: {
+            value: 'Monaco, "Cascadia Code", "Roboto Mono", Consolas, "Courier New", monospace',
+          },
        },
        shadows: {
          card: { value: '0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06)' },
-          modal: { value: '0 25px 50px -12px rgba(0, 0, 0, 0.25)' }
+          modal: { value: '0 25px 50px -12px rgba(0, 0, 0, 0.25)' },
        },
        animations: {
          // Shake animation for errors (web_generator.py line 3419)
@@ -60,49 +66,51 @@ export default defineConfig({
          bounce: { value: 'bounce 1s infinite alternate' },
          bounceIn: { value: 'bounceIn 1s ease-out' },
          // Glow animation (line 6260)
-          glow: { value: 'glow 1s ease-in-out infinite alternate' }
-        }
+          glow: { value: 'glow 1s ease-in-out infinite alternate' },
+        },
      },
      keyframes: {
        // Shake - horizontal oscillation for errors (line 3419)
        shake: {
          '0%, 100%': { transform: 'translateX(0)' },
          '25%': { transform: 'translateX(-5px)' },
-          '75%': { transform: 'translateX(5px)' }
+          '75%': { transform: 'translateX(5px)' },
        },
        // Success pulse - gentle scale for correct answers (line 2004)
        successPulse: {
          '0%, 100%': { transform: 'scale(1)' },
-          '50%': { transform: 'scale(1.05)' }
+          '50%': { transform: 'scale(1.05)' },
        },
        // Pulse - continuous breathing effect (line 6255)
        pulse: {
          '0%, 100%': { transform: 'scale(1)' },
-          '50%': { transform: 'scale(1.05)' }
+          '50%': { transform: 'scale(1.05)' },
        },
        // Error shake - stronger horizontal oscillation (line 2009)
        errorShake: {
          '0%, 100%': { transform: 'translateX(0)' },
          '25%': { transform: 'translateX(-10px)' },
-          '75%': { transform: 'translateX(10px)' }
+          '75%': { transform: 'translateX(10px)' },
        },
        // Bounce - vertical oscillation (line 6271)
        bounce: {
          '0%, 100%': { transform: 'translateY(0)' },
-          '50%': { transform: 'translateY(-10px)' }
+          '50%': { transform: 'translateY(-10px)' },
        },
        // Bounce in - entry animation with scale and rotate (line 6265)
        bounceIn: {
          '0%': { transform: 'scale(0.3) rotate(-10deg)', opacity: '0' },
          '50%': { transform: 'scale(1.1) rotate(5deg)' },
-          '100%': { transform: 'scale(1) rotate(0deg)', opacity: '1' }
+          '100%': { transform: 'scale(1) rotate(0deg)', opacity: '1' },
        },
        // Glow - expanding box shadow (line 6260)
        glow: {
          '0%': { boxShadow: '0 0 5px rgba(255, 255, 255, 0.5)' },
-          '100%': { boxShadow: '0 0 20px rgba(255, 255, 255, 0.8), 0 0 30px rgba(255, 255, 255, 0.6)' }
-        }
-      }
-    }
-  }
-})
+          '100%': {
+            boxShadow: '0 0 20px rgba(255, 255, 255, 0.8), 0 0 30px rgba(255, 255, 255, 0.6)',
+          },
+        },
+      },
+    },
+  },
+})
--- a/apps/web/playwright.config.ts
+++ b/apps/web/playwright.config.ts
@@ -24,4 +24,4 @@ export default defineConfig({
    url: 'http://localhost:3002',
    reuseExistingServer: !process.env.CI,
  },
-})
+})
--- a/apps/web/pnpm-lock.yaml
+++ b/apps/web/pnpm-lock.yaml
@@ -0,0 +1,445 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      '@radix-ui/react-tooltip':
+        specifier: ^1.2.8
+        version: 1.2.8(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@soroban/abacus-react':
+        specifier: workspace:*
+        version: link:../../packages/abacus-react
+      '@soroban/client':
+        specifier: workspace:*
+        version: link:../../packages/core/client/typescript
+      '@soroban/core':
+        specifier: workspace:*
+        version: link:../../packages/core/client/node
+      '@soroban/templates':
+        specifier: workspace:*
+        version: link:../../packages/templates
+      react:
+        specifier: ^18.2.0
+        version: 18.3.1
+      react-dom:
+        specifier: ^18.2.0
+        version: 18.3.1(react@18.3.1)
+
+packages:
+
+  '@floating-ui/core@1.7.3':
+    resolution: {integrity: sha512-sGnvb5dmrJaKEZ+LDIpguvdX3bDlEllmv4/ClQ9awcmCZrlx5jQyyMWFM5kBI+EyNOCDDiKk8il0zeuX3Zlg/w==}
+
+  '@floating-ui/dom@1.7.4':
+    resolution: {integrity: sha512-OOchDgh4F2CchOX94cRVqhvy7b3AFb+/rQXyswmzmGakRfkMgoWVjfnLWkRirfLEfuD4ysVW16eXzwt3jHIzKA==}
+
+  '@floating-ui/react-dom@2.1.6':
+    resolution: {integrity: sha512-4JX6rEatQEvlmgU80wZyq9RT96HZJa88q8hp0pBd+LrczeDI4o6uA2M+uvxngVHo4Ihr8uibXxH6+70zhAFrVw==}
+    peerDependencies:
+      react: '>=16.8.0'
+      react-dom: '>=16.8.0'
+
+  '@floating-ui/utils@0.2.10':
+    resolution: {integrity: sha512-aGTxbpbg8/b5JfU1HXSrbH3wXZuLPJcNEcZQFMxLs3oSzgtVu6nFPkbbGGUvBcUjKV2YyB9Wxxabo+HEH9tcRQ==}
+
+  '@radix-ui/primitive@1.1.3':
+    resolution: {integrity: sha512-JTF99U/6XIjCBo0wqkU5sK10glYe27MRRsfwoiq5zzOEZLHU3A3KCMa5X/azekYRCJ0HlwI0crAXS/5dEHTzDg==}
+
+  '@radix-ui/react-arrow@1.1.7':
+    resolution: {integrity: sha512-F+M1tLhO+mlQaOWspE8Wstg+z6PwxwRd8oQ8IXceWz92kfAmalTRf0EjrouQeo7QssEPfCn05B4Ihs1K9WQ/7w==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/react-compose-refs@1.1.2':
+    resolution: {integrity: sha512-z4eqJvfiNnFMHIIvXP3CY57y2WJs5g2v3X0zm9mEJkrkNv4rDxu+sg9Jh8EkXyeqBkB7SOcboo9dMVqhyrACIg==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-context@1.1.2':
+    resolution: {integrity: sha512-jCi/QKUM2r1Ju5a3J64TH2A5SpKAgh0LpknyqdQ4m6DCV0xJ2HG1xARRwNGPQfi1SLdLWZ1OJz6F4OMBBNiGJA==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-dismissable-layer@1.1.11':
+    resolution: {integrity: sha512-Nqcp+t5cTB8BinFkZgXiMJniQH0PsUt2k51FUhbdfeKvc4ACcG2uQniY/8+h1Yv6Kza4Q7lD7PQV0z0oicE0Mg==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/react-id@1.1.1':
+    resolution: {integrity: sha512-kGkGegYIdQsOb4XjsfM97rXsiHaBwco+hFI66oO4s9LU+PLAC5oJ7khdOVFxkhsmlbpUqDAvXw11CluXP+jkHg==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-popper@1.2.8':
+    resolution: {integrity: sha512-0NJQ4LFFUuWkE7Oxf0htBKS6zLkkjBH+hM1uk7Ng705ReR8m/uelduy1DBo0PyBXPKVnBA6YBlU94MBGXrSBCw==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/react-portal@1.1.9':
+    resolution: {integrity: sha512-bpIxvq03if6UNwXZ+HTK71JLh4APvnXntDc6XOX8UVq4XQOVl7lwok0AvIl+b8zgCw3fSaVTZMpAPPagXbKmHQ==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/react-presence@1.1.5':
+    resolution: {integrity: sha512-/jfEwNDdQVBCNvjkGit4h6pMOzq8bHkopq458dPt2lMjx+eBQUohZNG9A7DtO/O5ukSbxuaNGXMjHicgwy6rQQ==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/react-primitive@2.1.3':
+    resolution: {integrity: sha512-m9gTwRkhy2lvCPe6QJp4d3G1TYEUHn/FzJUtq9MjH46an1wJU+GdoGC5VLof8RX8Ft/DlpshApkhswDLZzHIcQ==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/react-slot@1.2.3':
+    resolution: {integrity: sha512-aeNmHnBxbi2St0au6VBVC7JXFlhLlOnvIIlePNniyUNAClzmtAUEY8/pBiK3iHjufOlwA+c20/8jngo7xcrg8A==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-tooltip@1.2.8':
+    resolution: {integrity: sha512-tY7sVt1yL9ozIxvmbtN5qtmH2krXcBCfjEiCgKGLqunJHvgvZG2Pcl2oQ3kbcZARb1BGEHdkLzcYGO8ynVlieg==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/react-use-callback-ref@1.1.1':
+    resolution: {integrity: sha512-FkBMwD+qbGQeMu1cOHnuGB6x4yzPjho8ap5WtbEJ26umhgqVXbhekKUQO+hZEL1vU92a3wHwdp0HAcqAUF5iDg==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-use-controllable-state@1.2.2':
+    resolution: {integrity: sha512-BjasUjixPFdS+NKkypcyyN5Pmg83Olst0+c6vGov0diwTEo6mgdqVR6hxcEgFuh4QrAs7Rc+9KuGJ9TVCj0Zzg==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-use-effect-event@0.0.2':
+    resolution: {integrity: sha512-Qp8WbZOBe+blgpuUT+lw2xheLP8q0oatc9UpmiemEICxGvFLYmHm9QowVZGHtJlGbS6A6yJ3iViad/2cVjnOiA==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-use-escape-keydown@1.1.1':
+    resolution: {integrity: sha512-Il0+boE7w/XebUHyBjroE+DbByORGR9KKmITzbR7MyQ4akpORYP/ZmbhAr0DG7RmmBqoOnZdy2QlvajJ2QA59g==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-use-layout-effect@1.1.1':
+    resolution: {integrity: sha512-RbJRS4UWQFkzHTTwVymMTUv8EqYhOp8dOOviLj2ugtTiXRaRQS7GLGxZTLL1jWhMeoSCf5zmcZkqTl9IiYfXcQ==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-use-rect@1.1.1':
+    resolution: {integrity: sha512-QTYuDesS0VtuHNNvMh+CjlKJ4LJickCMUAqjlE3+j8w+RlRpwyX3apEQKGFzbZGdo7XNG1tXa+bQqIE7HIXT2w==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-use-size@1.1.1':
+    resolution: {integrity: sha512-ewrXRDTAqAXlkl6t/fkXWNAhFX9I+CkKlw6zjEwk86RSPKwZr3xpBRso655aqYafwtnbpHLj6toFzmd6xdVptQ==}
+    peerDependencies:
+      '@types/react': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+
+  '@radix-ui/react-visually-hidden@1.2.3':
+    resolution: {integrity: sha512-pzJq12tEaaIhqjbzpCuv/OypJY/BPavOofm+dbab+MHLajy277+1lLm6JFcGgF5eskJ6mquGirhXY2GD/8u8Ug==}
+    peerDependencies:
+      '@types/react': '*'
+      '@types/react-dom': '*'
+      react: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+      react-dom: ^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      '@types/react-dom':
+        optional: true
+
+  '@radix-ui/rect@1.1.1':
+    resolution: {integrity: sha512-HPwpGIzkl28mWyZqG52jiqDJ12waP11Pa1lGoiyUkIEuMLBP0oeK/C89esbXrxsky5we7dfd8U58nm0SgAWpVw==}
+
+  js-tokens@4.0.0:
+    resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==}
+
+  loose-envify@1.4.0:
+    resolution: {integrity: sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==}
+    hasBin: true
+
+  react-dom@18.3.1:
+    resolution: {integrity: sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==}
+    peerDependencies:
+      react: ^18.3.1
+
+  react@18.3.1:
+    resolution: {integrity: sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==}
+    engines: {node: '>=0.10.0'}
+
+  scheduler@0.23.2:
+    resolution: {integrity: sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==}
+
+snapshots:
+
+  '@floating-ui/core@1.7.3':
+    dependencies:
+      '@floating-ui/utils': 0.2.10
+
+  '@floating-ui/dom@1.7.4':
+    dependencies:
+      '@floating-ui/core': 1.7.3
+      '@floating-ui/utils': 0.2.10
+
+  '@floating-ui/react-dom@2.1.6(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@floating-ui/dom': 1.7.4
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@floating-ui/utils@0.2.10': {}
+
+  '@radix-ui/primitive@1.1.3': {}
+
+  '@radix-ui/react-arrow@1.1.7(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-primitive': 2.1.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/react-compose-refs@1.1.2(react@18.3.1)':
+    dependencies:
+      react: 18.3.1
+
+  '@radix-ui/react-context@1.1.2(react@18.3.1)':
+    dependencies:
+      react: 18.3.1
+
+  '@radix-ui/react-dismissable-layer@1.1.11(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/primitive': 1.1.3
+      '@radix-ui/react-compose-refs': 1.1.2(react@18.3.1)
+      '@radix-ui/react-primitive': 2.1.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-use-callback-ref': 1.1.1(react@18.3.1)
+      '@radix-ui/react-use-escape-keydown': 1.1.1(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/react-id@1.1.1(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-use-layout-effect': 1.1.1(react@18.3.1)
+      react: 18.3.1
+
+  '@radix-ui/react-popper@1.2.8(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@floating-ui/react-dom': 2.1.6(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-arrow': 1.1.7(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-compose-refs': 1.1.2(react@18.3.1)
+      '@radix-ui/react-context': 1.1.2(react@18.3.1)
+      '@radix-ui/react-primitive': 2.1.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-use-callback-ref': 1.1.1(react@18.3.1)
+      '@radix-ui/react-use-layout-effect': 1.1.1(react@18.3.1)
+      '@radix-ui/react-use-rect': 1.1.1(react@18.3.1)
+      '@radix-ui/react-use-size': 1.1.1(react@18.3.1)
+      '@radix-ui/rect': 1.1.1
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/react-portal@1.1.9(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-primitive': 2.1.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-use-layout-effect': 1.1.1(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/react-presence@1.1.5(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-compose-refs': 1.1.2(react@18.3.1)
+      '@radix-ui/react-use-layout-effect': 1.1.1(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/react-primitive@2.1.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-slot': 1.2.3(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/react-slot@1.2.3(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-compose-refs': 1.1.2(react@18.3.1)
+      react: 18.3.1
+
+  '@radix-ui/react-tooltip@1.2.8(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/primitive': 1.1.3
+      '@radix-ui/react-compose-refs': 1.1.2(react@18.3.1)
+      '@radix-ui/react-context': 1.1.2(react@18.3.1)
+      '@radix-ui/react-dismissable-layer': 1.1.11(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-id': 1.1.1(react@18.3.1)
+      '@radix-ui/react-popper': 1.2.8(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-portal': 1.1.9(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-presence': 1.1.5(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-primitive': 2.1.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      '@radix-ui/react-slot': 1.2.3(react@18.3.1)
+      '@radix-ui/react-use-controllable-state': 1.2.2(react@18.3.1)
+      '@radix-ui/react-visually-hidden': 1.2.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/react-use-callback-ref@1.1.1(react@18.3.1)':
+    dependencies:
+      react: 18.3.1
+
+  '@radix-ui/react-use-controllable-state@1.2.2(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-use-effect-event': 0.0.2(react@18.3.1)
+      '@radix-ui/react-use-layout-effect': 1.1.1(react@18.3.1)
+      react: 18.3.1
+
+  '@radix-ui/react-use-effect-event@0.0.2(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-use-layout-effect': 1.1.1(react@18.3.1)
+      react: 18.3.1
+
+  '@radix-ui/react-use-escape-keydown@1.1.1(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-use-callback-ref': 1.1.1(react@18.3.1)
+      react: 18.3.1
+
+  '@radix-ui/react-use-layout-effect@1.1.1(react@18.3.1)':
+    dependencies:
+      react: 18.3.1
+
+  '@radix-ui/react-use-rect@1.1.1(react@18.3.1)':
+    dependencies:
+      '@radix-ui/rect': 1.1.1
+      react: 18.3.1
+
+  '@radix-ui/react-use-size@1.1.1(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-use-layout-effect': 1.1.1(react@18.3.1)
+      react: 18.3.1
+
+  '@radix-ui/react-visually-hidden@1.2.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)':
+    dependencies:
+      '@radix-ui/react-primitive': 2.1.3(react-dom@18.3.1(react@18.3.1))(react@18.3.1)
+      react: 18.3.1
+      react-dom: 18.3.1(react@18.3.1)
+
+  '@radix-ui/rect@1.1.1': {}
+
+  js-tokens@4.0.0: {}
+
+  loose-envify@1.4.0:
+    dependencies:
+      js-tokens: 4.0.0
+
+  react-dom@18.3.1(react@18.3.1):
+    dependencies:
+      loose-envify: 1.4.0
+      react: 18.3.1
+      scheduler: 0.23.2
+
+  react@18.3.1:
+    dependencies:
+      loose-envify: 1.4.0
+
+  scheduler@0.23.2:
+    dependencies:
+      loose-envify: 1.4.0
--- a/apps/web/scripts/generate-build-info.js
+++ b/apps/web/scripts/generate-build-info.js
@@ -5,26 +5,26 @@
 * This script captures git commit, branch, timestamp, and other metadata
 */

-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
+const { execSync } = require('child_process')
+const fs = require('fs')
+const path = require('path')

 function exec(command) {
  try {
-    return execSync(command, { encoding: 'utf-8' }).trim();
-  } catch (error) {
-    return null;
+    return execSync(command, { encoding: 'utf-8' }).trim()
+  } catch (_error) {
+    return null
  }
 }

 function getBuildInfo() {
-  const gitCommit = exec('git rev-parse HEAD');
-  const gitCommitShort = exec('git rev-parse --short HEAD');
-  const gitBranch = exec('git rev-parse --abbrev-ref HEAD');
-  const gitTag = exec('git describe --tags --exact-match 2>/dev/null');
-  const gitDirty = exec('git diff --quiet || echo "dirty"') === 'dirty';
+  const gitCommit = exec('git rev-parse HEAD')
+  const gitCommitShort = exec('git rev-parse --short HEAD')
+  const gitBranch = exec('git rev-parse --abbrev-ref HEAD')
+  const gitTag = exec('git describe --tags --exact-match 2>/dev/null')
+  const gitDirty = exec('git diff --quiet || echo "dirty"') === 'dirty'

-  const packageJson = require('../package.json');
+  const packageJson = require('../package.json')

  return {
    version: packageJson.version,
@@ -40,19 +40,19 @@ function getBuildInfo() {
    environment: process.env.NODE_ENV || 'development',
    buildNumber: process.env.BUILD_NUMBER || null,
    nodeVersion: process.version,
-  };
+  }
 }

-const buildInfo = getBuildInfo();
-const outputPath = path.join(__dirname, '..', 'src', 'generated', 'build-info.json');
+const buildInfo = getBuildInfo()
+const outputPath = path.join(__dirname, '..', 'src', 'generated', 'build-info.json')

 // Ensure directory exists
-const dir = path.dirname(outputPath);
+const dir = path.dirname(outputPath)
 if (!fs.existsSync(dir)) {
-  fs.mkdirSync(dir, { recursive: true });
+  fs.mkdirSync(dir, { recursive: true })
 }

-fs.writeFileSync(outputPath, JSON.stringify(buildInfo, null, 2));
+fs.writeFileSync(outputPath, JSON.stringify(buildInfo, null, 2))

-console.log('✅ Build info generated:', outputPath);
-console.log(JSON.stringify(buildInfo, null, 2));
+console.log('✅ Build info generated:', outputPath)
+console.log(JSON.stringify(buildInfo, null, 2))
--- a/apps/web/server.js
+++ b/apps/web/server.js
@@ -11,9 +11,8 @@ const handle = app.getRequestHandler()

 // Run migrations before starting server
 console.log('🔄 Running database migrations...')
-require('tsx/cjs')
 const { migrate } = require('drizzle-orm/better-sqlite3/migrator')
-const { db } = require('./src/db/index.ts')
+const { db } = require('./src/db/index.js')

 try {
  migrate(db, { migrationsFolder: './drizzle' })
@@ -35,9 +34,8 @@ app.prepare().then(() => {
    }
  })

-  // Initialize Socket.IO (load TypeScript with tsx)
-  require('tsx/cjs')
-  const { initializeSocketServer } = require('./socket-server.ts')
+  // Initialize Socket.IO
+  const { initializeSocketServer } = require('./socket-server.js')
  initializeSocketServer(server)

  server
--- a/apps/web/socket-server.js
+++ b/apps/web/socket-server.js
@@ -1,29 +1,319 @@
-const { Server } = require('socket.io')
-
-function initializeSocketServer(httpServer) {
-  const io = new Server(httpServer, {
-    path: '/api/socket',
-    cors: {
-      origin: process.env.NEXT_PUBLIC_URL || 'http://localhost:3000',
-      credentials: true,
-    },
-  })
-
-  io.on('connection', (socket) => {
-    console.log('🔌 Client connected:', socket.id)
-
-    socket.on('join-arcade-session', ({ userId }) => {
-      socket.join(`arcade:${userId}`)
-      console.log(`👤 User ${userId} joined arcade room`)
-    })
-
-    socket.on('disconnect', () => {
-      console.log('🔌 Client disconnected:', socket.id)
-    })
-  })
-
-  console.log('✅ Socket.IO initialized on /api/socket')
-  return io
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSocketIO = getSocketIO;
+exports.initializeSocketServer = initializeSocketServer;
+const socket_io_1 = require("socket.io");
+const session_manager_1 = require("./src/lib/arcade/session-manager");
+const room_manager_1 = require("./src/lib/arcade/room-manager");
+const room_membership_1 = require("./src/lib/arcade/room-membership");
+const player_manager_1 = require("./src/lib/arcade/player-manager");
+const MatchingGameValidator_1 = require("./src/lib/arcade/validation/MatchingGameValidator");
+/**
+ * Get the socket.io server instance
+ * Returns null if not initialized
+ */
+function getSocketIO() {
+    return globalThis.__socketIO || null;
+}
+function initializeSocketServer(httpServer) {
+    const io = new socket_io_1.Server(httpServer, {
+        path: '/api/socket',
+        cors: {
+            origin: process.env.NEXT_PUBLIC_URL || 'http://localhost:3000',
+            credentials: true,
+        },
+    });
+    io.on('connection', (socket) => {
+        console.log('🔌 Client connected:', socket.id);
+        let currentUserId = null;
+        // Join arcade session room
+        socket.on('join-arcade-session', async ({ userId, roomId }) => {
+            currentUserId = userId;
+            socket.join(`arcade:${userId}`);
+            console.log(`👤 User ${userId} joined arcade room`);
+            // If this session is part of a room, also join the game room for multi-user sync
+            if (roomId) {
+                socket.join(`game:${roomId}`);
+                console.log(`🎮 User ${userId} joined game room ${roomId}`);
+            }
+            // Send current session state if exists
+            // For room-based games, look up shared room session
+            try {
+                const session = roomId
+                    ? await (0, session_manager_1.getArcadeSessionByRoom)(roomId)
+                    : await (0, session_manager_1.getArcadeSession)(userId);
+                if (session) {
+                    console.log('[join-arcade-session] Found session:', {
+                        userId,
+                        roomId,
+                        version: session.version,
+                        sessionUserId: session.userId,
+                    });
+                    socket.emit('session-state', {
+                        gameState: session.gameState,
+                        currentGame: session.currentGame,
+                        gameUrl: session.gameUrl,
+                        activePlayers: session.activePlayers,
+                        version: session.version,
+                    });
+                }
+                else {
+                    console.log('[join-arcade-session] No active session found for:', {
+                        userId,
+                        roomId,
+                    });
+                    socket.emit('no-active-session');
+                }
+            }
+            catch (error) {
+                console.error('Error fetching session:', error);
+                socket.emit('session-error', { error: 'Failed to fetch session' });
+            }
+        });
+        // Handle game moves
+        socket.on('game-move', async (data) => {
+            console.log('🎮 Game move received:', {
+                userId: data.userId,
+                moveType: data.move.type,
+                playerId: data.move.playerId,
+                timestamp: data.move.timestamp,
+                roomId: data.roomId,
+                fullMove: JSON.stringify(data.move, null, 2),
+            });
+            try {
+                // Special handling for START_GAME - create session if it doesn't exist
+                if (data.move.type === 'START_GAME') {
+                    // For room-based games, check if room session exists
+                    const existingSession = data.roomId
+                        ? await (0, session_manager_1.getArcadeSessionByRoom)(data.roomId)
+                        : await (0, session_manager_1.getArcadeSession)(data.userId);
+                    if (!existingSession) {
+                        console.log('🎯 Creating new session for START_GAME');
+                        // activePlayers must be provided in the START_GAME move data
+                        const activePlayers = data.move.data?.activePlayers;
+                        if (!activePlayers || activePlayers.length === 0) {
+                            console.error('❌ START_GAME move missing activePlayers');
+                            socket.emit('move-rejected', {
+                                error: 'START_GAME requires at least one active player',
+                                move: data.move,
+                            });
+                            return;
+                        }
+                        // Get initial state from validator
+                        const initialState = MatchingGameValidator_1.matchingGameValidator.getInitialState({
+                            difficulty: 6,
+                            gameType: 'abacus-numeral',
+                            turnTimer: 30,
+                        });
+                        // Check if user is already in a room for this game
+                        const userRoomIds = await (0, room_membership_1.getUserRooms)(data.userId);
+                        let room = null;
+                        // Look for an existing active room for this game
+                        for (const roomId of userRoomIds) {
+                            const existingRoom = await (0, room_manager_1.getRoomById)(roomId);
+                            if (existingRoom &&
+                                existingRoom.gameName === 'matching' &&
+                                existingRoom.status !== 'finished') {
+                                room = existingRoom;
+                                console.log('🏠 Using existing room:', room.code);
+                                break;
+                            }
+                        }
+                        // If no suitable room exists, create a new one
+                        if (!room) {
+                            room = await (0, room_manager_1.createRoom)({
+                                name: 'Auto-generated Room',
+                                createdBy: data.userId,
+                                creatorName: 'Player',
+                                gameName: 'matching',
+                                gameConfig: {
+                                    difficulty: 6,
+                                    gameType: 'abacus-numeral',
+                                    turnTimer: 30,
+                                },
+                                ttlMinutes: 60,
+                            });
+                            console.log('🏠 Created new room:', room.code);
+                        }
+                        // Now create the session linked to the room
+                        await (0, session_manager_1.createArcadeSession)({
+                            userId: data.userId,
+                            gameName: 'matching',
+                            gameUrl: '/arcade/room', // Room-based sessions use /arcade/room
+                            initialState,
+                            activePlayers,
+                            roomId: room.id,
+                        });
+                        console.log('✅ Session created successfully with room association');
+                        // Notify all connected clients about the new session
+                        const newSession = await (0, session_manager_1.getArcadeSession)(data.userId);
+                        if (newSession) {
+                            io.to(`arcade:${data.userId}`).emit('session-state', {
+                                gameState: newSession.gameState,
+                                currentGame: newSession.currentGame,
+                                gameUrl: newSession.gameUrl,
+                                activePlayers: newSession.activePlayers,
+                                version: newSession.version,
+                            });
+                            console.log('📢 Emitted session-state to notify clients of new session');
+                        }
+                    }
+                }
+                // Apply game move - use roomId for room-based games to access shared session
+                const result = await (0, session_manager_1.applyGameMove)(data.userId, data.move, data.roomId);
+                if (result.success && result.session) {
+                    const moveAcceptedData = {
+                        gameState: result.session.gameState,
+                        version: result.session.version,
+                        move: data.move,
+                    };
+                    // Broadcast the updated state to all devices for this user
+                    io.to(`arcade:${data.userId}`).emit('move-accepted', moveAcceptedData);
+                    // If this is a room-based session, ALSO broadcast to all users in the room
+                    if (result.session.roomId) {
+                        io.to(`game:${result.session.roomId}`).emit('move-accepted', moveAcceptedData);
+                        console.log(`📢 Broadcasted move to game room ${result.session.roomId}`);
+                    }
+                    // Update activity timestamp
+                    await (0, session_manager_1.updateSessionActivity)(data.userId);
+                }
+                else {
+                    // Send rejection only to the requesting socket
+                    socket.emit('move-rejected', {
+                        error: result.error,
+                        move: data.move,
+                        versionConflict: result.versionConflict,
+                    });
+                }
+            }
+            catch (error) {
+                console.error('Error processing move:', error);
+                socket.emit('move-rejected', {
+                    error: 'Server error processing move',
+                    move: data.move,
+                });
+            }
+        });
+        // Handle session exit
+        socket.on('exit-arcade-session', async ({ userId }) => {
+            console.log('🚪 User exiting arcade session:', userId);
+            try {
+                await (0, session_manager_1.deleteArcadeSession)(userId);
+                io.to(`arcade:${userId}`).emit('session-ended');
+            }
+            catch (error) {
+                console.error('Error ending session:', error);
+                socket.emit('session-error', { error: 'Failed to end session' });
+            }
+        });
+        // Keep-alive ping
+        socket.on('ping-session', async ({ userId }) => {
+            try {
+                await (0, session_manager_1.updateSessionActivity)(userId);
+                socket.emit('pong-session');
+            }
+            catch (error) {
+                console.error('Error updating activity:', error);
+            }
+        });
+        // Room: Join
+        socket.on('join-room', async ({ roomId, userId }) => {
+            console.log(`🏠 User ${userId} joining room ${roomId}`);
+            try {
+                // Join the socket room
+                socket.join(`room:${roomId}`);
+                // Mark member as online
+                await (0, room_membership_1.setMemberOnline)(roomId, userId, true);
+                // Get room data
+                const members = await (0, room_membership_1.getRoomMembers)(roomId);
+                const memberPlayers = await (0, player_manager_1.getRoomActivePlayers)(roomId);
+                // Convert memberPlayers Map to object for JSON serialization
+                const memberPlayersObj = {};
+                for (const [uid, players] of memberPlayers.entries()) {
+                    memberPlayersObj[uid] = players;
+                }
+                // Send current room state to the joining user
+                socket.emit('room-joined', {
+                    roomId,
+                    members,
+                    memberPlayers: memberPlayersObj,
+                });
+                // Notify all other members in the room
+                socket.to(`room:${roomId}`).emit('member-joined', {
+                    roomId,
+                    userId,
+                    members,
+                    memberPlayers: memberPlayersObj,
+                });
+                console.log(`✅ User ${userId} joined room ${roomId}`);
+            }
+            catch (error) {
+                console.error('Error joining room:', error);
+                socket.emit('room-error', { error: 'Failed to join room' });
+            }
+        });
+        // Room: Leave
+        socket.on('leave-room', async ({ roomId, userId }) => {
+            console.log(`🚪 User ${userId} leaving room ${roomId}`);
+            try {
+                // Leave the socket room
+                socket.leave(`room:${roomId}`);
+                // Mark member as offline
+                await (0, room_membership_1.setMemberOnline)(roomId, userId, false);
+                // Get updated members
+                const members = await (0, room_membership_1.getRoomMembers)(roomId);
+                const memberPlayers = await (0, player_manager_1.getRoomActivePlayers)(roomId);
+                // Convert memberPlayers Map to object
+                const memberPlayersObj = {};
+                for (const [uid, players] of memberPlayers.entries()) {
+                    memberPlayersObj[uid] = players;
+                }
+                // Notify remaining members
+                io.to(`room:${roomId}`).emit('member-left', {
+                    roomId,
+                    userId,
+                    members,
+                    memberPlayers: memberPlayersObj,
+                });
+                console.log(`✅ User ${userId} left room ${roomId}`);
+            }
+            catch (error) {
+                console.error('Error leaving room:', error);
+            }
+        });
+        // Room: Players updated
+        socket.on('players-updated', async ({ roomId, userId }) => {
+            console.log(`🎯 Players updated for user ${userId} in room ${roomId}`);
+            try {
+                // Get updated player data
+                const memberPlayers = await (0, player_manager_1.getRoomActivePlayers)(roomId);
+                // Convert memberPlayers Map to object
+                const memberPlayersObj = {};
+                for (const [uid, players] of memberPlayers.entries()) {
+                    memberPlayersObj[uid] = players;
+                }
+                // Broadcast to all members in the room (including sender)
+                io.to(`room:${roomId}`).emit('room-players-updated', {
+                    roomId,
+                    memberPlayers: memberPlayersObj,
+                });
+                console.log(`✅ Broadcasted player updates for room ${roomId}`);
+            }
+            catch (error) {
+                console.error('Error updating room players:', error);
+                socket.emit('room-error', { error: 'Failed to update players' });
+            }
+        });
+        socket.on('disconnect', () => {
+            console.log('🔌 Client disconnected:', socket.id);
+            if (currentUserId) {
+                // Don't delete session on disconnect - it persists across devices
+                console.log(`👤 User ${currentUserId} disconnected but session persists`);
+            }
+        });
+    });
+    // Store in globalThis to make accessible across module boundaries
+    globalThis.__socketIO = io;
+    console.log('✅ Socket.IO initialized on /api/socket');
+    return io;
 }
-
-module.exports = { initializeSocketServer }
--- a/apps/web/socket-server.ts
+++ b/apps/web/socket-server.ts
@@ -1,15 +1,34 @@
-import { Server as SocketIOServer } from 'socket.io'
 import type { Server as HTTPServer } from 'http'
+import { Server as SocketIOServer } from 'socket.io'
+import type { Server as SocketIOServerType } from 'socket.io'
 import {
-  getArcadeSession,
  applyGameMove,
-  updateSessionActivity,
-  deleteArcadeSession,
  createArcadeSession,
+  deleteArcadeSession,
+  getArcadeSession,
+  getArcadeSessionByRoom,
+  updateSessionActivity,
 } from './src/lib/arcade/session-manager'
-import type { GameMove } from './src/lib/arcade/validation'
+import { createRoom, getRoomById } from './src/lib/arcade/room-manager'
+import { getRoomMembers, getUserRooms, setMemberOnline } from './src/lib/arcade/room-membership'
+import { getRoomActivePlayers } from './src/lib/arcade/player-manager'
+import type { GameMove, GameName } from './src/lib/arcade/validation'
 import { matchingGameValidator } from './src/lib/arcade/validation/MatchingGameValidator'

+// Use globalThis to store socket.io instance to avoid module isolation issues
+// This ensures the same instance is accessible across dynamic imports
+declare global {
+  var __socketIO: SocketIOServerType | undefined
+}
+
+/**
+ * Get the socket.io server instance
+ * Returns null if not initialized
+ */
+export function getSocketIO(): SocketIOServerType | null {
+  return globalThis.__socketIO || null
+}
+
 export function initializeSocketServer(httpServer: HTTPServer) {
  const io = new SocketIOServer(httpServer, {
    path: '/api/socket',
@@ -24,45 +43,72 @@ export function initializeSocketServer(httpServer: HTTPServer) {
    let currentUserId: string | null = null

    // Join arcade session room
-    socket.on('join-arcade-session', async ({ userId }: { userId: string }) => {
-      currentUserId = userId
-      socket.join(`arcade:${userId}`)
-      console.log(`👤 User ${userId} joined arcade room`)
+    socket.on(
+      'join-arcade-session',
+      async ({ userId, roomId }: { userId: string; roomId?: string }) => {
+        currentUserId = userId
+        socket.join(`arcade:${userId}`)
+        console.log(`👤 User ${userId} joined arcade room`)

-      // Send current session state if exists
-      try {
-        const session = await getArcadeSession(userId)
-        if (session) {
-          socket.emit('session-state', {
-            gameState: session.gameState,
-            currentGame: session.currentGame,
-            gameUrl: session.gameUrl,
-            activePlayers: session.activePlayers,
-            version: session.version,
-          })
-        } else {
-          socket.emit('no-active-session')
+        // If this session is part of a room, also join the game room for multi-user sync
+        if (roomId) {
+          socket.join(`game:${roomId}`)
+          console.log(`🎮 User ${userId} joined game room ${roomId}`)
+        }
+
+        // Send current session state if exists
+        // For room-based games, look up shared room session
+        try {
+          const session = roomId
+            ? await getArcadeSessionByRoom(roomId)
+            : await getArcadeSession(userId)
+
+          if (session) {
+            console.log('[join-arcade-session] Found session:', {
+              userId,
+              roomId,
+              version: session.version,
+              sessionUserId: session.userId,
+            })
+            socket.emit('session-state', {
+              gameState: session.gameState,
+              currentGame: session.currentGame,
+              gameUrl: session.gameUrl,
+              activePlayers: session.activePlayers,
+              version: session.version,
+            })
+          } else {
+            console.log('[join-arcade-session] No active session found for:', {
+              userId,
+              roomId,
+            })
+            socket.emit('no-active-session')
+          }
+        } catch (error) {
+          console.error('Error fetching session:', error)
+          socket.emit('session-error', { error: 'Failed to fetch session' })
        }
-      } catch (error) {
-        console.error('Error fetching session:', error)
-        socket.emit('session-error', { error: 'Failed to fetch session' })
      }
-    })
+    )

    // Handle game moves
-    socket.on('game-move', async (data: { userId: string; move: GameMove }) => {
+    socket.on('game-move', async (data: { userId: string; move: GameMove; roomId?: string }) => {
      console.log('🎮 Game move received:', {
        userId: data.userId,
        moveType: data.move.type,
        playerId: data.move.playerId,
        timestamp: data.move.timestamp,
-        fullMove: JSON.stringify(data.move, null, 2)
+        roomId: data.roomId,
+        fullMove: JSON.stringify(data.move, null, 2),
      })

      try {
        // Special handling for START_GAME - create session if it doesn't exist
        if (data.move.type === 'START_GAME') {
-          const existingSession = await getArcadeSession(data.userId)
+          // For room-based games, check if room session exists
+          const existingSession = data.roomId
+            ? await getArcadeSessionByRoom(data.roomId)
+            : await getArcadeSession(data.userId)

          if (!existingSession) {
            console.log('🎯 Creating new session for START_GAME')
@@ -85,20 +131,57 @@ export function initializeSocketServer(httpServer: HTTPServer) {
              turnTimer: 30,
            })

+            // Check if user is already in a room for this game
+            const userRoomIds = await getUserRooms(data.userId)
+            let room = null
+
+            // Look for an existing active room for this game
+            for (const roomId of userRoomIds) {
+              const existingRoom = await getRoomById(roomId)
+              if (
+                existingRoom &&
+                existingRoom.gameName === 'matching' &&
+                existingRoom.status !== 'finished'
+              ) {
+                room = existingRoom
+                console.log('🏠 Using existing room:', room.code)
+                break
+              }
+            }
+
+            // If no suitable room exists, create a new one
+            if (!room) {
+              room = await createRoom({
+                name: 'Auto-generated Room',
+                createdBy: data.userId,
+                creatorName: 'Player',
+                gameName: 'matching' as GameName,
+                gameConfig: {
+                  difficulty: 6,
+                  gameType: 'abacus-numeral',
+                  turnTimer: 30,
+                },
+                ttlMinutes: 60,
+              })
+              console.log('🏠 Created new room:', room.code)
+            }
+
+            // Now create the session linked to the room
            await createArcadeSession({
              userId: data.userId,
              gameName: 'matching',
-              gameUrl: '/arcade/matching',
+              gameUrl: '/arcade/room', // Room-based sessions use /arcade/room
              initialState,
              activePlayers,
+              roomId: room.id,
            })

-            console.log('✅ Session created successfully')
+            console.log('✅ Session created successfully with room association')

            // Notify all connected clients about the new session
            const newSession = await getArcadeSession(data.userId)
            if (newSession) {
-              io.to(`arcade:${data.userId}`).emit('session-state', {
+              io!.to(`arcade:${data.userId}`).emit('session-state', {
                gameState: newSession.gameState,
                currentGame: newSession.currentGame,
                gameUrl: newSession.gameUrl,
@@ -110,15 +193,24 @@ export function initializeSocketServer(httpServer: HTTPServer) {
          }
        }

-        const result = await applyGameMove(data.userId, data.move)
+        // Apply game move - use roomId for room-based games to access shared session
+        const result = await applyGameMove(data.userId, data.move, data.roomId)

        if (result.success && result.session) {
-          // Broadcast the updated state to all devices for this user
-          io.to(`arcade:${data.userId}`).emit('move-accepted', {
+          const moveAcceptedData = {
            gameState: result.session.gameState,
            version: result.session.version,
            move: data.move,
-          })
+          }
+
+          // Broadcast the updated state to all devices for this user
+          io!.to(`arcade:${data.userId}`).emit('move-accepted', moveAcceptedData)
+
+          // If this is a room-based session, ALSO broadcast to all users in the room
+          if (result.session.roomId) {
+            io!.to(`game:${result.session.roomId}`).emit('move-accepted', moveAcceptedData)
+            console.log(`📢 Broadcasted move to game room ${result.session.roomId}`)
+          }

          // Update activity timestamp
          await updateSessionActivity(data.userId)
@@ -145,7 +237,7 @@ export function initializeSocketServer(httpServer: HTTPServer) {

      try {
        await deleteArcadeSession(userId)
-        io.to(`arcade:${userId}`).emit('session-ended')
+        io!.to(`arcade:${userId}`).emit('session-ended')
      } catch (error) {
        console.error('Error ending session:', error)
        socket.emit('session-error', { error: 'Failed to end session' })
@@ -162,6 +254,111 @@ export function initializeSocketServer(httpServer: HTTPServer) {
      }
    })

+    // Room: Join
+    socket.on('join-room', async ({ roomId, userId }: { roomId: string; userId: string }) => {
+      console.log(`🏠 User ${userId} joining room ${roomId}`)
+
+      try {
+        // Join the socket room
+        socket.join(`room:${roomId}`)
+
+        // Mark member as online
+        await setMemberOnline(roomId, userId, true)
+
+        // Get room data
+        const members = await getRoomMembers(roomId)
+        const memberPlayers = await getRoomActivePlayers(roomId)
+
+        // Convert memberPlayers Map to object for JSON serialization
+        const memberPlayersObj: Record<string, any[]> = {}
+        for (const [uid, players] of memberPlayers.entries()) {
+          memberPlayersObj[uid] = players
+        }
+
+        // Send current room state to the joining user
+        socket.emit('room-joined', {
+          roomId,
+          members,
+          memberPlayers: memberPlayersObj,
+        })
+
+        // Notify all other members in the room
+        socket.to(`room:${roomId}`).emit('member-joined', {
+          roomId,
+          userId,
+          members,
+          memberPlayers: memberPlayersObj,
+        })
+
+        console.log(`✅ User ${userId} joined room ${roomId}`)
+      } catch (error) {
+        console.error('Error joining room:', error)
+        socket.emit('room-error', { error: 'Failed to join room' })
+      }
+    })
+
+    // Room: Leave
+    socket.on('leave-room', async ({ roomId, userId }: { roomId: string; userId: string }) => {
+      console.log(`🚪 User ${userId} leaving room ${roomId}`)
+
+      try {
+        // Leave the socket room
+        socket.leave(`room:${roomId}`)
+
+        // Mark member as offline
+        await setMemberOnline(roomId, userId, false)
+
+        // Get updated members
+        const members = await getRoomMembers(roomId)
+        const memberPlayers = await getRoomActivePlayers(roomId)
+
+        // Convert memberPlayers Map to object
+        const memberPlayersObj: Record<string, any[]> = {}
+        for (const [uid, players] of memberPlayers.entries()) {
+          memberPlayersObj[uid] = players
+        }
+
+        // Notify remaining members
+        io!.to(`room:${roomId}`).emit('member-left', {
+          roomId,
+          userId,
+          members,
+          memberPlayers: memberPlayersObj,
+        })
+
+        console.log(`✅ User ${userId} left room ${roomId}`)
+      } catch (error) {
+        console.error('Error leaving room:', error)
+      }
+    })
+
+    // Room: Players updated
+    socket.on('players-updated', async ({ roomId, userId }: { roomId: string; userId: string }) => {
+      console.log(`🎯 Players updated for user ${userId} in room ${roomId}`)
+
+      try {
+        // Get updated player data
+        const memberPlayers = await getRoomActivePlayers(roomId)
+
+        // Convert memberPlayers Map to object
+        const memberPlayersObj: Record<string, any[]> = {}
+        for (const [uid, players] of memberPlayers.entries()) {
+          memberPlayersObj[uid] = players
+        }
+
+        // Broadcast to all members in the room (including sender)
+        io!.to(`room:${roomId}`).emit('room-players-updated', {
+          roomId,
+          memberPlayers: memberPlayersObj,
+        })
+
+        console.log(`✅ Broadcasted player updates for room ${roomId}`)
+      } catch (error) {
+        console.error('Error updating room players:', error)
+        socket.emit('room-error', { error: 'Failed to update players' })
+      }
+    })
+
    socket.on('disconnect', () => {
      console.log('🔌 Client disconnected:', socket.id)
      if (currentUserId) {
@@ -171,6 +368,8 @@ export function initializeSocketServer(httpServer: HTTPServer) {
    })
  })

+  // Store in globalThis to make accessible across module boundaries
+  globalThis.__socketIO = io
  console.log('✅ Socket.IO initialized on /api/socket')
  return io
 }
--- a/apps/web/src/app/tests/layout.nav.test.tsx
+++ b/apps/web/src/app/tests/layout.nav.test.tsx
@@ -1,62 +1,33 @@
 import { render, screen } from '@testing-library/react'
 import RootLayout from '../layout'

-// Mock AppNavBar to verify it receives the nav prop
-const MockAppNavBar = ({ navSlot }: { navSlot?: React.ReactNode }) => (
-  <div data-testid="app-nav-bar">
-    {navSlot && <div data-testid="nav-slot-content">{navSlot}</div>}
-  </div>
-)
-
-jest.mock('../../components/AppNavBar', () => ({
-  AppNavBar: MockAppNavBar,
+// Mock ClientProviders
+vi.mock('../../components/ClientProviders', () => ({
+  ClientProviders: ({ children }: { children: React.ReactNode }) => (
+    <div data-testid="client-providers">{children}</div>
+  ),
 }))

-// Mock all context providers
-jest.mock('../../contexts/AbacusDisplayContext', () => ({
-  AbacusDisplayProvider: ({ children }: { children: React.ReactNode }) => <div>{children}</div>,
-}))
-
-jest.mock('../../contexts/UserProfileContext', () => ({
-  UserProfileProvider: ({ children }: { children: React.ReactNode }) => <div>{children}</div>,
-}))
-
-jest.mock('../../contexts/GameModeContext', () => ({
-  GameModeProvider: ({ children }: { children: React.ReactNode }) => <div>{children}</div>,
-}))
-
-jest.mock('../../contexts/FullscreenContext', () => ({
-  FullscreenProvider: ({ children }: { children: React.ReactNode }) => <div>{children}</div>,
-}))
-
-describe('RootLayout with nav slot', () => {
-  it('passes nav slot to AppNavBar', () => {
-    const navContent = <div>Memory Lightning</div>
+describe('RootLayout', () => {
+  it('renders children with ClientProviders', () => {
    const pageContent = <div>Page content</div>

-    render(
-      <RootLayout nav={navContent}>
-        {pageContent}
-      </RootLayout>
-    )
+    render(<RootLayout>{pageContent}</RootLayout>)

-    expect(screen.getByTestId('app-nav-bar')).toBeInTheDocument()
-    expect(screen.getByTestId('nav-slot-content')).toBeInTheDocument()
-    expect(screen.getByText('Memory Lightning')).toBeInTheDocument()
+    expect(screen.getByTestId('client-providers')).toBeInTheDocument()
    expect(screen.getByText('Page content')).toBeInTheDocument()
  })

-  it('works without nav slot', () => {
-    const pageContent = <div>Page content</div>
+  it('renders html and body tags', () => {
+    const pageContent = <div>Test content</div>

-    render(
-      <RootLayout nav={null}>
-        {pageContent}
-      </RootLayout>
-    )
+    const { container } = render(<RootLayout>{pageContent}</RootLayout>)

-    expect(screen.getByTestId('app-nav-bar')).toBeInTheDocument()
-    expect(screen.queryByTestId('nav-slot-content')).not.toBeInTheDocument()
-    expect(screen.getByText('Page content')).toBeInTheDocument()
+    const html = container.querySelector('html')
+    const body = container.querySelector('body')
+
+    expect(html).toBeInTheDocument()
+    expect(html).toHaveAttribute('lang', 'en')
+    expect(body).toBeInTheDocument()
  })
-})
+})
--- a/apps/web/src/app/abacus-test/page.tsx
+++ b/apps/web/src/app/abacus-test/page.tsx
@@ -1,8 +1,8 @@
 'use client'

 import { AbacusReact } from '@soroban/abacus-react'
-import { css } from '../../../styled-system/css'
 import { useState } from 'react'
+import { css } from '../../../styled-system/css'

 export default function AbacusTestPage() {
  const [value, setValue] = useState(0)
@@ -15,32 +15,36 @@ export default function AbacusTestPage() {
  }

  return (
-    <div className={css({
-      position: 'fixed',
-      top: 0,
-      left: 0,
-      right: 0,
-      bottom: 0,
-      bg: 'gray.50',
-      display: 'flex',
-      flexDirection: 'column',
-      alignItems: 'center',
-      justifyContent: 'center',
-      padding: '4'
-    })}>
+    <div
+      className={css({
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        right: 0,
+        bottom: 0,
+        bg: 'gray.50',
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: '4',
+      })}
+    >
      {/* Debug info */}
-      <div className={css({
-        position: 'absolute',
-        top: '4',
-        left: '4',
-        bg: 'white',
-        p: '3',
-        rounded: 'md',
-        border: '1px solid',
-        borderColor: 'gray.300',
-        fontSize: 'sm',
-        fontFamily: 'mono'
-      })}>
+      <div
+        className={css({
+          position: 'absolute',
+          top: '4',
+          left: '4',
+          bg: 'white',
+          p: '3',
+          rounded: 'md',
+          border: '1px solid',
+          borderColor: 'gray.300',
+          fontSize: 'sm',
+          fontFamily: 'mono',
+        })}
+      >
        <div>Current Value: {value}</div>
        <div>{debugInfo}</div>
        <button
@@ -53,7 +57,7 @@ export default function AbacusTestPage() {
            color: 'white',
            rounded: 'sm',
            fontSize: 'xs',
-            cursor: 'pointer'
+            cursor: 'pointer',
          })}
        >
          Reset to 0
@@ -68,20 +72,22 @@ export default function AbacusTestPage() {
            color: 'white',
            rounded: 'sm',
            fontSize: 'xs',
-            cursor: 'pointer'
+            cursor: 'pointer',
          })}
        >
          Set to 12345
        </button>
      </div>

-      <div style={{
-        width: '100%',
-        height: '100%',
-        display: 'flex',
-        alignItems: 'center',
-        justifyContent: 'center'
-      }}>
+      <div
+        style={{
+          width: '100%',
+          height: '100%',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+        }}
+      >
        <AbacusReact
          value={value}
          columns={5}
@@ -97,4 +103,4 @@ export default function AbacusTestPage() {
      </div>
    </div>
  )
-}
+}
--- a/apps/web/src/app/api/abacus-settings/route.ts
+++ b/apps/web/src/app/api/abacus-settings/route.ts
@@ -1,7 +1,7 @@
-import { NextResponse, NextRequest } from 'next/server'
+import { eq } from 'drizzle-orm'
+import { type NextRequest, NextResponse } from 'next/server'
 import { db } from '@/db'
 import * as schema from '@/db/schema'
-import { eq } from 'drizzle-orm'
 import { getViewerId } from '@/lib/viewer'

 /**
@@ -30,10 +30,7 @@ export async function GET() {
    return NextResponse.json({ settings })
  } catch (error) {
    console.error('Failed to fetch abacus settings:', error)
-    return NextResponse.json(
-      { error: 'Failed to fetch abacus settings' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to fetch abacus settings' }, { status: 500 })
  }
 }

@@ -75,10 +72,7 @@ export async function PATCH(req: NextRequest) {
    return NextResponse.json({ settings: updatedSettings })
  } catch (error) {
    console.error('Failed to update abacus settings:', error)
-    return NextResponse.json(
-      { error: 'Failed to update abacus settings' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to update abacus settings' }, { status: 500 })
  }
 }

--- a/apps/web/src/app/api/arcade-session/tests/route.test.ts
+++ b/apps/web/src/app/api/arcade-session/tests/route.test.ts
@@ -1,9 +1,9 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { GET, POST, DELETE } from '../route'
-import { NextRequest } from 'next/server'
-import { db, schema } from '@/db'
 import { eq } from 'drizzle-orm'
+import { NextRequest } from 'next/server'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { db, schema } from '@/db'
 import { deleteArcadeSession } from '@/lib/arcade/session-manager'
+import { DELETE, GET, POST } from '../route'

 describe('Arcade Session API Routes', () => {
  const testUserId = 'test-user-for-api-routes'
@@ -100,9 +100,7 @@ describe('Arcade Session API Routes', () => {
      await POST(createRequest)

      // Now retrieve it
-      const request = new NextRequest(
-        `${baseUrl}/api/arcade-session?userId=${testUserId}`
-      )
+      const request = new NextRequest(`${baseUrl}/api/arcade-session?userId=${testUserId}`)

      const response = await GET(request)
      const data = await response.json()
@@ -113,9 +111,7 @@ describe('Arcade Session API Routes', () => {
    })

    it('should return 404 for non-existent session', async () => {
-      const request = new NextRequest(
-        `${baseUrl}/api/arcade-session?userId=non-existent`
-      )
+      const request = new NextRequest(`${baseUrl}/api/arcade-session?userId=non-existent`)

      const response = await GET(request)

@@ -149,10 +145,9 @@ describe('Arcade Session API Routes', () => {
      await POST(createRequest)

      // Now delete it
-      const request = new NextRequest(
-        `${baseUrl}/api/arcade-session?userId=${testUserId}`,
-        { method: 'DELETE' }
-      )
+      const request = new NextRequest(`${baseUrl}/api/arcade-session?userId=${testUserId}`, {
+        method: 'DELETE',
+      })

      const response = await DELETE(request)
      const data = await response.json()
@@ -161,9 +156,7 @@ describe('Arcade Session API Routes', () => {
      expect(data.success).toBe(true)

      // Verify it's deleted
-      const getRequest = new NextRequest(
-        `${baseUrl}/api/arcade-session?userId=${testUserId}`
-      )
+      const getRequest = new NextRequest(`${baseUrl}/api/arcade-session?userId=${testUserId}`)
      const getResponse = await GET(getRequest)
      expect(getResponse.status).toBe(404)
    })
--- a/apps/web/src/app/api/arcade-session/route.ts
+++ b/apps/web/src/app/api/arcade-session/route.ts
@@ -1,8 +1,8 @@
-import { NextRequest, NextResponse } from 'next/server'
+import { type NextRequest, NextResponse } from 'next/server'
 import {
  createArcadeSession,
-  getArcadeSession,
  deleteArcadeSession,
+  getArcadeSession,
 } from '@/lib/arcade/session-manager'
 import type { GameName } from '@/lib/arcade/validation'

@@ -47,11 +47,14 @@ export async function GET(request: NextRequest) {
 export async function POST(request: NextRequest) {
  try {
    const body = await request.json()
-    const { userId, gameName, gameUrl, initialState, activePlayers } = body
+    const { userId, gameName, gameUrl, initialState, activePlayers, roomId } = body

-    if (!userId || !gameName || !gameUrl || !initialState || !activePlayers) {
+    if (!userId || !gameName || !gameUrl || !initialState || !activePlayers || !roomId) {
      return NextResponse.json(
-        { error: 'Missing required fields' },
+        {
+          error:
+            'Missing required fields (userId, gameName, gameUrl, initialState, activePlayers, roomId)',
+        },
        { status: 400 }
      )
    }
@@ -62,6 +65,7 @@ export async function POST(request: NextRequest) {
      gameUrl,
      initialState,
      activePlayers,
+      roomId,
    })

    return NextResponse.json({
--- a/apps/web/src/app/api/arcade/rooms/[roomId]/join/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/[roomId]/join/route.ts
@@ -0,0 +1,125 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import { getRoomById, touchRoom } from '@/lib/arcade/room-manager'
+import { addRoomMember, getRoomMembers } from '@/lib/arcade/room-membership'
+import { getActivePlayers, getRoomActivePlayers } from '@/lib/arcade/player-manager'
+import { getViewerId } from '@/lib/viewer'
+import { getSocketIO } from '@/lib/socket-io'
+
+type RouteContext = {
+  params: Promise<{ roomId: string }>
+}
+
+/**
+ * POST /api/arcade/rooms/:roomId/join
+ * Join a room
+ * Body:
+ *   - displayName?: string (optional, will generate from viewerId if not provided)
+ */
+export async function POST(req: NextRequest, context: RouteContext) {
+  try {
+    const { roomId } = await context.params
+    const viewerId = await getViewerId()
+    const body = await req.json().catch(() => ({}))
+
+    // Get room
+    const room = await getRoomById(roomId)
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    // Check if room is locked
+    if (room.isLocked) {
+      return NextResponse.json({ error: 'Room is locked' }, { status: 403 })
+    }
+
+    // Get or generate display name
+    const displayName = body.displayName || `Guest ${viewerId.slice(-4)}`
+
+    // Validate display name length
+    if (displayName.length > 50) {
+      return NextResponse.json(
+        { error: 'Display name too long (max 50 characters)' },
+        { status: 400 }
+      )
+    }
+
+    // Add member (with auto-leave logic for modal room enforcement)
+    const { member, autoLeaveResult } = await addRoomMember({
+      roomId,
+      userId: viewerId,
+      displayName,
+      isCreator: false,
+    })
+
+    // Fetch user's active players (these will participate in the game)
+    const activePlayers = await getActivePlayers(viewerId)
+
+    // Update room activity to refresh TTL
+    await touchRoom(roomId)
+
+    // Broadcast to all users in the room via socket
+    const io = await getSocketIO()
+    if (io) {
+      try {
+        const members = await getRoomMembers(roomId)
+        const memberPlayers = await getRoomActivePlayers(roomId)
+
+        // Convert memberPlayers Map to object for JSON serialization
+        const memberPlayersObj: Record<string, any[]> = {}
+        for (const [uid, players] of memberPlayers.entries()) {
+          memberPlayersObj[uid] = players
+        }
+
+        // Broadcast to all users in this room
+        io.to(`room:${roomId}`).emit('member-joined', {
+          roomId,
+          userId: viewerId,
+          members,
+          memberPlayers: memberPlayersObj,
+        })
+
+        console.log(`[Join API] Broadcasted member-joined for user ${viewerId} in room ${roomId}`)
+      } catch (socketError) {
+        // Log but don't fail the request if socket broadcast fails
+        console.error('[Join API] Failed to broadcast member-joined:', socketError)
+      }
+    }
+
+    // Build response with auto-leave info if applicable
+    return NextResponse.json(
+      {
+        member,
+        room,
+        activePlayers, // The user's active players that will join the game
+        autoLeave: autoLeaveResult
+          ? {
+              leftRooms: autoLeaveResult.leftRooms,
+              roomCount: autoLeaveResult.leftRooms.length,
+              message: `You were automatically removed from ${autoLeaveResult.leftRooms.length} other room(s)`,
+            }
+          : undefined,
+      },
+      { status: 201 }
+    )
+  } catch (error: any) {
+    console.error('Failed to join room:', error)
+
+    // Handle specific constraint violation error
+    if (error.message?.includes('ROOM_MEMBERSHIP_CONFLICT')) {
+      return NextResponse.json(
+        {
+          error: 'You are already in another room',
+          code: 'ROOM_MEMBERSHIP_CONFLICT',
+          message:
+            'You can only be in one room at a time. Please leave your current room before joining a new one.',
+          userMessage:
+            '⚠️ Already in Another Room\n\nYou can only be in one room at a time. Please refresh the page and try again.',
+        },
+        { status: 409 } // 409 Conflict
+      )
+    }
+
+    // Generic error
+    return NextResponse.json({ error: 'Failed to join room' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/arcade/rooms/[roomId]/leave/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/[roomId]/leave/route.ts
@@ -0,0 +1,69 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import { getRoomById } from '@/lib/arcade/room-manager'
+import { getRoomMembers, isMember, removeMember } from '@/lib/arcade/room-membership'
+import { getRoomActivePlayers } from '@/lib/arcade/player-manager'
+import { getViewerId } from '@/lib/viewer'
+import { getSocketIO } from '@/lib/socket-io'
+
+type RouteContext = {
+  params: Promise<{ roomId: string }>
+}
+
+/**
+ * POST /api/arcade/rooms/:roomId/leave
+ * Leave a room
+ */
+export async function POST(_req: NextRequest, context: RouteContext) {
+  try {
+    const { roomId } = await context.params
+    const viewerId = await getViewerId()
+
+    // Get room
+    const room = await getRoomById(roomId)
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    // Check if member
+    const isMemberOfRoom = await isMember(roomId, viewerId)
+    if (!isMemberOfRoom) {
+      return NextResponse.json({ error: 'Not a member of this room' }, { status: 400 })
+    }
+
+    // Remove member
+    await removeMember(roomId, viewerId)
+
+    // Broadcast to all remaining users in the room via socket
+    const io = await getSocketIO()
+    if (io) {
+      try {
+        const members = await getRoomMembers(roomId)
+        const memberPlayers = await getRoomActivePlayers(roomId)
+
+        // Convert memberPlayers Map to object for JSON serialization
+        const memberPlayersObj: Record<string, any[]> = {}
+        for (const [uid, players] of memberPlayers.entries()) {
+          memberPlayersObj[uid] = players
+        }
+
+        // Broadcast to all users in this room
+        io.to(`room:${roomId}`).emit('member-left', {
+          roomId,
+          userId: viewerId,
+          members,
+          memberPlayers: memberPlayersObj,
+        })
+
+        console.log(`[Leave API] Broadcasted member-left for user ${viewerId} in room ${roomId}`)
+      } catch (socketError) {
+        // Log but don't fail the request if socket broadcast fails
+        console.error('[Leave API] Failed to broadcast member-left:', socketError)
+      }
+    }
+
+    return NextResponse.json({ success: true })
+  } catch (error) {
+    console.error('Failed to leave room:', error)
+    return NextResponse.json({ error: 'Failed to leave room' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/arcade/rooms/[roomId]/members/[userId]/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/[roomId]/members/[userId]/route.ts
@@ -0,0 +1,50 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import { getRoomById, isRoomCreator } from '@/lib/arcade/room-manager'
+import { isMember, removeMember } from '@/lib/arcade/room-membership'
+import { getViewerId } from '@/lib/viewer'
+
+type RouteContext = {
+  params: Promise<{ roomId: string; userId: string }>
+}
+
+/**
+ * DELETE /api/arcade/rooms/:roomId/members/:userId
+ * Kick a member from room (creator only)
+ */
+export async function DELETE(_req: NextRequest, context: RouteContext) {
+  try {
+    const { roomId, userId } = await context.params
+    const viewerId = await getViewerId()
+
+    // Get room
+    const room = await getRoomById(roomId)
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    // Check if requester is room creator
+    const isCreator = await isRoomCreator(roomId, viewerId)
+    if (!isCreator) {
+      return NextResponse.json({ error: 'Only room creator can kick members' }, { status: 403 })
+    }
+
+    // Cannot kick self
+    if (userId === viewerId) {
+      return NextResponse.json({ error: 'Cannot kick yourself' }, { status: 400 })
+    }
+
+    // Check if target user is a member
+    const isTargetMember = await isMember(roomId, userId)
+    if (!isTargetMember) {
+      return NextResponse.json({ error: 'User is not a member of this room' }, { status: 404 })
+    }
+
+    // Remove member
+    await removeMember(roomId, userId)
+
+    return NextResponse.json({ success: true })
+  } catch (error) {
+    console.error('Failed to kick member:', error)
+    return NextResponse.json({ error: 'Failed to kick member' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/arcade/rooms/[roomId]/members/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/[roomId]/members/route.ts
@@ -0,0 +1,35 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import { getRoomById } from '@/lib/arcade/room-manager'
+import { getOnlineMemberCount, getRoomMembers } from '@/lib/arcade/room-membership'
+
+type RouteContext = {
+  params: Promise<{ roomId: string }>
+}
+
+/**
+ * GET /api/arcade/rooms/:roomId/members
+ * Get all members in a room
+ */
+export async function GET(_req: NextRequest, context: RouteContext) {
+  try {
+    const { roomId } = await context.params
+
+    // Get room
+    const room = await getRoomById(roomId)
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    // Get members
+    const members = await getRoomMembers(roomId)
+    const onlineCount = await getOnlineMemberCount(roomId)
+
+    return NextResponse.json({
+      members,
+      onlineCount,
+    })
+  } catch (error) {
+    console.error('Failed to fetch members:', error)
+    return NextResponse.json({ error: 'Failed to fetch members' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/arcade/rooms/[roomId]/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/[roomId]/route.ts
@@ -0,0 +1,132 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import {
+  deleteRoom,
+  getRoomById,
+  isRoomCreator,
+  touchRoom,
+  updateRoom,
+} from '@/lib/arcade/room-manager'
+import { getRoomMembers } from '@/lib/arcade/room-membership'
+import { getActivePlayers } from '@/lib/arcade/player-manager'
+import { getViewerId } from '@/lib/viewer'
+
+type RouteContext = {
+  params: Promise<{ roomId: string }>
+}
+
+/**
+ * GET /api/arcade/rooms/:roomId
+ * Get room details including members
+ */
+export async function GET(_req: NextRequest, context: RouteContext) {
+  try {
+    const { roomId } = await context.params
+    const viewerId = await getViewerId()
+
+    const room = await getRoomById(roomId)
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    const members = await getRoomMembers(roomId)
+    const canModerate = await isRoomCreator(roomId, viewerId)
+
+    // Fetch active players for each member
+    // This creates a map of userId -> Player[]
+    const memberPlayers: Record<string, any[]> = {}
+    for (const member of members) {
+      const activePlayers = await getActivePlayers(member.userId)
+      memberPlayers[member.userId] = activePlayers
+    }
+
+    // Update room activity when viewing (keeps active rooms fresh)
+    await touchRoom(roomId)
+
+    return NextResponse.json({
+      room,
+      members,
+      memberPlayers, // Map of userId -> active Player[] for each member
+      canModerate,
+    })
+  } catch (error) {
+    console.error('Failed to fetch room:', error)
+    return NextResponse.json({ error: 'Failed to fetch room' }, { status: 500 })
+  }
+}
+
+/**
+ * PATCH /api/arcade/rooms/:roomId
+ * Update room (creator only)
+ * Body:
+ *   - name?: string
+ *   - isLocked?: boolean
+ *   - status?: 'lobby' | 'playing' | 'finished'
+ */
+export async function PATCH(req: NextRequest, context: RouteContext) {
+  try {
+    const { roomId } = await context.params
+    const viewerId = await getViewerId()
+    const body = await req.json()
+
+    // Check if user is room creator
+    const isCreator = await isRoomCreator(roomId, viewerId)
+    if (!isCreator) {
+      return NextResponse.json({ error: 'Only room creator can update room' }, { status: 403 })
+    }
+
+    // Validate name length if provided
+    if (body.name && body.name.length > 50) {
+      return NextResponse.json({ error: 'Room name too long (max 50 characters)' }, { status: 400 })
+    }
+
+    // Validate status if provided
+    if (body.status && !['lobby', 'playing', 'finished'].includes(body.status)) {
+      return NextResponse.json({ error: 'Invalid status' }, { status: 400 })
+    }
+
+    const updates: {
+      name?: string
+      isLocked?: boolean
+      status?: 'lobby' | 'playing' | 'finished'
+    } = {}
+
+    if (body.name !== undefined) updates.name = body.name
+    if (body.isLocked !== undefined) updates.isLocked = body.isLocked
+    if (body.status !== undefined) updates.status = body.status
+
+    const room = await updateRoom(roomId, updates)
+
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    return NextResponse.json({ room })
+  } catch (error) {
+    console.error('Failed to update room:', error)
+    return NextResponse.json({ error: 'Failed to update room' }, { status: 500 })
+  }
+}
+
+/**
+ * DELETE /api/arcade/rooms/:roomId
+ * Delete room (creator only)
+ */
+export async function DELETE(_req: NextRequest, context: RouteContext) {
+  try {
+    const { roomId } = await context.params
+    const viewerId = await getViewerId()
+
+    // Check if user is room creator
+    const isCreator = await isRoomCreator(roomId, viewerId)
+    if (!isCreator) {
+      return NextResponse.json({ error: 'Only room creator can delete room' }, { status: 403 })
+    }
+
+    await deleteRoom(roomId)
+
+    return NextResponse.json({ success: true })
+  } catch (error) {
+    console.error('Failed to delete room:', error)
+    return NextResponse.json({ error: 'Failed to delete room' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/arcade/rooms/code/[code]/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/code/[code]/route.ts
@@ -0,0 +1,39 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import { getRoomByCode } from '@/lib/arcade/room-manager'
+import { normalizeRoomCode } from '@/lib/arcade/room-code'
+
+type RouteContext = {
+  params: Promise<{ code: string }>
+}
+
+/**
+ * GET /api/arcade/rooms/code/:code
+ * Get room by join code (for resolving codes to room IDs)
+ */
+export async function GET(_req: NextRequest, context: RouteContext) {
+  try {
+    const { code } = await context.params
+
+    // Normalize the code (uppercase, remove spaces/dashes)
+    const normalizedCode = normalizeRoomCode(code)
+
+    // Get room
+    const room = await getRoomByCode(normalizedCode)
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    // Generate redirect URL
+    const baseUrl = process.env.NEXT_PUBLIC_URL || 'http://localhost:3000'
+    const redirectUrl = `${baseUrl}/arcade/rooms/${room.id}`
+
+    return NextResponse.json({
+      roomId: room.id,
+      redirectUrl,
+      room,
+    })
+  } catch (error) {
+    console.error('Failed to find room by code:', error)
+    return NextResponse.json({ error: 'Failed to find room by code' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/arcade/rooms/current/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/current/route.ts
@@ -0,0 +1,52 @@
+import { NextResponse } from 'next/server'
+import { getUserRooms } from '@/lib/arcade/room-membership'
+import { getRoomById } from '@/lib/arcade/room-manager'
+import { getRoomMembers } from '@/lib/arcade/room-membership'
+import { getRoomActivePlayers } from '@/lib/arcade/player-manager'
+import { getViewerId } from '@/lib/viewer'
+
+/**
+ * GET /api/arcade/rooms/current
+ * Returns the user's current room (if any)
+ */
+export async function GET() {
+  try {
+    const userId = await getViewerId()
+
+    // Get all rooms user is in (should be at most 1 due to modal room enforcement)
+    const roomIds = await getUserRooms(userId)
+
+    if (roomIds.length === 0) {
+      return NextResponse.json({ room: null }, { status: 200 })
+    }
+
+    const roomId = roomIds[0]
+
+    // Get room data
+    const room = await getRoomById(roomId)
+    if (!room) {
+      return NextResponse.json({ error: 'Room not found' }, { status: 404 })
+    }
+
+    // Get members
+    const members = await getRoomMembers(roomId)
+
+    // Get active players for all members
+    const memberPlayers = await getRoomActivePlayers(roomId)
+
+    // Convert Map to object for JSON serialization
+    const memberPlayersObj: Record<string, any[]> = {}
+    for (const [uid, players] of memberPlayers.entries()) {
+      memberPlayersObj[uid] = players
+    }
+
+    return NextResponse.json({
+      room,
+      members,
+      memberPlayers: memberPlayersObj,
+    })
+  } catch (error) {
+    console.error('[Current Room API] Error:', error)
+    return NextResponse.json({ error: 'Failed to fetch current room' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/arcade/rooms/route.ts
+++ b/apps/web/src/app/api/arcade/rooms/route.ts
@@ -0,0 +1,126 @@
+import { type NextRequest, NextResponse } from 'next/server'
+import { createRoom, listActiveRooms } from '@/lib/arcade/room-manager'
+import { addRoomMember, getRoomMembers, isMember } from '@/lib/arcade/room-membership'
+import { getRoomActivePlayers } from '@/lib/arcade/player-manager'
+import { getViewerId } from '@/lib/viewer'
+import type { GameName } from '@/lib/arcade/validation'
+
+/**
+ * GET /api/arcade/rooms
+ * List all active public rooms (lobby view)
+ * Query params:
+ *   - gameName?: string - Filter by game
+ */
+export async function GET(req: NextRequest) {
+  try {
+    const { searchParams } = new URL(req.url)
+    const gameName = searchParams.get('gameName') as GameName | null
+
+    const viewerId = await getViewerId()
+    const rooms = await listActiveRooms(gameName || undefined)
+
+    // Enrich with member counts, player counts, and membership status
+    const roomsWithCounts = await Promise.all(
+      rooms.map(async (room) => {
+        const members = await getRoomMembers(room.id)
+        const playerMap = await getRoomActivePlayers(room.id)
+        const userIsMember = await isMember(room.id, viewerId)
+
+        let totalPlayers = 0
+        for (const players of playerMap.values()) {
+          totalPlayers += players.length
+        }
+
+        return {
+          id: room.id,
+          name: room.name,
+          code: room.code,
+          gameName: room.gameName,
+          status: room.status,
+          createdAt: room.createdAt,
+          creatorName: room.creatorName,
+          isLocked: room.isLocked,
+          memberCount: members.length,
+          playerCount: totalPlayers,
+          isMember: userIsMember,
+        }
+      })
+    )
+
+    return NextResponse.json({ rooms: roomsWithCounts })
+  } catch (error) {
+    console.error('Failed to fetch rooms:', error)
+    return NextResponse.json({ error: 'Failed to fetch rooms' }, { status: 500 })
+  }
+}
+
+/**
+ * POST /api/arcade/rooms
+ * Create a new room
+ * Body:
+ *   - name: string
+ *   - gameName: string
+ *   - gameConfig?: object
+ *   - ttlMinutes?: number
+ */
+export async function POST(req: NextRequest) {
+  try {
+    const viewerId = await getViewerId()
+    const body = await req.json()
+
+    // Validate required fields
+    if (!body.name || !body.gameName) {
+      return NextResponse.json(
+        { error: 'Missing required fields: name, gameName' },
+        { status: 400 }
+      )
+    }
+
+    // Validate game name
+    const validGames: GameName[] = ['matching', 'memory-quiz', 'complement-race']
+    if (!validGames.includes(body.gameName)) {
+      return NextResponse.json({ error: 'Invalid game name' }, { status: 400 })
+    }
+
+    // Validate name length
+    if (body.name.length > 50) {
+      return NextResponse.json({ error: 'Room name too long (max 50 characters)' }, { status: 400 })
+    }
+
+    // Get display name from body or generate from viewerId
+    const displayName = body.creatorName || `Guest ${viewerId.slice(-4)}`
+
+    // Create room
+    const room = await createRoom({
+      name: body.name,
+      createdBy: viewerId,
+      creatorName: displayName,
+      gameName: body.gameName,
+      gameConfig: body.gameConfig || {},
+      ttlMinutes: body.ttlMinutes,
+    })
+
+    // Add creator as first member
+    await addRoomMember({
+      roomId: room.id,
+      userId: viewerId,
+      displayName,
+      isCreator: true,
+    })
+
+    // Generate join URL
+    const baseUrl = process.env.NEXT_PUBLIC_URL || 'http://localhost:3000'
+    const joinUrl = `${baseUrl}/arcade/rooms/${room.id}`
+
+    return NextResponse.json(
+      {
+        room,
+        joinUrl,
+      },
+      { status: 201 }
+    )
+  } catch (error) {
+    console.error('Failed to create room:', error)
+    return NextResponse.json({ error: 'Failed to create room' }, { status: 500 })
+  }
+}
--- a/apps/web/src/app/api/debug/active-players/route.ts
+++ b/apps/web/src/app/api/debug/active-players/route.ts
@@ -0,0 +1,57 @@
+import { NextResponse } from 'next/server'
+import { getViewerId } from '@/lib/viewer'
+import { getActivePlayers } from '@/lib/arcade/player-manager'
+import { db, schema } from '@/db'
+import { eq } from 'drizzle-orm'
+
+/**
+ * GET /api/debug/active-players
+ * Debug endpoint to check active players for current user
+ */
+export async function GET() {
+  try {
+    const viewerId = await getViewerId()
+
+    // Get user record
+    const user = await db.query.users.findFirst({
+      where: eq(schema.users.guestId, viewerId),
+    })
+
+    if (!user) {
+      return NextResponse.json({ error: 'User not found', viewerId }, { status: 404 })
+    }
+
+    // Get ALL players for this user
+    const allPlayers = await db.query.players.findMany({
+      where: eq(schema.players.userId, user.id),
+    })
+
+    // Get active players using the helper
+    const activePlayers = await getActivePlayers(viewerId)
+
+    return NextResponse.json({
+      viewerId,
+      userId: user.id,
+      allPlayers: allPlayers.map((p) => ({
+        id: p.id,
+        name: p.name,
+        emoji: p.emoji,
+        isActive: p.isActive,
+      })),
+      activePlayers: activePlayers.map((p) => ({
+        id: p.id,
+        name: p.name,
+        emoji: p.emoji,
+        isActive: p.isActive,
+      })),
+      activeCount: activePlayers.length,
+      totalCount: allPlayers.length,
+    })
+  } catch (error) {
+    console.error('Failed to fetch active players:', error)
+    return NextResponse.json(
+      { error: 'Failed to fetch active players', details: String(error) },
+      { status: 500 }
+    )
+  }
+}
--- a/apps/web/src/app/api/download/[id]/route.ts
+++ b/apps/web/src/app/api/download/[id]/route.ts
@@ -1,10 +1,7 @@
-import { NextRequest, NextResponse } from 'next/server'
+import { type NextRequest, NextResponse } from 'next/server'
 import { assetStore } from '@/lib/asset-store'

-export async function GET(
-  request: NextRequest,
-  { params }: { params: { id: string } }
-) {
+export async function GET(_request: NextRequest, { params }: { params: { id: string } }) {
  try {
    const { id } = params

@@ -15,30 +12,35 @@ export async function GET(
    const asset = await assetStore.get(id)
    if (!asset) {
      console.log('❌ Asset not found in store')
-      return NextResponse.json({
-        error: 'Asset not found or expired'
-      }, { status: 404 })
+      return NextResponse.json(
+        {
+          error: 'Asset not found or expired',
+        },
+        { status: 404 }
+      )
    }

    console.log('✅ Asset found, serving download')

    // Return file with appropriate headers
-    return new NextResponse(asset.data, {
+    return new NextResponse(new Uint8Array(asset.data), {
      status: 200,
      headers: {
        'Content-Type': asset.mimeType,
        'Content-Disposition': `attachment; filename="${asset.filename}"`,
        'Content-Length': asset.data.length.toString(),
        'Cache-Control': 'private, no-cache, no-store, must-revalidate',
-        'Expires': '0',
-        'Pragma': 'no-cache'
-      }
+        Expires: '0',
+        Pragma: 'no-cache',
+      },
    })
-
  } catch (error) {
    console.error('❌ Download failed:', error)
-    return NextResponse.json({
-      error: 'Failed to download file'
-    }, { status: 500 })
+    return NextResponse.json(
+      {
+        error: 'Failed to download file',
+      },
+      { status: 500 }
+    )
  }
-}
+}
--- a/apps/web/src/app/api/download/assets/[id]/route.ts
+++ b/apps/web/src/app/api/download/assets/[id]/route.ts
@@ -1,19 +1,13 @@
-import { NextRequest, NextResponse } from 'next/server'
+import { type NextRequest, NextResponse } from 'next/server'
 import { assetStore } from '@/lib/asset-store'

-export async function GET(
-  request: NextRequest,
-  { params }: { params: { id: string } }
-) {
+export async function GET(_request: NextRequest, { params }: { params: { id: string } }) {
  try {
    const { id } = params

    const asset = await assetStore.get(id)
    if (!asset) {
-      return NextResponse.json(
-        { error: 'Asset not found' },
-        { status: 404 }
-      )
+      return NextResponse.json({ error: 'Asset not found' }, { status: 404 })
    }

    // Set appropriate headers for download
@@ -23,16 +17,12 @@ export async function GET(
    headers.set('Content-Length', asset.data.length.toString())
    headers.set('Cache-Control', 'no-cache, no-store, must-revalidate')

-    return new NextResponse(asset.data, {
+    return new NextResponse(new Uint8Array(asset.data), {
      status: 200,
-      headers
+      headers,
    })
-
  } catch (error) {
    console.error('Asset download error:', error)
-    return NextResponse.json(
-      { error: 'Failed to download asset' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to download asset' }, { status: 500 })
  }
-}
+}
--- a/apps/web/src/app/api/generate/route.ts
+++ b/apps/web/src/app/api/generate/route.ts
@@ -1,5 +1,5 @@
-import { NextRequest, NextResponse } from 'next/server'
 import { SorobanGenerator } from '@soroban/core'
+import { type NextRequest, NextResponse } from 'next/server'
 import path from 'path'

 // Global generator instance for better performance
@@ -36,14 +36,17 @@ export async function POST(request: NextRequest) {
    // Check dependencies before generating
    const deps = await gen.checkDependencies?.()
    if (deps && (!deps.python || !deps.typst)) {
-      return NextResponse.json({
-        error: 'Missing system dependencies',
-        details: {
-          python: deps.python ? '✅ Available' : '❌ Missing Python 3',
-          typst: deps.typst ? '✅ Available' : '❌ Missing Typst',
-          qpdf: deps.qpdf ? '✅ Available' : '⚠️ Missing qpdf (optional)'
-        }
-      }, { status: 500 })
+      return NextResponse.json(
+        {
+          error: 'Missing system dependencies',
+          details: {
+            python: deps.python ? '✅ Available' : '❌ Missing Python 3',
+            typst: deps.typst ? '✅ Available' : '❌ Missing Typst',
+            qpdf: deps.qpdf ? '✅ Available' : '⚠️ Missing qpdf (optional)',
+          },
+        },
+        { status: 500 }
+      )
    }

    // Generate flashcards using Python via TypeScript bindings
@@ -52,36 +55,38 @@ export async function POST(request: NextRequest) {

    // SorobanGenerator.generate() returns PDF data directly as Buffer
    if (!Buffer.isBuffer(result)) {
-      throw new Error('Expected PDF Buffer from generator, got: ' + typeof result)
+      throw new Error(`Expected PDF Buffer from generator, got: ${typeof result}`)
    }
    const pdfBuffer = result
    // Create filename for download
    const filename = `soroban-flashcards-${config.range || 'cards'}.pdf`

    // Return PDF directly as download
-    return new NextResponse(pdfBuffer, {
+    return new NextResponse(new Uint8Array(pdfBuffer), {
      headers: {
        'Content-Type': 'application/pdf',
        'Content-Disposition': `attachment; filename="${filename}"`,
-        'Content-Length': pdfBuffer.length.toString()
-      }
+        'Content-Length': pdfBuffer.length.toString(),
+      },
    })
-
  } catch (error) {
    console.error('❌ Generation failed:', error)

-    return NextResponse.json({
-      error: 'Failed to generate flashcards',
-      details: error instanceof Error ? error.message : 'Unknown error',
-      success: false
-    }, { status: 500 })
+    return NextResponse.json(
+      {
+        error: 'Failed to generate flashcards',
+        details: error instanceof Error ? error.message : 'Unknown error',
+        success: false,
+      },
+      { status: 500 }
+    )
  }
 }

 // Helper functions to calculate metadata
-function calculateCardCount(range: string, step: number): number {
+function _calculateCardCount(range: string, step: number): number {
  if (range.includes('-')) {
-    const [start, end] = range.split('-').map(n => parseInt(n) || 0)
+    const [start, end] = range.split('-').map((n) => parseInt(n, 10) || 0)
    return Math.floor((end - start + 1) / step)
  }

@@ -92,9 +97,9 @@ function calculateCardCount(range: string, step: number): number {
  return 1
 }

-function generateNumbersFromRange(range: string, step: number): number[] {
+function _generateNumbersFromRange(range: string, step: number): number[] {
  if (range.includes('-')) {
-    const [start, end] = range.split('-').map(n => parseInt(n) || 0)
+    const [start, end] = range.split('-').map((n) => parseInt(n, 10) || 0)
    const numbers: number[] = []
    for (let i = start; i <= end; i += step) {
      numbers.push(i)
@@ -104,26 +109,29 @@ function generateNumbersFromRange(range: string, step: number): number[] {
  }

  if (range.includes(',')) {
-    return range.split(',').map(n => parseInt(n.trim()) || 0)
+    return range.split(',').map((n) => parseInt(n.trim(), 10) || 0)
  }

-  return [parseInt(range) || 0]
+  return [parseInt(range, 10) || 0]
 }

 // Health check endpoint
 export async function GET() {
  try {
    const gen = await getGenerator()
-    const deps = await gen.checkDependencies?.() || { python: true, typst: true, qpdf: true }
+    const deps = (await gen.checkDependencies?.()) || { python: true, typst: true, qpdf: true }

    return NextResponse.json({
      status: 'healthy',
-      dependencies: deps
+      dependencies: deps,
    })
  } catch (error) {
-    return NextResponse.json({
-      status: 'unhealthy',
-      error: error instanceof Error ? error.message : 'Unknown error'
-    }, { status: 500 })
+    return NextResponse.json(
+      {
+        status: 'unhealthy',
+        error: error instanceof Error ? error.message : 'Unknown error',
+      },
+      { status: 500 }
+    )
  }
-}
+}
--- a/apps/web/src/app/api/players/[id]/route.ts
+++ b/apps/web/src/app/api/players/[id]/route.ts
@@ -1,16 +1,13 @@
-import { NextRequest, NextResponse } from 'next/server'
+import { and, eq } from 'drizzle-orm'
+import { type NextRequest, NextResponse } from 'next/server'
 import { db, schema } from '@/db'
 import { getViewerId } from '@/lib/viewer'
-import { eq, and } from 'drizzle-orm'

 /**
 * PATCH /api/players/[id]
 * Update a player (only if it belongs to the current viewer)
 */
-export async function PATCH(
-  req: NextRequest,
-  { params }: { params: { id: string } }
-) {
+export async function PATCH(req: NextRequest, { params }: { params: { id: string } }) {
  try {
    const viewerId = await getViewerId()
    const body = await req.json()
@@ -21,10 +18,7 @@ export async function PATCH(
    })

    if (!user) {
-      return NextResponse.json(
-        { error: 'User not found' },
-        { status: 404 }
-      )
+      return NextResponse.json({ error: 'User not found' }, { status: 404 })
    }

    // Check if user has an active arcade session
@@ -39,7 +33,7 @@ export async function PATCH(
          {
            error: 'Cannot modify active players during an active game session',
            activeGame: activeSession.currentGame,
-            gameUrl: activeSession.gameUrl
+            gameUrl: activeSession.gameUrl,
          },
          { status: 403 }
        )
@@ -57,28 +51,17 @@ export async function PATCH(
        ...(body.isActive !== undefined && { isActive: body.isActive }),
        // userId is explicitly NOT included - it comes from session
      })
-      .where(
-        and(
-          eq(schema.players.id, params.id),
-          eq(schema.players.userId, user.id)
-        )
-      )
+      .where(and(eq(schema.players.id, params.id), eq(schema.players.userId, user.id)))
      .returning()

    if (!updatedPlayer) {
-      return NextResponse.json(
-        { error: 'Player not found or unauthorized' },
-        { status: 404 }
-      )
+      return NextResponse.json({ error: 'Player not found or unauthorized' }, { status: 404 })
    }

    return NextResponse.json({ player: updatedPlayer })
  } catch (error) {
    console.error('Failed to update player:', error)
-    return NextResponse.json(
-      { error: 'Failed to update player' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to update player' }, { status: 500 })
  }
 }

@@ -86,10 +69,7 @@ export async function PATCH(
 * DELETE /api/players/[id]
 * Delete a player (only if it belongs to the current viewer)
 */
-export async function DELETE(
-  req: NextRequest,
-  { params }: { params: { id: string } }
-) {
+export async function DELETE(_req: NextRequest, { params }: { params: { id: string } }) {
  try {
    const viewerId = await getViewerId()

@@ -99,36 +79,22 @@ export async function DELETE(
    })

    if (!user) {
-      return NextResponse.json(
-        { error: 'User not found' },
-        { status: 404 }
-      )
+      return NextResponse.json({ error: 'User not found' }, { status: 404 })
    }

    // Delete player (only if it belongs to this user)
    const [deletedPlayer] = await db
      .delete(schema.players)
-      .where(
-        and(
-          eq(schema.players.id, params.id),
-          eq(schema.players.userId, user.id)
-        )
-      )
+      .where(and(eq(schema.players.id, params.id), eq(schema.players.userId, user.id)))
      .returning()

    if (!deletedPlayer) {
-      return NextResponse.json(
-        { error: 'Player not found or unauthorized' },
-        { status: 404 }
-      )
+      return NextResponse.json({ error: 'Player not found or unauthorized' }, { status: 404 })
    }

    return NextResponse.json({ success: true, player: deletedPlayer })
  } catch (error) {
    console.error('Failed to delete player:', error)
-    return NextResponse.json(
-      { error: 'Failed to delete player' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to delete player' }, { status: 500 })
  }
 }
--- a/apps/web/src/app/api/players/tests/arcade-session-validation.e2e.test.ts
+++ b/apps/web/src/app/api/players/tests/arcade-session-validation.e2e.test.ts
@@ -2,11 +2,11 @@
 * @vitest-environment node
 */

-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { db, schema } from '../../../../db'
 import { eq } from 'drizzle-orm'
-import { PATCH } from '../[id]/route'
 import { NextRequest } from 'next/server'
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { db, schema } from '../../../../db'
+import { PATCH } from '../[id]/route'

 /**
 * Arcade Session Validation E2E Tests
@@ -23,10 +23,7 @@ describe('PATCH /api/players/[id] - Arcade Session Validation', () => {
  beforeEach(async () => {
    // Create a test user with unique guest ID
    testGuestId = `test-guest-${Date.now()}-${Math.random().toString(36).slice(2)}`
-    const [user] = await db
-      .insert(schema.users)
-      .values({ guestId: testGuestId })
-      .returning()
+    const [user] = await db.insert(schema.users).values({ guestId: testGuestId }).returning()
    testUserId = user.id

    // Create a test player
@@ -66,17 +63,14 @@ describe('PATCH /api/players/[id] - Arcade Session Validation', () => {
    })

    // Mock request to change isActive
-    const mockRequest = new NextRequest(
-      `http://localhost:3000/api/players/${testPlayerId}`,
-      {
-        method: 'PATCH',
-        headers: {
-          'Content-Type': 'application/json',
-          Cookie: `guest_id=${testGuestId}`,
-        },
-        body: JSON.stringify({ isActive: true }),
-      }
-    )
+    const mockRequest = new NextRequest(`http://localhost:3000/api/players/${testPlayerId}`, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/json',
+        Cookie: `guest_id=${testGuestId}`,
+      },
+      body: JSON.stringify({ isActive: true }),
+    })

    // Mock getViewerId by setting cookie
    const response = await PATCH(mockRequest, { params: { id: testPlayerId } })
@@ -99,17 +93,14 @@ describe('PATCH /api/players/[id] - Arcade Session Validation', () => {
    // No arcade session created

    // Mock request to change isActive
-    const mockRequest = new NextRequest(
-      `http://localhost:3000/api/players/${testPlayerId}`,
-      {
-        method: 'PATCH',
-        headers: {
-          'Content-Type': 'application/json',
-          Cookie: `guest_id=${testGuestId}`,
-        },
-        body: JSON.stringify({ isActive: true }),
-      }
-    )
+    const mockRequest = new NextRequest(`http://localhost:3000/api/players/${testPlayerId}`, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/json',
+        Cookie: `guest_id=${testGuestId}`,
+      },
+      body: JSON.stringify({ isActive: true }),
+    })

    const response = await PATCH(mockRequest, { params: { id: testPlayerId } })
    const data = await response.json()
@@ -141,21 +132,18 @@ describe('PATCH /api/players/[id] - Arcade Session Validation', () => {
    })

    // Mock request to change name/emoji/color (NOT isActive)
-    const mockRequest = new NextRequest(
-      `http://localhost:3000/api/players/${testPlayerId}`,
-      {
-        method: 'PATCH',
-        headers: {
-          'Content-Type': 'application/json',
-          Cookie: `guest_id=${testGuestId}`,
-        },
-        body: JSON.stringify({
-          name: 'Updated Name',
-          emoji: '🎉',
-          color: '#ff0000',
-        }),
-      }
-    )
+    const mockRequest = new NextRequest(`http://localhost:3000/api/players/${testPlayerId}`, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/json',
+        Cookie: `guest_id=${testGuestId}`,
+      },
+      body: JSON.stringify({
+        name: 'Updated Name',
+        emoji: '🎉',
+        color: '#ff0000',
+      }),
+    })

    const response = await PATCH(mockRequest, { params: { id: testPlayerId } })
    const data = await response.json()
@@ -194,17 +182,14 @@ describe('PATCH /api/players/[id] - Arcade Session Validation', () => {
    await db.delete(schema.arcadeSessions).where(eq(schema.arcadeSessions.userId, testGuestId))

    // Mock request to change isActive
-    const mockRequest = new NextRequest(
-      `http://localhost:3000/api/players/${testPlayerId}`,
-      {
-        method: 'PATCH',
-        headers: {
-          'Content-Type': 'application/json',
-          Cookie: `guest_id=${testGuestId}`,
-        },
-        body: JSON.stringify({ isActive: true }),
-      }
-    )
+    const mockRequest = new NextRequest(`http://localhost:3000/api/players/${testPlayerId}`, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/json',
+        Cookie: `guest_id=${testGuestId}`,
+      },
+      body: JSON.stringify({ isActive: true }),
+    })

    const response = await PATCH(mockRequest, { params: { id: testPlayerId } })
    const data = await response.json()
@@ -242,33 +227,27 @@ describe('PATCH /api/players/[id] - Arcade Session Validation', () => {
    })

    // Try to toggle player1 (inactive -> active) - should fail
-    const request1 = new NextRequest(
-      `http://localhost:3000/api/players/${testPlayerId}`,
-      {
-        method: 'PATCH',
-        headers: {
-          'Content-Type': 'application/json',
-          Cookie: `guest_id=${testGuestId}`,
-        },
-        body: JSON.stringify({ isActive: true }),
-      }
-    )
+    const request1 = new NextRequest(`http://localhost:3000/api/players/${testPlayerId}`, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/json',
+        Cookie: `guest_id=${testGuestId}`,
+      },
+      body: JSON.stringify({ isActive: true }),
+    })

    const response1 = await PATCH(request1, { params: { id: testPlayerId } })
    expect(response1.status).toBe(403)

    // Try to toggle player2 (active -> inactive) - should also fail
-    const request2 = new NextRequest(
-      `http://localhost:3000/api/players/${player2.id}`,
-      {
-        method: 'PATCH',
-        headers: {
-          'Content-Type': 'application/json',
-          Cookie: `guest_id=${testGuestId}`,
-        },
-        body: JSON.stringify({ isActive: false }),
-      }
-    )
+    const request2 = new NextRequest(`http://localhost:3000/api/players/${player2.id}`, {
+      method: 'PATCH',
+      headers: {
+        'Content-Type': 'application/json',
+        Cookie: `guest_id=${testGuestId}`,
+      },
+      body: JSON.stringify({ isActive: false }),
+    })

    const response2 = await PATCH(request2, { params: { id: player2.id } })
    expect(response2.status).toBe(403)
--- a/apps/web/src/app/api/players/route.ts
+++ b/apps/web/src/app/api/players/route.ts
@@ -1,7 +1,7 @@
-import { NextRequest, NextResponse } from 'next/server'
+import { eq } from 'drizzle-orm'
+import { type NextRequest, NextResponse } from 'next/server'
 import { db, schema } from '@/db'
 import { getViewerId } from '@/lib/viewer'
-import { eq } from 'drizzle-orm'

 /**
 * GET /api/players
@@ -23,10 +23,7 @@ export async function GET() {
    return NextResponse.json({ players })
  } catch (error) {
    console.error('Failed to fetch players:', error)
-    return NextResponse.json(
-      { error: 'Failed to fetch players' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to fetch players' }, { status: 500 })
  }
 }

@@ -65,10 +62,7 @@ export async function POST(req: NextRequest) {
    return NextResponse.json({ player }, { status: 201 })
  } catch (error) {
    console.error('Failed to create player:', error)
-    return NextResponse.json(
-      { error: 'Failed to create player' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to create player' }, { status: 500 })
  }
 }

--- a/apps/web/src/app/api/preview/route.ts
+++ b/apps/web/src/app/api/preview/route.ts
@@ -1,164 +0,0 @@
-import { NextRequest, NextResponse } from 'next/server'
-import { generateSorobanSVG } from '@/lib/typst-soroban'
-
-export async function POST(request: NextRequest) {
-  try {
-    const config = await request.json()
-
-    // Debug: log the received config
-    console.log('🔍 Preview config:', JSON.stringify(config, null, 2))
-
-    // Ensure range is set with a default
-    if (!config.range) {
-      config.range = '0-9'
-    }
-
-    // For preview, limit to a few numbers and use SVG format for fast rendering
-    const previewConfig = {
-      ...config,
-      range: getPreviewRange(config.range),
-      format: 'svg', // Use SVG format for preview
-      cardsPerPage: 6 // Standard card layout
-    }
-
-    console.log('🔍 Processed preview config:', JSON.stringify(previewConfig, null, 2))
-
-    // Generate real SVG preview using typst.ts
-    console.log('🚀 Generating soroban SVG preview via typst.ts')
-
-    try {
-      // Parse the numbers from the range for individual cards
-      const numbers = parseNumbersFromRange(getPreviewRange(config.range))
-      console.log('🔍 Generating individual SVGs for numbers:', numbers)
-
-      // Generate individual SVGs for each number using typst.ts
-      const samples = []
-      for (const number of numbers) {
-        try {
-          const typstConfig = {
-            number: number,
-            beadShape: previewConfig.beadShape || 'diamond',
-            colorScheme: previewConfig.colorScheme || 'place-value',
-            hideInactiveBeads: previewConfig.hideInactiveBeads || false,
-            scaleFactor: previewConfig.scaleFactor || 1.0,
-            width: '200pt',
-            height: '250pt'
-          }
-          console.log(`🔍 Generating typst.ts SVG for number ${number}`)
-          const svg = await generateSorobanSVG(typstConfig)
-          console.log(`✅ Generated typst.ts SVG for ${number}, length: ${svg.length}`)
-          samples.push({
-            number,
-            front: svg,
-            back: number.toString()
-          })
-        } catch (error) {
-          console.error(`❌ Failed to generate SVG for number ${number}:`, error instanceof Error ? error.message : error)
-          samples.push({
-            number,
-            front: `<svg width="200" height="300" viewBox="0 0 200 300" xmlns="http://www.w3.org/2000/svg">
-              <rect x="10" y="10" width="180" height="280" fill="none" stroke="#ccc" stroke-width="2"/>
-              <line x1="20" y1="150" x2="180" y2="150" stroke="#ccc" stroke-width="2"/>
-              <text x="100" y="160" text-anchor="middle" font-size="24" fill="#666">SVG Error</text>
-              <text x="100" y="180" text-anchor="middle" font-size="16" fill="#999">${number}</text>
-            </svg>`,
-            back: number.toString()
-          })
-        }
-      }
-
-      return NextResponse.json({
-        count: numbers.length,
-        samples,
-        note: 'Real individual SVGs generated by typst.ts'
-      })
-
-    } catch (error) {
-      console.error('⚠️ Typst.ts SVG generation failed, using fallback preview:', error instanceof Error ? error.message : error)
-      return NextResponse.json(getMockPreviewData(config))
-    }
-
-  } catch (error) {
-    console.error('❌ Preview generation failed:', error)
-
-    // Always fall back to mock data for preview
-    const config = await request.json().catch(() => ({ range: '0-9' }))
-    return NextResponse.json(getMockPreviewData(config))
-  }
-}
-
-// Helper function to parse numbers from range string
-function parseNumbersFromRange(range: string): number[] {
-  if (!range) return [0, 1, 2]
-
-  if (range.includes('-')) {
-    const [start] = range.split('-')
-    const startNum = parseInt(start) || 0
-    return [startNum, startNum + 1, startNum + 2]
-  }
-
-  if (range.includes(',')) {
-    return range.split(',').slice(0, 3).map(n => parseInt(n.trim()) || 0)
-  }
-
-  const num = parseInt(range) || 0
-  return [num, num + 1, num + 2]
-}
-
-// Helper function to limit range for preview
-function getPreviewRange(range: string): string {
-  if (!range) return '0,1,2'
-
-  if (range.includes('-')) {
-    const [start] = range.split('-')
-    const startNum = parseInt(start) || 0
-    return `${startNum},${startNum + 1},${startNum + 2}`
-  }
-
-  if (range.includes(',')) {
-    const numbers = range.split(',').slice(0, 3)
-    return numbers.join(',')
-  }
-
-  return range
-}
-
-// Mock preview data for development and fallback
-function getMockPreviewData(config: any) {
-  const range = config.range || '0-9'
-  let numbers: number[]
-
-  if (range.includes('-')) {
-    const [start] = range.split('-')
-    const startNum = parseInt(start) || 0
-    numbers = [startNum, startNum + 1, startNum + 2]
-  } else if (range.includes(',')) {
-    numbers = range.split(',').slice(0, 3).map((n: string) => parseInt(n.trim()) || 0)
-  } else {
-    const num = parseInt(range) || 0
-    numbers = [num, num + 1, num + 2]
-  }
-
-  return {
-    count: numbers.length,
-    samples: numbers.map(number => ({
-      number,
-      front: `<svg width="200" height="300" viewBox="0 0 200 300" xmlns="http://www.w3.org/2000/svg">
-        <rect x="10" y="10" width="180" height="280" fill="none" stroke="#ccc" stroke-width="2"/>
-        <line x1="20" y1="150" x2="180" y2="150" stroke="#ccc" stroke-width="2"/>
-        <text x="100" y="160" text-anchor="middle" font-size="24" fill="#666">Preview Error</text>
-        <text x="100" y="180" text-anchor="middle" font-size="16" fill="#999">${number}</text>
-      </svg>`,
-      back: number.toString()
-    }))
-  }
-}
-
-// Health check endpoint
-export async function GET() {
-  return NextResponse.json({
-    status: 'healthy',
-    endpoint: 'preview',
-    message: 'Preview API is running'
-  })
-}
--- a/apps/web/src/app/api/typst-svg/route.ts
+++ b/apps/web/src/app/api/typst-svg/route.ts
@@ -1,154 +0,0 @@
-import { NextRequest, NextResponse } from 'next/server'
-import { $typst } from '@myriaddreamin/typst.ts/dist/esm/contrib/snippet.mjs'
-import fs from 'fs'
-import path from 'path'
-
-export interface TypstSVGRequest {
-  number: number
-  beadShape?: 'diamond' | 'circle' | 'square'
-  colorScheme?: 'monochrome' | 'place-value' | 'heaven-earth' | 'alternating'
-  colorPalette?: 'default' | 'colorblind' | 'mnemonic' | 'grayscale' | 'nature'
-  hideInactiveBeads?: boolean
-  showEmptyColumns?: boolean
-  columns?: number | 'auto'
-  scaleFactor?: number
-  width?: string
-  height?: string
-  fontSize?: string
-  fontFamily?: string
-  transparent?: boolean
-  coloredNumerals?: boolean
-}
-
-// Cache for template content
-let flashcardsTemplate: string | null = null
-
-async function getFlashcardsTemplate(): Promise<string> {
-  if (flashcardsTemplate) {
-    return flashcardsTemplate
-  }
-
-  try {
-    const { getTemplatePath } = require('@soroban/templates')
-    const templatePath = getTemplatePath('flashcards.typ')
-    flashcardsTemplate = fs.readFileSync(templatePath, 'utf-8')
-    return flashcardsTemplate
-  } catch (error) {
-    console.error('Failed to load flashcards template:', error)
-    throw new Error('Template loading failed')
-  }
-}
-
-function processBeadAnnotations(svg: string): string {
-  const { extractBeadAnnotations } = require('@soroban/templates')
-  const result = extractBeadAnnotations(svg)
-
-  if (result.warnings.length > 0) {
-    console.log('ℹ️ SVG bead processing warnings:', result.warnings)
-  }
-
-  console.log(`🔗 Processed ${result.count} bead links into data attributes`)
-  return result.processedSVG
-}
-
-function createTypstContent(config: TypstSVGRequest, template: string): string {
-  const {
-    number,
-    beadShape = 'diamond',
-    colorScheme = 'place-value',
-    colorPalette = 'default',
-    hideInactiveBeads = false,
-    showEmptyColumns = false,
-    columns = 'auto',
-    scaleFactor = 1.0,
-    width = '120pt',
-    height = '160pt',
-    fontSize = '48pt',
-    fontFamily = 'DejaVu Sans',
-    transparent = false,
-    coloredNumerals = false
-  } = config
-
-  return `
-${template}
-
-#set page(
-  width: ${width},
-  height: ${height},
-  margin: 0pt,
-  fill: ${transparent ? 'none' : 'white'}
-)
-
-#set text(font: "${fontFamily}", size: ${fontSize}, fallback: true)
-
-#align(center + horizon)[
-  #box(
-    width: ${width} - 2 * (${width} * 0.05),
-    height: ${height} - 2 * (${height} * 0.05)
-  )[
-    #align(center + horizon)[
-      #scale(x: ${scaleFactor * 100}%, y: ${scaleFactor * 100}%)[
-        #draw-soroban(
-          ${number},
-          columns: ${columns},
-          show-empty: ${showEmptyColumns},
-          hide-inactive: ${hideInactiveBeads},
-          bead-shape: "${beadShape}",
-          color-scheme: "${colorScheme}",
-          color-palette: "${colorPalette}",
-          base-size: 1.0
-        )
-      ]
-    ]
-  ]
-]
-`
-}
-
-export async function POST(request: NextRequest) {
-  try {
-    const config: TypstSVGRequest = await request.json()
-
-    console.log('🎨 Generating typst.ts SVG for number:', config.number)
-
-    // Load template
-    const template = await getFlashcardsTemplate()
-
-    // Create typst content
-    const typstContent = createTypstContent(config, template)
-
-    // Generate SVG using typst.ts
-    const rawSvg = await $typst.svg({ mainContent: typstContent })
-
-    // Post-process to convert bead annotations to data attributes
-    const svg = processBeadAnnotations(rawSvg)
-
-    console.log('✅ Generated and processed typst.ts SVG, length:', svg.length)
-
-    return NextResponse.json({
-      svg,
-      success: true,
-      number: config.number
-    })
-
-  } catch (error) {
-    console.error('❌ Typst SVG generation failed:', error)
-
-    return NextResponse.json(
-      {
-        error: error instanceof Error ? error.message : 'Unknown error',
-        success: false
-      },
-      { status: 500 }
-    )
-  }
-}
-
-// Health check
-export async function GET() {
-  return NextResponse.json({
-    status: 'healthy',
-    endpoint: 'typst-svg',
-    message: 'Typst.ts SVG generation API is running'
-  })
-}
--- a/apps/web/src/app/api/typst-template/route.ts
+++ b/apps/web/src/app/api/typst-template/route.ts
@@ -1,25 +0,0 @@
-import { NextResponse } from 'next/server'
-import fs from 'fs'
-import { getTemplatePath } from '@soroban/templates'
-
-// API endpoint to serve the flashcards.typ template content
-export async function GET() {
-  try {
-    const templatePath = getTemplatePath('flashcards.typ');
-    const flashcardsTemplate = fs.readFileSync(templatePath, 'utf-8')
-
-    return NextResponse.json({
-      template: flashcardsTemplate,
-      success: true
-    })
-  } catch (error) {
-    console.error('Failed to load typst template:', error)
-    return NextResponse.json(
-      {
-        error: 'Failed to load template',
-        success: false
-      },
-      { status: 500 }
-    )
-  }
-}
--- a/apps/web/src/app/api/user-stats/route.ts
+++ b/apps/web/src/app/api/user-stats/route.ts
@@ -1,7 +1,7 @@
-import { NextRequest, NextResponse } from 'next/server'
+import { eq } from 'drizzle-orm'
+import { type NextRequest, NextResponse } from 'next/server'
 import { db, schema } from '@/db'
 import { getViewerId } from '@/lib/viewer'
-import { eq } from 'drizzle-orm'

 /**
 * GET /api/user-stats
@@ -49,10 +49,7 @@ export async function GET() {
    return NextResponse.json({ stats })
  } catch (error) {
    console.error('Failed to fetch user stats:', error)
-    return NextResponse.json(
-      { error: 'Failed to fetch user stats' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to fetch user stats' }, { status: 500 })
  }
 }

@@ -83,7 +80,7 @@ export async function PATCH(req: NextRequest) {
    }

    // Get existing stats
-    let stats = await db.query.userStats.findFirst({
+    const stats = await db.query.userStats.findFirst({
      where: eq(schema.userStats.userId, user.id),
    })

@@ -118,9 +115,6 @@ export async function PATCH(req: NextRequest) {
    }
  } catch (error) {
    console.error('Failed to update user stats:', error)
-    return NextResponse.json(
-      { error: 'Failed to update user stats' },
-      { status: 500 }
-    )
+    return NextResponse.json({ error: 'Failed to update user stats' }, { status: 500 })
  }
 }
--- a/apps/web/src/app/api/viewer/route.ts
+++ b/apps/web/src/app/api/viewer/route.ts
@@ -10,10 +10,7 @@ export async function GET() {
  try {
    const viewerId = await getViewerId()
    return NextResponse.json({ viewerId })
-  } catch (error) {
-    return NextResponse.json(
-      { error: 'No valid viewer session found' },
-      { status: 401 }
-    )
+  } catch (_error) {
+    return NextResponse.json({ error: 'No valid viewer session found' }, { status: 401 })
  }
 }
--- a/apps/web/src/app/arcade-rooms/[roomId]/page.tsx
+++ b/apps/web/src/app/arcade-rooms/[roomId]/page.tsx
@@ -0,0 +1,665 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import { useParams, useRouter } from 'next/navigation'
+import { io, type Socket } from 'socket.io-client'
+import { css } from '../../../../styled-system/css'
+import { PageWithNav } from '@/components/PageWithNav'
+import { useViewerId } from '@/hooks/useViewerId'
+
+interface Room {
+  id: string
+  code: string
+  name: string
+  gameName: string
+  status: 'lobby' | 'playing' | 'finished'
+  createdBy: string
+  creatorName: string
+  isLocked: boolean
+}
+
+interface Member {
+  id: string
+  userId: string
+  displayName: string
+  isCreator: boolean
+  isOnline: boolean
+  joinedAt: Date
+}
+
+interface Player {
+  id: string
+  userId: string
+  name: string
+  emoji: string
+  color: string
+  isActive: boolean
+}
+
+export default function RoomDetailPage() {
+  const params = useParams()
+  const router = useRouter()
+  const roomId = params.roomId as string
+  const { data: guestId } = useViewerId()
+
+  const [room, setRoom] = useState<Room | null>(null)
+  const [members, setMembers] = useState<Member[]>([])
+  const [memberPlayers, setMemberPlayers] = useState<Record<string, Player[]>>({})
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<string | null>(null)
+  const [socket, setSocket] = useState<Socket | null>(null)
+  const [isConnected, setIsConnected] = useState(false)
+
+  useEffect(() => {
+    fetchRoom()
+  }, [roomId])
+
+  useEffect(() => {
+    if (!guestId || !roomId) return
+
+    // Connect to socket
+    const sock = io({ path: '/api/socket' })
+    setSocket(sock)
+
+    sock.on('connect', () => {
+      setIsConnected(true)
+      // Join the room
+      sock.emit('join-room', { roomId, userId: guestId })
+    })
+
+    sock.on('disconnect', () => {
+      setIsConnected(false)
+    })
+
+    sock.on('room-joined', (data) => {
+      console.log('Joined room:', data)
+      if (data.members) {
+        setMembers(data.members)
+      }
+      if (data.memberPlayers) {
+        setMemberPlayers(data.memberPlayers)
+      }
+    })
+
+    sock.on('member-joined', (data) => {
+      console.log('Member joined:', data)
+      if (data.members) {
+        setMembers(data.members)
+      }
+      if (data.memberPlayers) {
+        setMemberPlayers(data.memberPlayers)
+      }
+    })
+
+    sock.on('member-left', (data) => {
+      console.log('Member left:', data)
+      if (data.members) {
+        setMembers(data.members)
+      }
+      if (data.memberPlayers) {
+        setMemberPlayers(data.memberPlayers)
+      }
+    })
+
+    sock.on('room-error', (error) => {
+      console.error('Room error:', error)
+      setError(error.error)
+    })
+
+    sock.on('room-players-updated', (data) => {
+      console.log('Room players updated:', data)
+      if (data.memberPlayers) {
+        setMemberPlayers(data.memberPlayers)
+      }
+    })
+
+    return () => {
+      sock.emit('leave-room', { roomId, userId: guestId })
+      sock.disconnect()
+    }
+  }, [roomId, guestId])
+
+  // Notify room when window regains focus (user might have changed players in another tab)
+  useEffect(() => {
+    if (!socket || !guestId || !roomId) return
+
+    const handleFocus = () => {
+      console.log('Window focused, notifying room of potential player changes')
+      socket.emit('players-updated', { roomId, userId: guestId })
+    }
+
+    window.addEventListener('focus', handleFocus)
+    return () => window.removeEventListener('focus', handleFocus)
+  }, [socket, roomId, guestId])
+
+  const fetchRoom = async () => {
+    try {
+      setLoading(true)
+      const response = await fetch(`/api/arcade/rooms/${roomId}`)
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`)
+      }
+      const data = await response.json()
+      setRoom(data.room)
+      setMembers(data.members || [])
+      setMemberPlayers(data.memberPlayers || {})
+      setError(null)
+    } catch (err) {
+      console.error('Failed to fetch room:', err)
+      setError('Failed to load room')
+    } finally {
+      setLoading(false)
+    }
+  }
+
+  const startGame = () => {
+    if (!room) return
+    // Navigate to the room game page
+    router.push('/arcade/room')
+  }
+
+  const joinRoom = async () => {
+    try {
+      const response = await fetch(`/api/arcade/rooms/${roomId}/join`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ displayName: 'Player' }),
+      })
+
+      if (!response.ok) {
+        const errorData = await response.json()
+
+        // Handle specific room membership conflict
+        if (errorData.code === 'ROOM_MEMBERSHIP_CONFLICT') {
+          alert(errorData.userMessage || errorData.message)
+          // Refresh the page to update room state
+          await fetchRoom()
+          return
+        }
+
+        throw new Error(errorData.error || `HTTP ${response.status}`)
+      }
+
+      const data = await response.json()
+
+      // Show notification if user was auto-removed from other rooms
+      if (data.autoLeave) {
+        console.log(`[Room Join] ${data.autoLeave.message}`)
+        // Could show a toast notification here in the future
+      }
+
+      // Refresh room data to update membership UI
+      await fetchRoom()
+    } catch (err) {
+      console.error('Failed to join room:', err)
+      alert('Failed to join room')
+    }
+  }
+
+  const leaveRoom = async () => {
+    try {
+      const response = await fetch(`/api/arcade/rooms/${roomId}/leave`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+      })
+
+      if (!response.ok) {
+        const errorData = await response.json()
+        throw new Error(errorData.error || `HTTP ${response.status}`)
+      }
+
+      // Navigate to arcade home after successfully leaving
+      router.push('/arcade')
+    } catch (err) {
+      console.error('Failed to leave room:', err)
+      alert('Failed to leave room')
+    }
+  }
+
+  if (loading) {
+    return (
+      <PageWithNav>
+        <div
+          className={css({
+            minH: 'calc(100vh - 80px)',
+            bg: 'linear-gradient(135deg, #0f0f23 0%, #1a1a3a 50%, #2d1b69 100%)',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            color: 'white',
+            fontSize: 'xl',
+          })}
+        >
+          Loading room...
+        </div>
+      </PageWithNav>
+    )
+  }
+
+  if (error || !room) {
+    return (
+      <PageWithNav>
+        <div
+          className={css({
+            minH: 'calc(100vh - 80px)',
+            bg: 'linear-gradient(135deg, #0f0f23 0%, #1a1a3a 50%, #2d1b69 100%)',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            p: '8',
+          })}
+        >
+          <div
+            className={css({
+              bg: 'rgba(255, 255, 255, 0.05)',
+              backdropFilter: 'blur(10px)',
+              border: '1px solid rgba(255, 255, 255, 0.1)',
+              rounded: 'lg',
+              p: '12',
+              textAlign: 'center',
+              maxW: '500px',
+            })}
+          >
+            <p className={css({ fontSize: 'xl', color: 'white', mb: '4' })}>
+              {error || 'Room not found'}
+            </p>
+            <button
+              onClick={() => router.push('/arcade-rooms')}
+              className={css({
+                px: '6',
+                py: '3',
+                bg: '#3b82f6',
+                color: 'white',
+                rounded: 'lg',
+                fontWeight: '600',
+                cursor: 'pointer',
+                _hover: { bg: '#2563eb' },
+              })}
+            >
+              Back to Rooms
+            </button>
+          </div>
+        </div>
+      </PageWithNav>
+    )
+  }
+
+  const onlineMembers = members.filter((m) => m.isOnline)
+
+  // Check if current user is a member
+  const isMember = members.some((m) => m.userId === guestId)
+
+  // Calculate union of all active players in the room
+  const allPlayers: Player[] = []
+  const playerIds = new Set<string>()
+
+  for (const userId in memberPlayers) {
+    for (const player of memberPlayers[userId]) {
+      if (!playerIds.has(player.id)) {
+        playerIds.add(player.id)
+        allPlayers.push(player)
+      }
+    }
+  }
+
+  return (
+    <PageWithNav>
+      <div
+        className={css({
+          minH: 'calc(100vh - 80px)',
+          bg: 'linear-gradient(135deg, #0f0f23 0%, #1a1a3a 50%, #2d1b69 100%)',
+          p: '8',
+        })}
+      >
+        <div className={css({ maxW: '1000px', mx: 'auto' })}>
+          {/* Header */}
+          <div
+            className={css({
+              bg: 'rgba(255, 255, 255, 0.05)',
+              backdropFilter: 'blur(10px)',
+              border: '1px solid rgba(255, 255, 255, 0.1)',
+              rounded: 'lg',
+              p: '8',
+              mb: '6',
+            })}
+          >
+            <div className={css({ mb: '4' })}>
+              <button
+                onClick={() => router.push('/arcade-rooms')}
+                className={css({
+                  display: 'inline-flex',
+                  alignItems: 'center',
+                  gap: '2',
+                  color: '#a0a0ff',
+                  fontSize: 'sm',
+                  cursor: 'pointer',
+                  _hover: { color: '#60a5fa' },
+                  mb: '3',
+                })}
+              >
+                ← Back to Rooms
+              </button>
+            </div>
+            <div
+              className={css({
+                display: 'flex',
+                justifyContent: 'space-between',
+                alignItems: 'center',
+                mb: '4',
+              })}
+            >
+              <div>
+                <h1
+                  className={css({ fontSize: '3xl', fontWeight: 'bold', color: 'white', mb: '2' })}
+                >
+                  {room.name}
+                </h1>
+                <div
+                  className={css({ display: 'flex', gap: '4', color: '#a0a0ff', fontSize: 'sm' })}
+                >
+                  <span>🎮 {room.gameName}</span>
+                  <span>👤 Host: {room.creatorName}</span>
+                  <span
+                    className={css({
+                      px: '3',
+                      py: '1',
+                      bg: 'rgba(255, 255, 255, 0.1)',
+                      color: '#fbbf24',
+                      rounded: 'full',
+                      fontWeight: '600',
+                      fontFamily: 'monospace',
+                    })}
+                  >
+                    Code: {room.code}
+                  </span>
+                </div>
+              </div>
+              <div className={css({ display: 'flex', gap: '3', alignItems: 'center' })}>
+                <div
+                  className={css({
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '2',
+                    px: '3',
+                    py: '2',
+                    bg: isConnected ? 'rgba(16, 185, 129, 0.2)' : 'rgba(239, 68, 68, 0.2)',
+                    border: `1px solid ${isConnected ? '#10b981' : '#ef4444'}`,
+                    rounded: 'full',
+                  })}
+                >
+                  <div
+                    className={css({
+                      w: '2',
+                      h: '2',
+                      bg: isConnected ? '#10b981' : '#ef4444',
+                      rounded: 'full',
+                    })}
+                  />
+                  <span
+                    className={css({ color: isConnected ? '#10b981' : '#ef4444', fontSize: 'sm' })}
+                  >
+                    {isConnected ? 'Connected' : 'Disconnected'}
+                  </span>
+                </div>
+              </div>
+            </div>
+          </div>
+
+          {/* Game Players - Union of all active players */}
+          <div
+            className={css({
+              bg: 'rgba(255, 255, 255, 0.05)',
+              backdropFilter: 'blur(10px)',
+              border: '1px solid rgba(255, 255, 255, 0.1)',
+              rounded: 'lg',
+              p: '8',
+              mb: '6',
+            })}
+          >
+            <h2 className={css({ fontSize: '2xl', fontWeight: 'bold', color: 'white', mb: '2' })}>
+              🎯 Game Players ({allPlayers.length})
+            </h2>
+            <p className={css({ color: '#a0a0ff', fontSize: 'sm', mb: '4' })}>
+              These players will participate when the game starts
+            </p>
+            {allPlayers.length > 0 ? (
+              <div className={css({ display: 'flex', gap: '2', flexWrap: 'wrap' })}>
+                {allPlayers.map((player) => (
+                  <div
+                    key={player.id}
+                    className={css({
+                      display: 'flex',
+                      alignItems: 'center',
+                      gap: '2',
+                      px: '3',
+                      py: '2',
+                      bg: 'rgba(59, 130, 246, 0.15)',
+                      border: '2px solid rgba(59, 130, 246, 0.4)',
+                      rounded: 'lg',
+                      color: '#60a5fa',
+                      fontWeight: '600',
+                    })}
+                  >
+                    <span className={css({ fontSize: 'xl' })}>{player.emoji}</span>
+                    <span>{player.name}</span>
+                  </div>
+                ))}
+              </div>
+            ) : (
+              <div
+                className={css({
+                  color: '#6b7280',
+                  fontStyle: 'italic',
+                  textAlign: 'center',
+                  py: '4',
+                })}
+              >
+                No active players yet. Members need to set up their players.
+              </div>
+            )}
+          </div>
+
+          {/* Members List */}
+          <div
+            className={css({
+              bg: 'rgba(255, 255, 255, 0.05)',
+              backdropFilter: 'blur(10px)',
+              border: '1px solid rgba(255, 255, 255, 0.1)',
+              rounded: 'lg',
+              p: '8',
+              mb: '6',
+            })}
+          >
+            <h2 className={css({ fontSize: '2xl', fontWeight: 'bold', color: 'white', mb: '2' })}>
+              👥 Room Members ({onlineMembers.length}/{members.length})
+            </h2>
+            <p className={css({ color: '#a0a0ff', fontSize: 'sm', mb: '4' })}>
+              Users in this room and their active players
+            </p>
+            <div className={css({ display: 'grid', gap: '3' })}>
+              {members.map((member) => {
+                const players = memberPlayers[member.userId] || []
+                return (
+                  <div
+                    key={member.id}
+                    className={css({
+                      display: 'flex',
+                      flexDirection: 'column',
+                      gap: '2',
+                      p: '4',
+                      bg: 'rgba(255, 255, 255, 0.05)',
+                      border: '1px solid rgba(255, 255, 255, 0.1)',
+                      rounded: 'lg',
+                      opacity: member.isOnline ? 1 : 0.5,
+                    })}
+                  >
+                    <div
+                      className={css({
+                        display: 'flex',
+                        justifyContent: 'space-between',
+                        alignItems: 'center',
+                      })}
+                    >
+                      <div className={css({ display: 'flex', alignItems: 'center', gap: '3' })}>
+                        <div
+                          className={css({
+                            w: '3',
+                            h: '3',
+                            bg: member.isOnline ? '#10b981' : '#6b7280',
+                            rounded: 'full',
+                          })}
+                        />
+                        <span className={css({ color: 'white', fontWeight: '600' })}>
+                          {member.displayName}
+                        </span>
+                        {member.isCreator && (
+                          <span
+                            className={css({
+                              px: '2',
+                              py: '1',
+                              bg: 'rgba(251, 191, 36, 0.2)',
+                              color: '#fbbf24',
+                              rounded: 'full',
+                              fontSize: 'xs',
+                              fontWeight: '600',
+                            })}
+                          >
+                            HOST
+                          </span>
+                        )}
+                      </div>
+                      <span className={css({ color: '#a0a0ff', fontSize: 'sm' })}>
+                        {member.isOnline ? '🟢 Online' : '⚫ Offline'}
+                      </span>
+                    </div>
+                    {players.length > 0 && (
+                      <div
+                        className={css({ display: 'flex', gap: '2', flexWrap: 'wrap', ml: '6' })}
+                      >
+                        <span className={css({ color: '#a0a0ff', fontSize: 'xs', mr: '1' })}>
+                          Players:
+                        </span>
+                        {players.map((player) => (
+                          <span
+                            key={player.id}
+                            className={css({
+                              px: '2',
+                              py: '1',
+                              bg: 'rgba(59, 130, 246, 0.2)',
+                              color: '#60a5fa',
+                              border: '1px solid rgba(59, 130, 246, 0.3)',
+                              rounded: 'full',
+                              fontSize: 'xs',
+                              fontWeight: '600',
+                            })}
+                          >
+                            {player.emoji} {player.name}
+                          </span>
+                        ))}
+                      </div>
+                    )}
+                    {players.length === 0 && (
+                      <div
+                        className={css({
+                          ml: '6',
+                          color: '#6b7280',
+                          fontSize: 'xs',
+                          fontStyle: 'italic',
+                        })}
+                      >
+                        No active players
+                      </div>
+                    )}
+                  </div>
+                )
+              })}
+            </div>
+          </div>
+
+          {/* Actions */}
+          <div className={css({ display: 'flex', gap: '4' })}>
+            {isMember ? (
+              <>
+                <button
+                  onClick={leaveRoom}
+                  className={css({
+                    flex: 1,
+                    px: '6',
+                    py: '4',
+                    bg: 'rgba(255, 255, 255, 0.1)',
+                    color: 'white',
+                    rounded: 'lg',
+                    fontWeight: '600',
+                    cursor: 'pointer',
+                    _hover: { bg: 'rgba(255, 255, 255, 0.15)' },
+                  })}
+                >
+                  Leave Room
+                </button>
+                <button
+                  onClick={startGame}
+                  disabled={allPlayers.length < 1}
+                  className={css({
+                    flex: 2,
+                    px: '6',
+                    py: '4',
+                    bg: allPlayers.length < 1 ? '#6b7280' : '#10b981',
+                    color: 'white',
+                    rounded: 'lg',
+                    fontSize: 'xl',
+                    fontWeight: '600',
+                    cursor: allPlayers.length < 1 ? 'not-allowed' : 'pointer',
+                    opacity: allPlayers.length < 1 ? 0.5 : 1,
+                    _hover: allPlayers.length < 1 ? {} : { bg: '#059669' },
+                  })}
+                >
+                  {allPlayers.length < 1
+                    ? 'Waiting for players...'
+                    : `🎮 Start Game (${allPlayers.length} players)`}
+                </button>
+              </>
+            ) : (
+              <>
+                <button
+                  onClick={() => router.push('/arcade-rooms')}
+                  className={css({
+                    flex: 1,
+                    px: '6',
+                    py: '4',
+                    bg: 'rgba(255, 255, 255, 0.1)',
+                    color: 'white',
+                    rounded: 'lg',
+                    fontWeight: '600',
+                    cursor: 'pointer',
+                    _hover: { bg: 'rgba(255, 255, 255, 0.15)' },
+                  })}
+                >
+                  Back to Rooms
+                </button>
+                <button
+                  onClick={joinRoom}
+                  disabled={room.isLocked}
+                  className={css({
+                    flex: 2,
+                    px: '6',
+                    py: '4',
+                    bg: room.isLocked ? '#6b7280' : '#3b82f6',
+                    color: 'white',
+                    rounded: 'lg',
+                    fontSize: 'xl',
+                    fontWeight: '600',
+                    cursor: room.isLocked ? 'not-allowed' : 'pointer',
+                    opacity: room.isLocked ? 0.5 : 1,
+                    _hover: room.isLocked ? {} : { bg: '#2563eb' },
+                  })}
+                >
+                  {room.isLocked ? '🔒 Room Locked' : 'Join Room'}
+                </button>
+              </>
+            )}
+          </div>
+        </div>
+      </div>
+    </PageWithNav>
+  )
+}
--- a/apps/web/src/app/arcade-rooms/tests/room-navigation.test.tsx
+++ b/apps/web/src/app/arcade-rooms/tests/room-navigation.test.tsx
@@ -0,0 +1,316 @@
+import { render, screen, waitFor } from '@testing-library/react'
+import * as nextNavigation from 'next/navigation'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import * as arcadeGuard from '@/hooks/useArcadeGuard'
+import * as roomData from '@/hooks/useRoomData'
+import * as viewerId from '@/hooks/useViewerId'
+
+// Mock Next.js navigation
+vi.mock('next/navigation', () => ({
+  useRouter: vi.fn(),
+  usePathname: vi.fn(),
+  useParams: vi.fn(),
+}))
+
+// Mock hooks
+vi.mock('@/hooks/useArcadeGuard')
+vi.mock('@/hooks/useRoomData')
+vi.mock('@/hooks/useViewerId')
+vi.mock('@/hooks/useUserPlayers', () => ({
+  useUserPlayers: () => ({ data: [], isLoading: false }),
+  useCreatePlayer: () => ({ mutate: vi.fn() }),
+  useUpdatePlayer: () => ({ mutate: vi.fn() }),
+  useDeletePlayer: () => ({ mutate: vi.fn() }),
+}))
+vi.mock('@/hooks/useArcadeSocket', () => ({
+  useArcadeSocket: () => ({
+    connected: false,
+    joinSession: vi.fn(),
+    socket: null,
+    sendMove: vi.fn(),
+    exitSession: vi.fn(),
+    pingSession: vi.fn(),
+  }),
+}))
+
+// Mock styled-system
+vi.mock('../../../../styled-system/css', () => ({
+  css: () => '',
+}))
+
+// Mock components
+vi.mock('@/components/PageWithNav', () => ({
+  PageWithNav: ({ children }: { children: React.ReactNode }) => <div>{children}</div>,
+}))
+
+// Import pages after mocks
+import RoomBrowserPage from '../page'
+
+describe('Room Navigation with Active Sessions', () => {
+  const mockRouter = {
+    push: vi.fn(),
+    replace: vi.fn(),
+    back: vi.fn(),
+  }
+
+  beforeEach(() => {
+    vi.clearAllMocks()
+    vi.spyOn(nextNavigation, 'useRouter').mockReturnValue(mockRouter as any)
+    vi.spyOn(nextNavigation, 'usePathname').mockReturnValue('/arcade-rooms')
+    vi.spyOn(viewerId, 'useViewerId').mockReturnValue({
+      data: 'test-user',
+      isLoading: false,
+      isPending: false,
+      error: null,
+    } as any)
+    global.fetch = vi.fn()
+  })
+
+  describe('RoomBrowserPage', () => {
+    it('should render room browser without redirecting when user has active game session', async () => {
+      // User has an active game session
+      vi.spyOn(arcadeGuard, 'useArcadeGuard').mockReturnValue({
+        hasActiveSession: true,
+        loading: false,
+        activeSession: {
+          gameUrl: '/arcade/room',
+          currentGame: 'matching',
+        },
+      })
+
+      // User is in a room
+      vi.spyOn(roomData, 'useRoomData').mockReturnValue({
+        roomData: {
+          id: 'room-1',
+          name: 'Test Room',
+          code: 'ABC123',
+          gameName: 'matching',
+          members: [],
+          memberPlayers: {},
+        },
+        isLoading: false,
+        isInRoom: true,
+        notifyRoomOfPlayerUpdate: vi.fn(),
+      })
+
+      // Mock rooms API
+      ;(global.fetch as any).mockResolvedValue({
+        ok: true,
+        json: async () => ({
+          rooms: [
+            {
+              id: 'room-1',
+              code: 'ABC123',
+              name: 'Test Room',
+              gameName: 'matching',
+              status: 'lobby',
+              createdAt: new Date(),
+              creatorName: 'Test User',
+              isLocked: false,
+            },
+          ],
+        }),
+      })
+
+      render(<RoomBrowserPage />)
+
+      // Should render the page
+      await waitFor(() => {
+        expect(screen.getByText('🎮 Multiplayer Rooms')).toBeInTheDocument()
+      })
+
+      // Should NOT redirect to /arcade/room
+      expect(mockRouter.push).not.toHaveBeenCalled()
+    })
+
+    it('should NOT redirect when PageWithNav uses arcade guard with enabled=false', async () => {
+      // Simulate PageWithNav calling useArcadeGuard with enabled=false
+      const arcadeGuardSpy = vi.spyOn(arcadeGuard, 'useArcadeGuard')
+
+      // User has an active game session
+      arcadeGuardSpy.mockReturnValue({
+        hasActiveSession: true,
+        loading: false,
+        activeSession: {
+          gameUrl: '/arcade/room',
+          currentGame: 'matching',
+        },
+      })
+
+      vi.spyOn(roomData, 'useRoomData').mockReturnValue({
+        roomData: null,
+        isLoading: false,
+        isInRoom: false,
+        notifyRoomOfPlayerUpdate: vi.fn(),
+      })
+
+      ;(global.fetch as any).mockResolvedValue({
+        ok: true,
+        json: async () => ({ rooms: [] }),
+      })
+
+      render(<RoomBrowserPage />)
+
+      await waitFor(() => {
+        expect(screen.getByText('🎮 Multiplayer Rooms')).toBeInTheDocument()
+      })
+
+      // PageWithNav should have called useArcadeGuard with enabled=false
+      // This is tested in PageWithNav's own tests, but we verify no redirect happened
+      expect(mockRouter.push).not.toHaveBeenCalled()
+    })
+
+    it('should allow navigation to room detail even with active session', async () => {
+      vi.spyOn(arcadeGuard, 'useArcadeGuard').mockReturnValue({
+        hasActiveSession: true,
+        loading: false,
+        activeSession: {
+          gameUrl: '/arcade/room',
+          currentGame: 'matching',
+        },
+      })
+
+      vi.spyOn(roomData, 'useRoomData').mockReturnValue({
+        roomData: null,
+        isLoading: false,
+        isInRoom: false,
+        notifyRoomOfPlayerUpdate: vi.fn(),
+      })
+
+      ;(global.fetch as any).mockResolvedValue({
+        ok: true,
+        json: async () => ({
+          rooms: [
+            {
+              id: 'room-1',
+              code: 'ABC123',
+              name: 'Test Room',
+              gameName: 'matching',
+              status: 'lobby',
+              createdAt: new Date(),
+              creatorName: 'Test User',
+              isLocked: false,
+              isMember: true,
+            },
+          ],
+        }),
+      })
+
+      render(<RoomBrowserPage />)
+
+      await waitFor(() => {
+        expect(screen.getByText('Test Room')).toBeInTheDocument()
+      })
+
+      // Click on the room card
+      const roomCard = screen.getByText('Test Room').parentElement
+      roomCard?.click()
+
+      // Should navigate to room detail, not to /arcade/room
+      await waitFor(() => {
+        expect(mockRouter.push).toHaveBeenCalledWith('/arcade-rooms/room-1')
+      })
+    })
+  })
+
+  describe('Room navigation edge cases', () => {
+    it('should handle rapid navigation between room pages without redirect loops', async () => {
+      vi.spyOn(arcadeGuard, 'useArcadeGuard').mockReturnValue({
+        hasActiveSession: true,
+        loading: false,
+        activeSession: {
+          gameUrl: '/arcade/room',
+          currentGame: 'matching',
+        },
+      })
+
+      vi.spyOn(roomData, 'useRoomData').mockReturnValue({
+        roomData: null,
+        isLoading: false,
+        isInRoom: false,
+        notifyRoomOfPlayerUpdate: vi.fn(),
+      })
+
+      ;(global.fetch as any).mockResolvedValue({
+        ok: true,
+        json: async () => ({ rooms: [] }),
+      })
+
+      const { rerender } = render(<RoomBrowserPage />)
+
+      await waitFor(() => {
+        expect(screen.getByText('🎮 Multiplayer Rooms')).toBeInTheDocument()
+      })
+
+      // Simulate pathname changes (navigating between room pages)
+      vi.spyOn(nextNavigation, 'usePathname').mockReturnValue('/arcade-rooms/room-1')
+      rerender(<RoomBrowserPage />)
+
+      vi.spyOn(nextNavigation, 'usePathname').mockReturnValue('/arcade-rooms')
+      rerender(<RoomBrowserPage />)
+
+      // Should never redirect to game page
+      expect(mockRouter.push).not.toHaveBeenCalledWith('/arcade/room')
+    })
+
+    it('should allow user to leave room and browse other rooms during active game', async () => {
+      // User is in a room with an active game
+      vi.spyOn(arcadeGuard, 'useArcadeGuard').mockReturnValue({
+        hasActiveSession: true,
+        loading: false,
+        activeSession: {
+          gameUrl: '/arcade/room',
+          currentGame: 'matching',
+        },
+      })
+
+      vi.spyOn(roomData, 'useRoomData').mockReturnValue({
+        roomData: {
+          id: 'room-1',
+          name: 'Current Room',
+          code: 'ABC123',
+          gameName: 'matching',
+          members: [],
+          memberPlayers: {},
+        },
+        isLoading: false,
+        isInRoom: true,
+        notifyRoomOfPlayerUpdate: vi.fn(),
+      })
+
+      ;(global.fetch as any).mockResolvedValue({
+        ok: true,
+        json: async () => ({
+          rooms: [
+            {
+              id: 'room-1',
+              name: 'Current Room',
+              code: 'ABC123',
+              gameName: 'matching',
+              status: 'playing',
+              isMember: true,
+            },
+            {
+              id: 'room-2',
+              name: 'Other Room',
+              code: 'DEF456',
+              gameName: 'memory-quiz',
+              status: 'lobby',
+              isMember: false,
+            },
+          ],
+        }),
+      })
+
+      render(<RoomBrowserPage />)
+
+      await waitFor(() => {
+        expect(screen.getByText('Current Room')).toBeInTheDocument()
+        expect(screen.getByText('Other Room')).toBeInTheDocument()
+      })
+
+      // Should be able to view both rooms without redirect
+      expect(mockRouter.push).not.toHaveBeenCalled()
+    })
+  })
+})
--- a/apps/web/src/app/arcade-rooms/page.tsx
+++ b/apps/web/src/app/arcade-rooms/page.tsx
@@ -0,0 +1,468 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+import { useRouter } from 'next/navigation'
+import { css } from '../../../styled-system/css'
+import { PageWithNav } from '@/components/PageWithNav'
+
+interface Room {
+  id: string
+  code: string
+  name: string
+  gameName: string
+  status: 'lobby' | 'playing' | 'finished'
+  createdAt: Date
+  creatorName: string
+  isLocked: boolean
+  memberCount?: number
+  playerCount?: number
+  isMember?: boolean
+}
+
+export default function RoomBrowserPage() {
+  const router = useRouter()
+  const [rooms, setRooms] = useState<Room[]>([])
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<string | null>(null)
+  const [showCreateModal, setShowCreateModal] = useState(false)
+
+  useEffect(() => {
+    fetchRooms()
+  }, [])
+
+  const fetchRooms = async () => {
+    try {
+      setLoading(true)
+      const response = await fetch('/api/arcade/rooms')
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`)
+      }
+      const data = await response.json()
+      setRooms(data.rooms)
+      setError(null)
+    } catch (err) {
+      console.error('Failed to fetch rooms:', err)
+      setError('Failed to load rooms')
+    } finally {
+      setLoading(false)
+    }
+  }
+
+  const createRoom = async (name: string, gameName: string) => {
+    try {
+      const response = await fetch('/api/arcade/rooms', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          name,
+          gameName,
+          creatorName: 'Player',
+          gameConfig: { difficulty: 6 },
+        }),
+      })
+
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`)
+      }
+
+      const data = await response.json()
+      router.push(`/arcade-rooms/${data.room.id}`)
+    } catch (err) {
+      console.error('Failed to create room:', err)
+      alert('Failed to create room')
+    }
+  }
+
+  const joinRoom = async (roomId: string) => {
+    try {
+      const response = await fetch(`/api/arcade/rooms/${roomId}/join`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ displayName: 'Player' }),
+      })
+
+      if (!response.ok) {
+        const errorData = await response.json()
+
+        // Handle specific room membership conflict
+        if (errorData.code === 'ROOM_MEMBERSHIP_CONFLICT') {
+          alert(errorData.userMessage || errorData.message)
+          // Refresh the page to update room list state
+          await fetchRooms()
+          return
+        }
+
+        throw new Error(errorData.error || `HTTP ${response.status}`)
+      }
+
+      const data = await response.json()
+
+      // Show notification if user was auto-removed from other rooms
+      if (data.autoLeave) {
+        console.log(`[Room Join] ${data.autoLeave.message}`)
+        // Could show a toast notification here in the future
+      }
+
+      router.push(`/arcade-rooms/${roomId}`)
+    } catch (err) {
+      console.error('Failed to join room:', err)
+      alert('Failed to join room')
+    }
+  }
+
+  return (
+    <PageWithNav>
+      <div
+        className={css({
+          minH: 'calc(100vh - 80px)',
+          bg: 'linear-gradient(135deg, #0f0f23 0%, #1a1a3a 50%, #2d1b69 100%)',
+          p: '8',
+        })}
+      >
+        <div className={css({ maxW: '1200px', mx: 'auto' })}>
+          {/* Header */}
+          <div className={css({ mb: '8', textAlign: 'center' })}>
+            <h1
+              className={css({
+                fontSize: '4xl',
+                fontWeight: 'bold',
+                color: 'white',
+                mb: '4',
+              })}
+            >
+              🎮 Multiplayer Rooms
+            </h1>
+            <p className={css({ color: '#a0a0ff', fontSize: 'lg', mb: '6' })}>
+              Join a room or create your own to play with friends
+            </p>
+            <button
+              onClick={() => setShowCreateModal(true)}
+              className={css({
+                px: '6',
+                py: '3',
+                bg: '#10b981',
+                color: 'white',
+                rounded: 'lg',
+                fontSize: 'lg',
+                fontWeight: '600',
+                cursor: 'pointer',
+                _hover: { bg: '#059669' },
+                transition: 'all 0.2s',
+              })}
+            >
+              + Create New Room
+            </button>
+          </div>
+
+          {/* Room List */}
+          {loading && (
+            <div className={css({ textAlign: 'center', color: 'white', py: '12' })}>
+              Loading rooms...
+            </div>
+          )}
+
+          {error && (
+            <div
+              className={css({
+                bg: '#fef2f2',
+                border: '1px solid #fecaca',
+                color: '#991b1b',
+                p: '4',
+                rounded: 'lg',
+                textAlign: 'center',
+              })}
+            >
+              {error}
+            </div>
+          )}
+
+          {!loading && !error && rooms.length === 0 && (
+            <div
+              className={css({
+                bg: 'rgba(255, 255, 255, 0.05)',
+                backdropFilter: 'blur(10px)',
+                border: '1px solid rgba(255, 255, 255, 0.1)',
+                rounded: 'lg',
+                p: '12',
+                textAlign: 'center',
+                color: 'white',
+              })}
+            >
+              <p className={css({ fontSize: 'xl', mb: '2' })}>No rooms available</p>
+              <p className={css({ color: '#a0a0ff' })}>Be the first to create one!</p>
+            </div>
+          )}
+
+          {!loading && !error && rooms.length > 0 && (
+            <div className={css({ display: 'grid', gap: '4' })}>
+              {rooms.map((room) => (
+                <div
+                  key={room.id}
+                  className={css({
+                    bg: 'rgba(255, 255, 255, 0.05)',
+                    backdropFilter: 'blur(10px)',
+                    border: '1px solid rgba(255, 255, 255, 0.1)',
+                    rounded: 'lg',
+                    p: '6',
+                    transition: 'all 0.2s',
+                    _hover: {
+                      bg: 'rgba(255, 255, 255, 0.08)',
+                      borderColor: 'rgba(255, 255, 255, 0.2)',
+                    },
+                  })}
+                >
+                  <div
+                    className={css({
+                      display: 'flex',
+                      justifyContent: 'space-between',
+                      alignItems: 'center',
+                    })}
+                  >
+                    <div
+                      onClick={() => router.push(`/arcade-rooms/${room.id}`)}
+                      className={css({ flex: 1, cursor: 'pointer' })}
+                    >
+                      <div
+                        className={css({
+                          display: 'flex',
+                          alignItems: 'center',
+                          gap: '3',
+                          mb: '2',
+                        })}
+                      >
+                        <h3
+                          className={css({ fontSize: '2xl', fontWeight: 'bold', color: 'white' })}
+                        >
+                          {room.name}
+                        </h3>
+                        <span
+                          className={css({
+                            px: '3',
+                            py: '1',
+                            bg: 'rgba(255, 255, 255, 0.1)',
+                            color: '#fbbf24',
+                            rounded: 'full',
+                            fontSize: 'sm',
+                            fontWeight: '600',
+                            fontFamily: 'monospace',
+                          })}
+                        >
+                          {room.code}
+                        </span>
+                        {room.isLocked && (
+                          <span className={css({ color: '#f87171', fontSize: 'sm' })}>
+                            🔒 Locked
+                          </span>
+                        )}
+                      </div>
+                      <div
+                        className={css({
+                          display: 'flex',
+                          gap: '4',
+                          color: '#a0a0ff',
+                          fontSize: 'sm',
+                          flexWrap: 'wrap',
+                        })}
+                      >
+                        <span>👤 Host: {room.creatorName}</span>
+                        <span>🎮 {room.gameName}</span>
+                        {room.memberCount !== undefined && (
+                          <span>
+                            👥 {room.memberCount} member{room.memberCount !== 1 ? 's' : ''}
+                          </span>
+                        )}
+                        {room.playerCount !== undefined && room.playerCount > 0 && (
+                          <span>
+                            🎯 {room.playerCount} player{room.playerCount !== 1 ? 's' : ''}
+                          </span>
+                        )}
+                        <span
+                          className={css({
+                            color:
+                              room.status === 'lobby'
+                                ? '#10b981'
+                                : room.status === 'playing'
+                                  ? '#fbbf24'
+                                  : '#6b7280',
+                          })}
+                        >
+                          {room.status === 'lobby'
+                            ? '⏳ Waiting'
+                            : room.status === 'playing'
+                              ? '🎮 Playing'
+                              : '✓ Finished'}
+                        </span>
+                      </div>
+                    </div>
+                    {room.isMember ? (
+                      <div
+                        className={css({
+                          px: '6',
+                          py: '3',
+                          bg: '#10b981',
+                          color: 'white',
+                          rounded: 'lg',
+                          fontWeight: '600',
+                          display: 'flex',
+                          alignItems: 'center',
+                          gap: '2',
+                        })}
+                      >
+                        ✓ Joined
+                      </div>
+                    ) : (
+                      <button
+                        onClick={(e) => {
+                          e.stopPropagation()
+                          joinRoom(room.id)
+                        }}
+                        disabled={room.isLocked}
+                        className={css({
+                          px: '6',
+                          py: '3',
+                          bg: room.isLocked ? '#6b7280' : '#3b82f6',
+                          color: 'white',
+                          rounded: 'lg',
+                          fontWeight: '600',
+                          cursor: room.isLocked ? 'not-allowed' : 'pointer',
+                          opacity: room.isLocked ? 0.5 : 1,
+                          _hover: room.isLocked ? {} : { bg: '#2563eb' },
+                          transition: 'all 0.2s',
+                        })}
+                      >
+                        Join Room
+                      </button>
+                    )}
+                  </div>
+                </div>
+              ))}
+            </div>
+          )}
+        </div>
+
+        {/* Create Room Modal */}
+        {showCreateModal && (
+          <div
+            className={css({
+              position: 'fixed',
+              top: 0,
+              left: 0,
+              right: 0,
+              bottom: 0,
+              bg: 'rgba(0, 0, 0, 0.7)',
+              backdropFilter: 'blur(4px)',
+              display: 'flex',
+              alignItems: 'center',
+              justifyContent: 'center',
+              zIndex: 50,
+            })}
+            onClick={() => setShowCreateModal(false)}
+          >
+            <div
+              className={css({
+                bg: 'white',
+                rounded: 'xl',
+                p: '8',
+                maxW: '500px',
+                w: 'full',
+                mx: '4',
+              })}
+              onClick={(e) => e.stopPropagation()}
+            >
+              <h2 className={css({ fontSize: '2xl', fontWeight: 'bold', mb: '6' })}>
+                Create New Room
+              </h2>
+              <form
+                onSubmit={(e) => {
+                  e.preventDefault()
+                  const formData = new FormData(e.currentTarget)
+                  const name = formData.get('name') as string
+                  const gameName = formData.get('gameName') as string
+                  if (name && gameName) {
+                    createRoom(name, gameName)
+                  }
+                }}
+              >
+                <div className={css({ mb: '4' })}>
+                  <label className={css({ display: 'block', mb: '2', fontWeight: '600' })}>
+                    Room Name
+                  </label>
+                  <input
+                    name="name"
+                    type="text"
+                    required
+                    placeholder="My Awesome Room"
+                    className={css({
+                      w: 'full',
+                      px: '4',
+                      py: '3',
+                      border: '1px solid #d1d5db',
+                      rounded: 'lg',
+                      _focus: { outline: 'none', borderColor: '#3b82f6' },
+                    })}
+                  />
+                </div>
+                <div className={css({ mb: '6' })}>
+                  <label className={css({ display: 'block', mb: '2', fontWeight: '600' })}>
+                    Game
+                  </label>
+                  <select
+                    name="gameName"
+                    required
+                    className={css({
+                      w: 'full',
+                      px: '4',
+                      py: '3',
+                      border: '1px solid #d1d5db',
+                      rounded: 'lg',
+                      _focus: { outline: 'none', borderColor: '#3b82f6' },
+                    })}
+                  >
+                    <option value="matching">Memory Matching</option>
+                    <option value="memory-quiz">Memory Quiz</option>
+                    <option value="complement-race">Complement Race</option>
+                  </select>
+                </div>
+                <div className={css({ display: 'flex', gap: '3' })}>
+                  <button
+                    type="button"
+                    onClick={() => setShowCreateModal(false)}
+                    className={css({
+                      flex: 1,
+                      px: '6',
+                      py: '3',
+                      bg: '#e5e7eb',
+                      color: '#374151',
+                      rounded: 'lg',
+                      fontWeight: '600',
+                      cursor: 'pointer',
+                      _hover: { bg: '#d1d5db' },
+                    })}
+                  >
+                    Cancel
+                  </button>
+                  <button
+                    type="submit"
+                    className={css({
+                      flex: 1,
+                      px: '6',
+                      py: '3',
+                      bg: '#10b981',
+                      color: 'white',
+                      rounded: 'lg',
+                      fontWeight: '600',
+                      cursor: 'pointer',
+                      _hover: { bg: '#059669' },
+                    })}
+                  >
+                    Create Room
+                  </button>
+                </div>
+              </form>
+            </div>
+          </div>
+        )}
+      </div>
+    </PageWithNav>
+  )
+}
--- a/apps/web/src/app/arcade/complement-race/components/AISystem/SpeechBubble.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/AISystem/SpeechBubble.tsx
@@ -21,38 +21,42 @@ export function SpeechBubble({ message, onHide }: SpeechBubbleProps) {
  }, [onHide])

  return (
-    <div style={{
-      position: 'absolute',
-      bottom: 'calc(100% + 10px)',
-      left: '50%',
-      transform: 'translateX(-50%)',
-      background: 'white',
-      borderRadius: '15px',
-      padding: '10px 15px',
-      boxShadow: '0 4px 12px rgba(0,0,0,0.2)',
-      fontSize: '14px',
-      whiteSpace: 'nowrap',
-      opacity: isVisible ? 1 : 0,
-      transition: 'opacity 0.3s ease',
-      zIndex: 10,
-      pointerEvents: 'none',
-      maxWidth: '250px',
-      textAlign: 'center'
-    }}>
-      {message}
-      {/* Tail pointing down */}
-      <div style={{
+    <div
+      style={{
        position: 'absolute',
-        bottom: '-8px',
+        bottom: 'calc(100% + 10px)',
        left: '50%',
        transform: 'translateX(-50%)',
-        width: 0,
-        height: 0,
-        borderLeft: '8px solid transparent',
-        borderRight: '8px solid transparent',
-        borderTop: '8px solid white',
-        filter: 'drop-shadow(0 2px 2px rgba(0,0,0,0.1))'
-      }} />
+        background: 'white',
+        borderRadius: '15px',
+        padding: '10px 15px',
+        boxShadow: '0 4px 12px rgba(0,0,0,0.2)',
+        fontSize: '14px',
+        whiteSpace: 'nowrap',
+        opacity: isVisible ? 1 : 0,
+        transition: 'opacity 0.3s ease',
+        zIndex: 10,
+        pointerEvents: 'none',
+        maxWidth: '250px',
+        textAlign: 'center',
+      }}
+    >
+      {message}
+      {/* Tail pointing down */}
+      <div
+        style={{
+          position: 'absolute',
+          bottom: '-8px',
+          left: '50%',
+          transform: 'translateX(-50%)',
+          width: 0,
+          height: 0,
+          borderLeft: '8px solid transparent',
+          borderRight: '8px solid transparent',
+          borderTop: '8px solid white',
+          filter: 'drop-shadow(0 2px 2px rgba(0,0,0,0.1))',
+        }}
+      />
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/AISystem/aiCommentary.ts
+++ b/apps/web/src/app/arcade/complement-race/components/AISystem/aiCommentary.ts
@@ -13,129 +13,129 @@ export type CommentaryContext =
 // Swift AI - Competitive personality (lines 11768-11834)
 export const swiftAICommentary: Record<CommentaryContext, string[]> = {
  ahead: [
-    "💨 Eat my dust!",
-    "🔥 Too slow for me!",
+    '💨 Eat my dust!',
+    '🔥 Too slow for me!',
    "⚡ You can't catch me!",
    "🚀 I'm built for speed!",
-    "🏃‍♂️ This is way too easy!"
+    '🏃‍♂️ This is way too easy!',
  ],
  behind: [
-    "😤 Not over yet!",
+    '😤 Not over yet!',
    "💪 I'm just getting started!",
-    "🔥 Watch me catch up to you!",
+    '🔥 Watch me catch up to you!',
    "⚡ I'm coming for you!",
-    "🏃‍♂️ This is my comeback!"
+    '🏃‍♂️ This is my comeback!',
  ],
  adaptive_struggle: [
-    "😏 You struggling much?",
-    "🤖 Math is easy for me!",
-    "⚡ You need to think faster!",
-    "🔥 Need me to slow down?"
+    '😏 You struggling much?',
+    '🤖 Math is easy for me!',
+    '⚡ You need to think faster!',
+    '🔥 Need me to slow down?',
  ],
  adaptive_mastery: [
    "😮 You're actually impressive!",
    "🤔 You're getting faster...",
-    "😤 Time for me to step it up!",
-    "⚡ Not bad for a human!"
+    '😤 Time for me to step it up!',
+    '⚡ Not bad for a human!',
  ],
  player_passed: [
-    "😠 No way you just passed me!",
+    '😠 No way you just passed me!',
    "🔥 This isn't over!",
    "💨 I'm just getting warmed up!",
    "😤 Your lucky streak won't last!",
-    "⚡ I'll be back in front of you soon!"
+    "⚡ I'll be back in front of you soon!",
  ],
  ai_passed: [
-    "💨 See ya later, slowpoke!",
-    "😎 Thanks for the warm-up!",
+    '💨 See ya later, slowpoke!',
+    '😎 Thanks for the warm-up!',
    "🔥 This is how it's done!",
    "⚡ I'll see you at the finish line!",
-    "💪 Try to keep up with me!"
+    '💪 Try to keep up with me!',
  ],
  lapped: [
-    "😡 You just lapped me?! No way!",
-    "🤬 This is embarrassing for me!",
+    '😡 You just lapped me?! No way!',
+    '🤬 This is embarrassing for me!',
    "😤 I'm not going down without a fight!",
-    "💢 How did you get so far ahead?!",
-    "🔥 Time to show you my real speed!",
-    "😠 You won't stay ahead for long!"
+    '💢 How did you get so far ahead?!',
+    '🔥 Time to show you my real speed!',
+    "😠 You won't stay ahead for long!",
  ],
  desperate_catchup: [
    "🚨 TURBO MODE ACTIVATED! I'm coming for you!",
-    "💥 You forced me to unleash my true power!",
-    "🔥 NO MORE MR. NICE AI! Time to go all out!",
+    '💥 You forced me to unleash my true power!',
+    '🔥 NO MORE MR. NICE AI! Time to go all out!',
    "⚡ I'm switching to MAXIMUM OVERDRIVE!",
    "😤 You made me angry - now you'll see what I can do!",
-    "🚀 AFTERBURNERS ENGAGED! This isn't over!"
-  ]
+    "🚀 AFTERBURNERS ENGAGED! This isn't over!",
+  ],
 }

 // Math Bot - Analytical personality (lines 11835-11901)
 export const mathBotCommentary: Record<CommentaryContext, string[]> = {
  ahead: [
-    "📊 My performance is optimal!",
-    "🤖 My logic beats your speed!",
-    "📈 I have 87% win probability!",
+    '📊 My performance is optimal!',
+    '🤖 My logic beats your speed!',
+    '📈 I have 87% win probability!',
    "⚙️ I'm perfectly calibrated!",
-    "🔬 Science prevails over you!"
+    '🔬 Science prevails over you!',
  ],
  behind: [
-    "🤔 Recalculating my strategy...",
+    '🤔 Recalculating my strategy...',
    "📊 You're exceeding my projections!",
-    "⚙️ Adjusting my parameters!",
+    '⚙️ Adjusting my parameters!',
    "🔬 I'm analyzing your technique!",
-    "📈 You're a statistical anomaly!"
+    "📈 You're a statistical anomaly!",
  ],
  adaptive_struggle: [
-    "📊 I detect inefficiencies in you!",
-    "🔬 You should focus on patterns!",
-    "⚙️ Use that extra time wisely!",
-    "📈 You have room for improvement!"
+    '📊 I detect inefficiencies in you!',
+    '🔬 You should focus on patterns!',
+    '⚙️ Use that extra time wisely!',
+    '📈 You have room for improvement!',
  ],
  adaptive_mastery: [
-    "🤖 Your optimization is excellent!",
-    "📊 Your metrics are impressive!",
+    '🤖 Your optimization is excellent!',
+    '📊 Your metrics are impressive!',
    "⚙️ I'm updating my models because of you!",
-    "🔬 You have near-AI efficiency!"
+    '🔬 You have near-AI efficiency!',
  ],
  player_passed: [
-    "🤖 Your strategy is fascinating!",
+    '🤖 Your strategy is fascinating!',
    "📊 You're an unexpected variable!",
    "⚙️ I'm adjusting my algorithms...",
-    "🔬 Your execution is impressive!",
-    "📈 I'm recalculating the odds!"
+    '🔬 Your execution is impressive!',
+    "📈 I'm recalculating the odds!",
  ],
  ai_passed: [
-    "🤖 My efficiency is optimized!",
-    "📊 Just as I calculated!",
-    "⚙️ All my systems nominal!",
-    "🔬 My logic prevails over you!",
-    "📈 I'm at 96% confidence level!"
+    '🤖 My efficiency is optimized!',
+    '📊 Just as I calculated!',
+    '⚙️ All my systems nominal!',
+    '🔬 My logic prevails over you!',
+    "📈 I'm at 96% confidence level!",
  ],
  lapped: [
-    "🤖 Error: You have exceeded my projections!",
-    "📊 This outcome has 0.3% probability!",
-    "⚙️ I need to recalibrate my systems!",
-    "🔬 Your performance is... statistically improbable!",
-    "📈 My confidence level just dropped to 12%!",
-    "🤔 I must analyze your methodology!"
+    '🤖 Error: You have exceeded my projections!',
+    '📊 This outcome has 0.3% probability!',
+    '⚙️ I need to recalibrate my systems!',
+    '🔬 Your performance is... statistically improbable!',
+    '📈 My confidence level just dropped to 12%!',
+    '🤔 I must analyze your methodology!',
  ],
  desperate_catchup: [
-    "🤖 EMERGENCY PROTOCOL ACTIVATED! Initiating maximum speed!",
-    "🚨 CRITICAL GAP DETECTED! Engaging catchup algorithms!",
-    "⚙️ OVERCLOCKING MY PROCESSORS! Prepare for rapid acceleration!",
-    "📊 PROBABILITY OF FAILURE: UNACCEPTABLE! Switching to turbo mode!",
+    '🤖 EMERGENCY PROTOCOL ACTIVATED! Initiating maximum speed!',
+    '🚨 CRITICAL GAP DETECTED! Engaging catchup algorithms!',
+    '⚙️ OVERCLOCKING MY PROCESSORS! Prepare for rapid acceleration!',
+    '📊 PROBABILITY OF FAILURE: UNACCEPTABLE! Switching to turbo mode!',
    "🔬 HYPOTHESIS: You're about to see my true potential!",
-    "📈 CONFIDENCE LEVEL: RISING! My comeback protocol is online!"
-  ]
+    '📈 CONFIDENCE LEVEL: RISING! My comeback protocol is online!',
+  ],
 }

 // Get AI commentary message (lines 11636-11657)
 export function getAICommentary(
  racer: AIRacer,
  context: CommentaryContext,
-  playerProgress: number,
-  aiProgress: number
+  _playerProgress: number,
+  _aiProgress: number
 ): string | null {
  // Check cooldown (line 11759-11761)
  const now = Date.now()
@@ -144,12 +144,11 @@ export function getAICommentary(
  }

  // Select message set based on personality and context
-  const messages = racer.personality === 'competitive'
-    ? swiftAICommentary[context]
-    : mathBotCommentary[context]
+  const messages =
+    racer.personality === 'competitive' ? swiftAICommentary[context] : mathBotCommentary[context]

  if (!messages || messages.length === 0) return null

  // Return random message
  return messages[Math.floor(Math.random() * messages.length)]
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/AbacusTarget.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/AbacusTarget.tsx
@@ -12,12 +12,14 @@ interface AbacusTargetProps {
 */
 export function AbacusTarget({ number }: AbacusTargetProps) {
  return (
-    <div style={{
-      display: 'inline-flex',
-      alignItems: 'center',
-      justifyContent: 'center',
-      lineHeight: 0
-    }}>
+    <div
+      style={{
+        display: 'inline-flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        lineHeight: 0,
+      }}
+    >
      <AbacusReact
        value={number}
        columns={1}
@@ -26,7 +28,7 @@ export function AbacusTarget({ number }: AbacusTargetProps) {
        hideInactiveBeads={true}
        scaleFactor={0.72}
        customStyles={{
-          columnPosts: { opacity: 0 }
+          columnPosts: { opacity: 0 },
        }}
      />
    </div>
--- a/apps/web/src/app/arcade/complement-race/components/ComplementRaceGame.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/ComplementRaceGame.tsx
@@ -1,232 +1,321 @@
 'use client'

 import { useComplementRace } from '../context/ComplementRaceContext'
-import { GameIntro } from './GameIntro'
 import { GameControls } from './GameControls'
 import { GameCountdown } from './GameCountdown'
 import { GameDisplay } from './GameDisplay'
+import { GameIntro } from './GameIntro'
 import { GameResults } from './GameResults'

 export function ComplementRaceGame() {
  const { state } = useComplementRace()

  return (
-    <div data-component="game-page-root" style={{
-      flex: 1,
-      display: 'flex',
-      flexDirection: 'column',
-      overflow: 'hidden',
-      padding: '20px 8px',
-      minHeight: '100vh',
-      maxHeight: '100vh',
-      background: state.style === 'sprint'
-        ? 'linear-gradient(to bottom, #2563eb 0%, #60a5fa 100%)'
-        : 'radial-gradient(ellipse at center, #8db978 0%, #7ba565 40%, #6a9354 100%)',
-      position: 'relative'
-    }}>
+    <div
+      data-component="game-page-root"
+      style={{
+        flex: 1,
+        display: 'flex',
+        flexDirection: 'column',
+        overflow: 'hidden',
+        padding: '20px 8px',
+        minHeight: '100vh',
+        maxHeight: '100vh',
+        background:
+          state.style === 'sprint'
+            ? 'linear-gradient(to bottom, #2563eb 0%, #60a5fa 100%)'
+            : 'radial-gradient(ellipse at center, #8db978 0%, #7ba565 40%, #6a9354 100%)',
+        position: 'relative',
+      }}
+    >
      {/* Background pattern - subtle grass texture */}
      {state.style !== 'sprint' && (
-        <div style={{
-          position: 'absolute',
-          inset: 0,
-          overflow: 'hidden',
-          pointerEvents: 'none',
-          zIndex: 0,
-          opacity: 0.15
-        }}>
-        <svg width="100%" height="100%">
-          <defs>
-            <pattern id="grass-texture" x="0" y="0" width="40" height="40" patternUnits="userSpaceOnUse">
-              <rect width="40" height="40" fill="transparent" />
-              <line x1="2" y1="5" x2="8" y2="5" stroke="#2d5016" strokeWidth="1" opacity="0.3" />
-              <line x1="15" y1="8" x2="20" y2="8" stroke="#2d5016" strokeWidth="1" opacity="0.25" />
-              <line x1="25" y1="12" x2="32" y2="12" stroke="#2d5016" strokeWidth="1" opacity="0.2" />
-              <line x1="5" y1="18" x2="12" y2="18" stroke="#2d5016" strokeWidth="1" opacity="0.3" />
-              <line x1="28" y1="22" x2="35" y2="22" stroke="#2d5016" strokeWidth="1" opacity="0.25" />
-              <line x1="10" y1="30" x2="16" y2="30" stroke="#2d5016" strokeWidth="1" opacity="0.2" />
-              <line x1="22" y1="35" x2="28" y2="35" stroke="#2d5016" strokeWidth="1" opacity="0.3" />
-            </pattern>
-          </defs>
-          <rect width="100%" height="100%" fill="url(#grass-texture)" />
-        </svg>
+        <div
+          style={{
+            position: 'absolute',
+            inset: 0,
+            overflow: 'hidden',
+            pointerEvents: 'none',
+            zIndex: 0,
+            opacity: 0.15,
+          }}
+        >
+          <svg width="100%" height="100%">
+            <defs>
+              <pattern
+                id="grass-texture"
+                x="0"
+                y="0"
+                width="40"
+                height="40"
+                patternUnits="userSpaceOnUse"
+              >
+                <rect width="40" height="40" fill="transparent" />
+                <line x1="2" y1="5" x2="8" y2="5" stroke="#2d5016" strokeWidth="1" opacity="0.3" />
+                <line
+                  x1="15"
+                  y1="8"
+                  x2="20"
+                  y2="8"
+                  stroke="#2d5016"
+                  strokeWidth="1"
+                  opacity="0.25"
+                />
+                <line
+                  x1="25"
+                  y1="12"
+                  x2="32"
+                  y2="12"
+                  stroke="#2d5016"
+                  strokeWidth="1"
+                  opacity="0.2"
+                />
+                <line
+                  x1="5"
+                  y1="18"
+                  x2="12"
+                  y2="18"
+                  stroke="#2d5016"
+                  strokeWidth="1"
+                  opacity="0.3"
+                />
+                <line
+                  x1="28"
+                  y1="22"
+                  x2="35"
+                  y2="22"
+                  stroke="#2d5016"
+                  strokeWidth="1"
+                  opacity="0.25"
+                />
+                <line
+                  x1="10"
+                  y1="30"
+                  x2="16"
+                  y2="30"
+                  stroke="#2d5016"
+                  strokeWidth="1"
+                  opacity="0.2"
+                />
+                <line
+                  x1="22"
+                  y1="35"
+                  x2="28"
+                  y2="35"
+                  stroke="#2d5016"
+                  strokeWidth="1"
+                  opacity="0.3"
+                />
+              </pattern>
+            </defs>
+            <rect width="100%" height="100%" fill="url(#grass-texture)" />
+          </svg>
        </div>
      )}

      {/* Subtle tree clusters around edges - top-down view with gentle sway */}
      {state.style !== 'sprint' && (
-        <div style={{
-        position: 'absolute',
-        inset: 0,
-        overflow: 'hidden',
-        pointerEvents: 'none',
-        zIndex: 0
-      }}>
-        {/* Top-left tree cluster */}
-        <div style={{
-          position: 'absolute',
-          top: '5%',
-          left: '3%',
-          width: '80px',
-          height: '80px',
-          borderRadius: '50%',
-          background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
-          opacity: 0.2,
-          filter: 'blur(4px)',
-          animation: 'treeSway1 8s ease-in-out infinite'
-        }} />
+        <div
+          style={{
+            position: 'absolute',
+            inset: 0,
+            overflow: 'hidden',
+            pointerEvents: 'none',
+            zIndex: 0,
+          }}
+        >
+          {/* Top-left tree cluster */}
+          <div
+            style={{
+              position: 'absolute',
+              top: '5%',
+              left: '3%',
+              width: '80px',
+              height: '80px',
+              borderRadius: '50%',
+              background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
+              opacity: 0.2,
+              filter: 'blur(4px)',
+              animation: 'treeSway1 8s ease-in-out infinite',
+            }}
+          />

-        {/* Top-right tree cluster */}
-        <div style={{
-          position: 'absolute',
-          top: '8%',
-          right: '5%',
-          width: '100px',
-          height: '100px',
-          borderRadius: '50%',
-          background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
-          opacity: 0.18,
-          filter: 'blur(5px)',
-          animation: 'treeSway2 10s ease-in-out infinite'
-        }} />
+          {/* Top-right tree cluster */}
+          <div
+            style={{
+              position: 'absolute',
+              top: '8%',
+              right: '5%',
+              width: '100px',
+              height: '100px',
+              borderRadius: '50%',
+              background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
+              opacity: 0.18,
+              filter: 'blur(5px)',
+              animation: 'treeSway2 10s ease-in-out infinite',
+            }}
+          />

-        {/* Bottom-left tree cluster */}
-        <div style={{
-          position: 'absolute',
-          bottom: '10%',
-          left: '8%',
-          width: '90px',
-          height: '90px',
-          borderRadius: '50%',
-          background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
-          opacity: 0.15,
-          filter: 'blur(4px)',
-          animation: 'treeSway1 9s ease-in-out infinite reverse'
-        }} />
+          {/* Bottom-left tree cluster */}
+          <div
+            style={{
+              position: 'absolute',
+              bottom: '10%',
+              left: '8%',
+              width: '90px',
+              height: '90px',
+              borderRadius: '50%',
+              background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
+              opacity: 0.15,
+              filter: 'blur(4px)',
+              animation: 'treeSway1 9s ease-in-out infinite reverse',
+            }}
+          />

-        {/* Bottom-right tree cluster */}
-        <div style={{
-          position: 'absolute',
-          bottom: '5%',
-          right: '4%',
-          width: '110px',
-          height: '110px',
-          borderRadius: '50%',
-          background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
-          opacity: 0.2,
-          filter: 'blur(6px)',
-          animation: 'treeSway2 11s ease-in-out infinite'
-        }} />
+          {/* Bottom-right tree cluster */}
+          <div
+            style={{
+              position: 'absolute',
+              bottom: '5%',
+              right: '4%',
+              width: '110px',
+              height: '110px',
+              borderRadius: '50%',
+              background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
+              opacity: 0.2,
+              filter: 'blur(6px)',
+              animation: 'treeSway2 11s ease-in-out infinite',
+            }}
+          />

-        {/* Additional smaller clusters for depth */}
-        <div style={{
-          position: 'absolute',
-          top: '40%',
-          left: '2%',
-          width: '60px',
-          height: '60px',
-          borderRadius: '50%',
-          background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
-          opacity: 0.12,
-          filter: 'blur(3px)',
-          animation: 'treeSway1 7s ease-in-out infinite'
-        }} />
+          {/* Additional smaller clusters for depth */}
+          <div
+            style={{
+              position: 'absolute',
+              top: '40%',
+              left: '2%',
+              width: '60px',
+              height: '60px',
+              borderRadius: '50%',
+              background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
+              opacity: 0.12,
+              filter: 'blur(3px)',
+              animation: 'treeSway1 7s ease-in-out infinite',
+            }}
+          />

-        <div style={{
-          position: 'absolute',
-          top: '55%',
-          right: '3%',
-          width: '70px',
-          height: '70px',
-          borderRadius: '50%',
-          background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
-          opacity: 0.14,
-          filter: 'blur(4px)',
-          animation: 'treeSway2 8.5s ease-in-out infinite reverse'
-        }} />
+          <div
+            style={{
+              position: 'absolute',
+              top: '55%',
+              right: '3%',
+              width: '70px',
+              height: '70px',
+              borderRadius: '50%',
+              background: 'radial-gradient(circle, #4a7c3a 0%, #3d6630 60%, transparent 70%)',
+              opacity: 0.14,
+              filter: 'blur(4px)',
+              animation: 'treeSway2 8.5s ease-in-out infinite reverse',
+            }}
+          />
        </div>
      )}

      {/* Flying bird shadows - very subtle from aerial view */}
      {state.style !== 'sprint' && (
-        <div style={{
-        position: 'absolute',
-        inset: 0,
-        overflow: 'hidden',
-        pointerEvents: 'none',
-        zIndex: 0
-      }}>
-        <div style={{
-          position: 'absolute',
-          top: '30%',
-          left: '-5%',
-          width: '15px',
-          height: '8px',
-          background: 'rgba(0, 0, 0, 0.08)',
-          borderRadius: '50%',
-          filter: 'blur(2px)',
-          animation: 'birdFly1 20s linear infinite'
-        }} />
+        <div
+          style={{
+            position: 'absolute',
+            inset: 0,
+            overflow: 'hidden',
+            pointerEvents: 'none',
+            zIndex: 0,
+          }}
+        >
+          <div
+            style={{
+              position: 'absolute',
+              top: '30%',
+              left: '-5%',
+              width: '15px',
+              height: '8px',
+              background: 'rgba(0, 0, 0, 0.08)',
+              borderRadius: '50%',
+              filter: 'blur(2px)',
+              animation: 'birdFly1 20s linear infinite',
+            }}
+          />

-        <div style={{
-          position: 'absolute',
-          top: '60%',
-          left: '-5%',
-          width: '12px',
-          height: '6px',
-          background: 'rgba(0, 0, 0, 0.06)',
-          borderRadius: '50%',
-          filter: 'blur(2px)',
-          animation: 'birdFly2 28s linear infinite'
-        }} />
+          <div
+            style={{
+              position: 'absolute',
+              top: '60%',
+              left: '-5%',
+              width: '12px',
+              height: '6px',
+              background: 'rgba(0, 0, 0, 0.06)',
+              borderRadius: '50%',
+              filter: 'blur(2px)',
+              animation: 'birdFly2 28s linear infinite',
+            }}
+          />

-        <div style={{
-          position: 'absolute',
-          top: '45%',
-          left: '-5%',
-          width: '10px',
-          height: '5px',
-          background: 'rgba(0, 0, 0, 0.05)',
-          borderRadius: '50%',
-          filter: 'blur(1px)',
-          animation: 'birdFly1 35s linear infinite',
-          animationDelay: '-12s'
-        }} />
+          <div
+            style={{
+              position: 'absolute',
+              top: '45%',
+              left: '-5%',
+              width: '10px',
+              height: '5px',
+              background: 'rgba(0, 0, 0, 0.05)',
+              borderRadius: '50%',
+              filter: 'blur(1px)',
+              animation: 'birdFly1 35s linear infinite',
+              animationDelay: '-12s',
+            }}
+          />
        </div>
      )}

      {/* Subtle cloud shadows moving across field */}
      {state.style !== 'sprint' && (
-        <div style={{
-        position: 'absolute',
-        inset: 0,
-        overflow: 'hidden',
-        pointerEvents: 'none',
-        zIndex: 0
-      }}>
-        <div style={{
-          position: 'absolute',
-          top: '-10%',
-          left: '-20%',
-          width: '300px',
-          height: '200px',
-          background: 'radial-gradient(ellipse, rgba(0, 0, 0, 0.03) 0%, transparent 60%)',
-          borderRadius: '50%',
-          filter: 'blur(20px)',
-          animation: 'cloudShadow1 45s linear infinite'
-        }} />
+        <div
+          style={{
+            position: 'absolute',
+            inset: 0,
+            overflow: 'hidden',
+            pointerEvents: 'none',
+            zIndex: 0,
+          }}
+        >
+          <div
+            style={{
+              position: 'absolute',
+              top: '-10%',
+              left: '-20%',
+              width: '300px',
+              height: '200px',
+              background: 'radial-gradient(ellipse, rgba(0, 0, 0, 0.03) 0%, transparent 60%)',
+              borderRadius: '50%',
+              filter: 'blur(20px)',
+              animation: 'cloudShadow1 45s linear infinite',
+            }}
+          />

-        <div style={{
-          position: 'absolute',
-          top: '-10%',
-          left: '-20%',
-          width: '250px',
-          height: '180px',
-          background: 'radial-gradient(ellipse, rgba(0, 0, 0, 0.025) 0%, transparent 60%)',
-          borderRadius: '50%',
-          filter: 'blur(25px)',
-          animation: 'cloudShadow2 60s linear infinite',
-          animationDelay: '-20s'
-        }} />
+          <div
+            style={{
+              position: 'absolute',
+              top: '-10%',
+              left: '-20%',
+              width: '250px',
+              height: '180px',
+              background: 'radial-gradient(ellipse, rgba(0, 0, 0, 0.025) 0%, transparent 60%)',
+              borderRadius: '50%',
+              filter: 'blur(25px)',
+              animation: 'cloudShadow2 60s linear infinite',
+              animationDelay: '-20s',
+            }}
+          />
        </div>
      )}

@@ -262,15 +351,17 @@ export function ComplementRaceGame() {
        }
      `}</style>

-      <div style={{
-        maxWidth: '100%',
-        margin: '0 auto',
-        flex: 1,
-        display: 'flex',
-        flexDirection: 'column',
-        position: 'relative',
-        zIndex: 1
-      }}>
+      <div
+        style={{
+          maxWidth: '100%',
+          margin: '0 auto',
+          flex: 1,
+          display: 'flex',
+          flexDirection: 'column',
+          position: 'relative',
+          zIndex: 1,
+        }}
+      >
        {state.gamePhase === 'intro' && <GameIntro />}
        {state.gamePhase === 'controls' && <GameControls />}
        {state.gamePhase === 'countdown' && <GameCountdown />}
@@ -279,4 +370,4 @@ export function ComplementRaceGame() {
      </div>
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/GameControls.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/GameControls.tsx
@@ -1,7 +1,7 @@
 'use client'

 import { useComplementRace } from '../context/ComplementRaceContext'
-import type { GameMode, GameStyle, TimeoutSetting, ComplementDisplay } from '../lib/gameTypes'
+import type { ComplementDisplay, GameMode, GameStyle, TimeoutSetting } from '../lib/gameTypes'
 import { AbacusTarget } from './AbacusTarget'

 export function GameControls() {
@@ -26,76 +26,108 @@ export function GameControls() {
  }

  return (
-    <div style={{
-      height: '100vh',
-      display: 'flex',
-      flexDirection: 'column',
-      background: 'linear-gradient(to bottom, #0f172a 0%, #1e293b 50%, #334155 100%)',
-      overflow: 'hidden',
-      position: 'relative'
-    }}>
+    <div
+      style={{
+        height: '100vh',
+        display: 'flex',
+        flexDirection: 'column',
+        background: 'linear-gradient(to bottom, #0f172a 0%, #1e293b 50%, #334155 100%)',
+        overflow: 'hidden',
+        position: 'relative',
+      }}
+    >
      {/* Animated background pattern */}
-      <div style={{
-        position: 'absolute',
-        top: 0,
-        left: 0,
-        right: 0,
-        bottom: 0,
-        backgroundImage: 'radial-gradient(circle at 20% 50%, rgba(59, 130, 246, 0.1) 0%, transparent 50%), radial-gradient(circle at 80% 80%, rgba(139, 92, 246, 0.1) 0%, transparent 50%)',
-        pointerEvents: 'none'
-      }} />
+      <div
+        style={{
+          position: 'absolute',
+          top: 0,
+          left: 0,
+          right: 0,
+          bottom: 0,
+          backgroundImage:
+            'radial-gradient(circle at 20% 50%, rgba(59, 130, 246, 0.1) 0%, transparent 50%), radial-gradient(circle at 80% 80%, rgba(139, 92, 246, 0.1) 0%, transparent 50%)',
+          pointerEvents: 'none',
+        }}
+      />

      {/* Header */}
-      <div style={{
-        textAlign: 'center',
-        padding: '20px',
-        position: 'relative',
-        zIndex: 1
-      }}>
-        <h1 style={{
-          fontSize: '32px',
-          fontWeight: 'bold',
-          background: 'linear-gradient(135deg, #60a5fa 0%, #a78bfa 100%)',
-          WebkitBackgroundClip: 'text',
-          WebkitTextFillColor: 'transparent',
-          backgroundClip: 'text',
-          margin: 0,
-          letterSpacing: '-0.5px'
-        }}>
+      <div
+        style={{
+          textAlign: 'center',
+          padding: '20px',
+          position: 'relative',
+          zIndex: 1,
+        }}
+      >
+        <h1
+          style={{
+            fontSize: '32px',
+            fontWeight: 'bold',
+            background: 'linear-gradient(135deg, #60a5fa 0%, #a78bfa 100%)',
+            WebkitBackgroundClip: 'text',
+            WebkitTextFillColor: 'transparent',
+            backgroundClip: 'text',
+            margin: 0,
+            letterSpacing: '-0.5px',
+          }}
+        >
          Complement Race
        </h1>
      </div>

      {/* Settings Bar */}
-      <div style={{
-        padding: '0 20px 16px',
-        display: 'flex',
-        flexDirection: 'column',
-        gap: '12px',
-        position: 'relative',
-        zIndex: 1
-      }}>
+      <div
+        style={{
+          padding: '0 20px 16px',
+          display: 'flex',
+          flexDirection: 'column',
+          gap: '12px',
+          position: 'relative',
+          zIndex: 1,
+        }}
+      >
        {/* Number Mode & Display */}
-        <div style={{
-          background: 'rgba(30, 41, 59, 0.8)',
-          backdropFilter: 'blur(20px)',
-          borderRadius: '16px',
-          padding: '16px',
-          border: '1px solid rgba(148, 163, 184, 0.2)'
-        }}>
-          <div style={{
-            display: 'flex',
-            gap: '20px',
-            flexWrap: 'wrap',
-            alignItems: 'center'
-          }}>
+        <div
+          style={{
+            background: 'rgba(30, 41, 59, 0.8)',
+            backdropFilter: 'blur(20px)',
+            borderRadius: '16px',
+            padding: '16px',
+            border: '1px solid rgba(148, 163, 184, 0.2)',
+          }}
+        >
+          <div
+            style={{
+              display: 'flex',
+              gap: '20px',
+              flexWrap: 'wrap',
+              alignItems: 'center',
+            }}
+          >
            {/* Number Mode Pills */}
-            <div style={{ display: 'flex', gap: '8px', alignItems: 'center', flex: 1, minWidth: '200px' }}>
-              <span style={{ fontSize: '13px', color: '#94a3b8', fontWeight: '600', marginRight: '4px' }}>Mode:</span>
+            <div
+              style={{
+                display: 'flex',
+                gap: '8px',
+                alignItems: 'center',
+                flex: 1,
+                minWidth: '200px',
+              }}
+            >
+              <span
+                style={{
+                  fontSize: '13px',
+                  color: '#94a3b8',
+                  fontWeight: '600',
+                  marginRight: '4px',
+                }}
+              >
+                Mode:
+              </span>
              {[
                { mode: 'friends5' as GameMode, label: '5' },
                { mode: 'friends10' as GameMode, label: '10' },
-                { mode: 'mixed' as GameMode, label: 'Mix' }
+                { mode: 'mixed' as GameMode, label: 'Mix' },
              ].map(({ mode, label }) => (
                <button
                  key={mode}
@@ -104,14 +136,15 @@ export function GameControls() {
                    padding: '8px 16px',
                    borderRadius: '20px',
                    border: 'none',
-                    background: state.mode === mode
-                      ? 'linear-gradient(135deg, #3b82f6 0%, #8b5cf6 100%)'
-                      : 'rgba(148, 163, 184, 0.2)',
+                    background:
+                      state.mode === mode
+                        ? 'linear-gradient(135deg, #3b82f6 0%, #8b5cf6 100%)'
+                        : 'rgba(148, 163, 184, 0.2)',
                    color: state.mode === mode ? 'white' : '#94a3b8',
                    fontWeight: 'bold',
                    cursor: 'pointer',
                    transition: 'all 0.2s ease',
-                    fontSize: '13px'
+                    fontSize: '13px',
                  }}
                >
                  {label}
@@ -120,8 +153,25 @@ export function GameControls() {
            </div>

            {/* Complement Display Pills */}
-            <div style={{ display: 'flex', gap: '8px', alignItems: 'center', flex: 1, minWidth: '200px' }}>
-              <span style={{ fontSize: '13px', color: '#94a3b8', fontWeight: '600', marginRight: '4px' }}>Show:</span>
+            <div
+              style={{
+                display: 'flex',
+                gap: '8px',
+                alignItems: 'center',
+                flex: 1,
+                minWidth: '200px',
+              }}
+            >
+              <span
+                style={{
+                  fontSize: '13px',
+                  color: '#94a3b8',
+                  fontWeight: '600',
+                  marginRight: '4px',
+                }}
+              >
+                Show:
+              </span>
              {(['number', 'abacus', 'random'] as ComplementDisplay[]).map((displayMode) => (
                <button
                  key={displayMode}
@@ -130,14 +180,15 @@ export function GameControls() {
                    padding: '8px 16px',
                    borderRadius: '20px',
                    border: 'none',
-                    background: state.complementDisplay === displayMode
-                      ? 'linear-gradient(135deg, #10b981 0%, #059669 100%)'
-                      : 'rgba(148, 163, 184, 0.2)',
+                    background:
+                      state.complementDisplay === displayMode
+                        ? 'linear-gradient(135deg, #10b981 0%, #059669 100%)'
+                        : 'rgba(148, 163, 184, 0.2)',
                    color: state.complementDisplay === displayMode ? 'white' : '#94a3b8',
                    fontWeight: 'bold',
                    cursor: 'pointer',
                    transition: 'all 0.2s ease',
-                    fontSize: '13px'
+                    fontSize: '13px',
                  }}
                >
                  {displayMode === 'number' ? '123' : displayMode === 'abacus' ? '🧮' : '🎲'}
@@ -146,9 +197,37 @@ export function GameControls() {
            </div>

            {/* Speed Pills */}
-            <div style={{ display: 'flex', gap: '6px', alignItems: 'center', flex: 1, minWidth: '200px', flexWrap: 'wrap' }}>
-              <span style={{ fontSize: '13px', color: '#94a3b8', fontWeight: '600', marginRight: '4px' }}>Speed:</span>
-              {(['preschool', 'kindergarten', 'relaxed', 'slow', 'normal', 'fast', 'expert'] as TimeoutSetting[]).map((timeout) => (
+            <div
+              style={{
+                display: 'flex',
+                gap: '6px',
+                alignItems: 'center',
+                flex: 1,
+                minWidth: '200px',
+                flexWrap: 'wrap',
+              }}
+            >
+              <span
+                style={{
+                  fontSize: '13px',
+                  color: '#94a3b8',
+                  fontWeight: '600',
+                  marginRight: '4px',
+                }}
+              >
+                Speed:
+              </span>
+              {(
+                [
+                  'preschool',
+                  'kindergarten',
+                  'relaxed',
+                  'slow',
+                  'normal',
+                  'fast',
+                  'expert',
+                ] as TimeoutSetting[]
+              ).map((timeout) => (
                <button
                  key={timeout}
                  onClick={() => handleTimeoutSelect(timeout)}
@@ -156,49 +235,60 @@ export function GameControls() {
                    padding: '6px 12px',
                    borderRadius: '16px',
                    border: 'none',
-                    background: state.timeoutSetting === timeout
-                      ? 'linear-gradient(135deg, #ec4899 0%, #be185d 100%)'
-                      : 'rgba(148, 163, 184, 0.2)',
+                    background:
+                      state.timeoutSetting === timeout
+                        ? 'linear-gradient(135deg, #ec4899 0%, #be185d 100%)'
+                        : 'rgba(148, 163, 184, 0.2)',
                    color: state.timeoutSetting === timeout ? 'white' : '#94a3b8',
                    fontWeight: state.timeoutSetting === timeout ? 'bold' : 'normal',
                    cursor: 'pointer',
                    transition: 'all 0.2s ease',
-                    fontSize: '11px'
+                    fontSize: '11px',
                  }}
                >
-                  {timeout === 'preschool' ? 'Pre' : timeout === 'kindergarten' ? 'K' : timeout.charAt(0).toUpperCase()}
+                  {timeout === 'preschool'
+                    ? 'Pre'
+                    : timeout === 'kindergarten'
+                      ? 'K'
+                      : timeout.charAt(0).toUpperCase()}
                </button>
              ))}
            </div>
          </div>

          {/* Preview - compact */}
-          <div style={{
-            marginTop: '12px',
-            padding: '12px',
-            borderRadius: '12px',
-            background: 'rgba(15, 23, 42, 0.6)',
-            border: '1px solid rgba(148, 163, 184, 0.2)',
-            display: 'flex',
-            alignItems: 'center',
-            justifyContent: 'center',
-            gap: '12px'
-          }}>
-            <span style={{ fontSize: '11px', color: '#94a3b8', fontWeight: '600' }}>Preview:</span>
-            <div style={{
+          <div
+            style={{
+              marginTop: '12px',
+              padding: '12px',
+              borderRadius: '12px',
+              background: 'rgba(15, 23, 42, 0.6)',
+              border: '1px solid rgba(148, 163, 184, 0.2)',
              display: 'flex',
              alignItems: 'center',
-              gap: '10px',
-              fontSize: '20px',
-              fontWeight: 'bold',
-              color: 'white'
-            }}>
-              <div style={{
-                background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
+              justifyContent: 'center',
+              gap: '12px',
+            }}
+          >
+            <span style={{ fontSize: '11px', color: '#94a3b8', fontWeight: '600' }}>Preview:</span>
+            <div
+              style={{
+                display: 'flex',
+                alignItems: 'center',
+                gap: '10px',
+                fontSize: '20px',
+                fontWeight: 'bold',
                color: 'white',
-                padding: '2px 10px',
-                borderRadius: '6px'
-              }}>
+              }}
+            >
+              <div
+                style={{
+                  background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
+                  color: 'white',
+                  padding: '2px 10px',
+                  borderRadius: '6px',
+                }}
+              >
                ?
              </div>
              <span style={{ fontSize: '16px', color: '#64748b' }}>+</span>
@@ -212,23 +302,28 @@ export function GameControls() {
                <span style={{ fontSize: '14px' }}>🎲</span>
              )}
              <span style={{ fontSize: '16px', color: '#64748b' }}>=</span>
-              <span style={{ color: '#10b981' }}>{state.mode === 'friends5' ? '5' : state.mode === 'friends10' ? '10' : '?'}</span>
+              <span style={{ color: '#10b981' }}>
+                {state.mode === 'friends5' ? '5' : state.mode === 'friends10' ? '10' : '?'}
+              </span>
            </div>
          </div>
        </div>
      </div>

      {/* HERO SECTION - Race Cards */}
-      <div data-component="race-cards-container" style={{
-        flex: 1,
-        padding: '0 20px 20px',
-        display: 'flex',
-        flexDirection: 'column',
-        gap: '16px',
-        position: 'relative',
-        zIndex: 1,
-        overflow: 'auto'
-      }}>
+      <div
+        data-component="race-cards-container"
+        style={{
+          flex: 1,
+          padding: '0 20px 20px',
+          display: 'flex',
+          flexDirection: 'column',
+          gap: '16px',
+          position: 'relative',
+          zIndex: 1,
+          overflow: 'auto',
+        }}
+      >
        {[
          {
            style: 'practice' as GameStyle,
@@ -237,7 +332,7 @@ export function GameControls() {
            desc: 'Race against AI to 20 correct answers',
            gradient: 'linear-gradient(135deg, #10b981 0%, #059669 100%)',
            shadowColor: 'rgba(16, 185, 129, 0.5)',
-            accentColor: '#34d399'
+            accentColor: '#34d399',
          },
          {
            style: 'sprint' as GameStyle,
@@ -246,7 +341,7 @@ export function GameControls() {
            desc: 'High-speed 60-second train journey',
            gradient: 'linear-gradient(135deg, #f59e0b 0%, #d97706 100%)',
            shadowColor: 'rgba(245, 158, 11, 0.5)',
-            accentColor: '#fbbf24'
+            accentColor: '#fbbf24',
          },
          {
            style: 'survival' as GameStyle,
@@ -255,8 +350,8 @@ export function GameControls() {
            desc: 'Endless laps - beat your best time',
            gradient: 'linear-gradient(135deg, #8b5cf6 0%, #7c3aed 100%)',
            shadowColor: 'rgba(139, 92, 246, 0.5)',
-            accentColor: '#a78bfa'
-          }
+            accentColor: '#a78bfa',
+          },
        ].map(({ style, emoji, title, desc, gradient, shadowColor, accentColor }) => (
          <button
            key={style}
@@ -273,7 +368,7 @@ export function GameControls() {
              transform: 'translateY(0)',
              flex: 1,
              minHeight: '140px',
-              overflow: 'hidden'
+              overflow: 'hidden',
            }}
            onMouseEnter={(e) => {
              e.currentTarget.style.transform = 'translateY(-8px) scale(1.02)'
@@ -285,71 +380,89 @@ export function GameControls() {
            }}
          >
            {/* Shine effect overlay */}
-            <div style={{
-              position: 'absolute',
-              top: 0,
-              left: 0,
-              right: 0,
-              bottom: 0,
-              background: 'linear-gradient(135deg, rgba(255,255,255,0.2) 0%, transparent 50%)',
-              pointerEvents: 'none'
-            }} />
+            <div
+              style={{
+                position: 'absolute',
+                top: 0,
+                left: 0,
+                right: 0,
+                bottom: 0,
+                background: 'linear-gradient(135deg, rgba(255,255,255,0.2) 0%, transparent 50%)',
+                pointerEvents: 'none',
+              }}
+            />

-            <div style={{
-              padding: '28px 32px',
-              display: 'flex',
-              alignItems: 'center',
-              justifyContent: 'space-between',
-              position: 'relative',
-              zIndex: 1
-            }}>
-              <div style={{
+            <div
+              style={{
+                padding: '28px 32px',
                display: 'flex',
                alignItems: 'center',
-                gap: '20px',
-                flex: 1
-              }}>
-                <div style={{
-                  fontSize: '64px',
-                  lineHeight: 1,
-                  filter: 'drop-shadow(0 4px 8px rgba(0,0,0,0.3))'
-                }}>
+                justifyContent: 'space-between',
+                position: 'relative',
+                zIndex: 1,
+              }}
+            >
+              <div
+                style={{
+                  display: 'flex',
+                  alignItems: 'center',
+                  gap: '20px',
+                  flex: 1,
+                }}
+              >
+                <div
+                  style={{
+                    fontSize: '64px',
+                    lineHeight: 1,
+                    filter: 'drop-shadow(0 4px 8px rgba(0,0,0,0.3))',
+                  }}
+                >
                  {emoji}
                </div>
                <div style={{ textAlign: 'left', flex: 1 }}>
-                  <div style={{
-                    fontSize: '28px',
-                    fontWeight: 'bold',
-                    color: 'white',
-                    marginBottom: '6px',
-                    textShadow: '0 2px 8px rgba(0,0,0,0.3)'
-                  }}>
+                  <div
+                    style={{
+                      fontSize: '28px',
+                      fontWeight: 'bold',
+                      color: 'white',
+                      marginBottom: '6px',
+                      textShadow: '0 2px 8px rgba(0,0,0,0.3)',
+                    }}
+                  >
                    {title}
                  </div>
-                  <div style={{
-                    fontSize: '15px',
-                    color: 'rgba(255, 255, 255, 0.9)',
-                    textShadow: '0 1px 4px rgba(0,0,0,0.2)'
-                  }}>
+                  <div
+                    style={{
+                      fontSize: '15px',
+                      color: 'rgba(255, 255, 255, 0.9)',
+                      textShadow: '0 1px 4px rgba(0,0,0,0.2)',
+                    }}
+                  >
                    {desc}
                  </div>
                </div>
              </div>

              {/* PLAY NOW button */}
-              <div style={{
-                background: 'white',
-                color: gradient.includes('10b981') ? '#047857' : gradient.includes('f59e0b') ? '#d97706' : '#6b21a8',
-                padding: '16px 32px',
-                borderRadius: '16px',
-                fontWeight: 'bold',
-                fontSize: '18px',
-                boxShadow: '0 8px 24px rgba(0,0,0,0.25)',
-                display: 'flex',
-                alignItems: 'center',
-                gap: '10px',
-                whiteSpace: 'nowrap'
-              }}>
+              <div
+                style={{
+                  background: 'white',
+                  color: gradient.includes('10b981')
+                    ? '#047857'
+                    : gradient.includes('f59e0b')
+                      ? '#d97706'
+                      : '#6b21a8',
+                  padding: '16px 32px',
+                  borderRadius: '16px',
+                  fontWeight: 'bold',
+                  fontSize: '18px',
+                  boxShadow: '0 8px 24px rgba(0,0,0,0.25)',
+                  display: 'flex',
+                  alignItems: 'center',
+                  gap: '10px',
+                  whiteSpace: 'nowrap',
+                }}
+              >
                <span>PLAY</span>
                <span style={{ fontSize: '24px' }}>▶</span>
              </div>
@@ -359,4 +472,4 @@ export function GameControls() {
      </div>
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/GameCountdown.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/GameCountdown.tsx
@@ -2,7 +2,6 @@

 import { useEffect, useState } from 'react'
 import { useComplementRace } from '../context/ComplementRaceContext'
-import { useGameLoop } from '../hooks/useGameLoop'
 import { useSoundEffects } from '../hooks/useSoundEffects'

 export function GameCountdown() {
@@ -13,7 +12,7 @@ export function GameCountdown() {

  useEffect(() => {
    const countdownInterval = setInterval(() => {
-      setCount(prevCount => {
+      setCount((prevCount) => {
        if (prevCount > 1) {
          // Play countdown beep (volume 0.4)
          playSound('countdown', 0.4)
@@ -44,43 +43,50 @@ export function GameCountdown() {
  }, [showGo, dispatch])

  return (
-    <div style={{
-      position: 'fixed',
-      top: 0,
-      left: 0,
-      right: 0,
-      bottom: 0,
-      display: 'flex',
-      flexDirection: 'column',
-      alignItems: 'center',
-      justifyContent: 'center',
-      background: 'rgba(0, 0, 0, 0.9)',
-      zIndex: 1000
-    }}>
-      <div style={{
-        fontSize: showGo ? '120px' : '160px',
-        fontWeight: 'bold',
-        color: showGo ? '#10b981' : 'white',
-        textShadow: '0 4px 20px rgba(0, 0, 0, 0.5)',
-        animation: showGo ? 'scaleUp 1s ease-out' : 'pulse 0.5s ease-in-out',
-        transition: 'all 0.3s ease'
-      }}>
+    <div
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        right: 0,
+        bottom: 0,
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        background: 'rgba(0, 0, 0, 0.9)',
+        zIndex: 1000,
+      }}
+    >
+      <div
+        style={{
+          fontSize: showGo ? '120px' : '160px',
+          fontWeight: 'bold',
+          color: showGo ? '#10b981' : 'white',
+          textShadow: '0 4px 20px rgba(0, 0, 0, 0.5)',
+          animation: showGo ? 'scaleUp 1s ease-out' : 'pulse 0.5s ease-in-out',
+          transition: 'all 0.3s ease',
+        }}
+      >
        {showGo ? 'GO!' : count}
      </div>

      {!showGo && (
-        <div style={{
-          marginTop: '32px',
-          fontSize: '24px',
-          color: 'rgba(255, 255, 255, 0.8)',
-          fontWeight: '500'
-        }}>
+        <div
+          style={{
+            marginTop: '32px',
+            fontSize: '24px',
+            color: 'rgba(255, 255, 255, 0.8)',
+            fontWeight: '500',
+          }}
+        >
          Get Ready!
        </div>
      )}

-      <style dangerouslySetInnerHTML={{
-        __html: `
+      <style
+        dangerouslySetInnerHTML={{
+          __html: `
          @keyframes pulse {
            0%, 100% { transform: scale(1); opacity: 1; }
            50% { transform: scale(1.1); opacity: 0.8; }
@@ -90,8 +96,9 @@ export function GameCountdown() {
            50% { transform: scale(1.2); opacity: 1; }
            100% { transform: scale(1); opacity: 1; }
          }
-        `
-      }} />
+        `,
+        }}
+      />
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/GameDisplay.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/GameDisplay.tsx
@@ -1,17 +1,17 @@
 'use client'

-import { useEffect, useState, useCallback } from 'react'
+import { useEffect, useState } from 'react'
 import { useComplementRace } from '../context/ComplementRaceContext'
-import { useAIRacers } from '../hooks/useAIRacers'
 import { useAdaptiveDifficulty } from '../hooks/useAdaptiveDifficulty'
-import { useSteamJourney } from '../hooks/useSteamJourney'
+import { useAIRacers } from '../hooks/useAIRacers'
 import { useSoundEffects } from '../hooks/useSoundEffects'
-import { LinearTrack } from './RaceTrack/LinearTrack'
+import { useSteamJourney } from '../hooks/useSteamJourney'
+import { generatePassengers } from '../lib/passengerGenerator'
+import { AbacusTarget } from './AbacusTarget'
 import { CircularTrack } from './RaceTrack/CircularTrack'
+import { LinearTrack } from './RaceTrack/LinearTrack'
 import { SteamTrainJourney } from './RaceTrack/SteamTrainJourney'
 import { RouteCelebration } from './RouteCelebration'
-import { AbacusTarget } from './AbacusTarget'
-import { generatePassengers } from '../lib/passengerGenerator'

 type FeedbackAnimation = 'correct' | 'incorrect' | null

@@ -45,7 +45,11 @@ export function GameDisplay() {

  // Check for finish line (player reaches race goal) - only for practice mode
  useEffect(() => {
-    if (state.correctAnswers >= state.raceGoal && state.isGameActive && state.style === 'practice') {
+    if (
+      state.correctAnswers >= state.raceGoal &&
+      state.isGameActive &&
+      state.style === 'practice'
+    ) {
      // Play celebration sound (line 14182)
      playSound('celebration')
      // End the game
@@ -70,7 +74,7 @@ export function GameDisplay() {

        // Check if answer is complete
        if (state.currentQuestion) {
-          const answer = parseInt(newInput)
+          const answer = parseInt(newInput, 10)
          const correctAnswer = state.currentQuestion.correctAnswer

          // If we have enough digits to match the answer, submit
@@ -157,7 +161,19 @@ export function GameDisplay() {

    window.addEventListener('keydown', handleKeyPress)
    return () => window.removeEventListener('keydown', handleKeyPress)
-  }, [state.currentInput, state.currentQuestion, state.questionStartTime, state.style, state.streak, dispatch, trackPerformance, getAdaptiveFeedbackMessage, boostMomentum, playSound])
+  }, [
+    state.currentInput,
+    state.currentQuestion,
+    state.questionStartTime,
+    state.style,
+    state.streak,
+    dispatch,
+    trackPerformance,
+    getAdaptiveFeedbackMessage,
+    boostMomentum,
+    playSound,
+    state.momentum,
+  ])

  // Handle route celebration continue
  const handleContinueToNextRoute = () => {
@@ -167,7 +183,7 @@ export function GameDisplay() {
    dispatch({
      type: 'START_NEW_ROUTE',
      routeNumber: nextRoute,
-      stations: state.stations // Keep same stations for now
+      stations: state.stations, // Keep same stations for now
    })

    // Generate new passengers
@@ -178,90 +194,107 @@ export function GameDisplay() {
  if (!state.currentQuestion) return null

  return (
-    <div data-component="game-display" style={{
-      flex: 1,
-      display: 'flex',
-      flexDirection: 'column',
-      width: '100%'
-    }}>
+    <div
+      data-component="game-display"
+      style={{
+        flex: 1,
+        display: 'flex',
+        flexDirection: 'column',
+        width: '100%',
+      }}
+    >
      {/* Adaptive Feedback */}
      {state.adaptiveFeedback && (
-        <div data-component="adaptive-feedback" style={{
-          position: 'fixed',
-          top: '80px',
-          left: '50%',
-          transform: 'translateX(-50%)',
-          background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
-          color: 'white',
-          padding: '12px 24px',
-          borderRadius: '12px',
-          boxShadow: '0 4px 20px rgba(102, 126, 234, 0.4)',
-          fontSize: '16px',
-          fontWeight: 'bold',
-          zIndex: 1000,
-          animation: 'slideDown 0.3s ease-out',
-          maxWidth: '600px',
-          textAlign: 'center'
-        }}>
+        <div
+          data-component="adaptive-feedback"
+          style={{
+            position: 'fixed',
+            top: '80px',
+            left: '50%',
+            transform: 'translateX(-50%)',
+            background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+            color: 'white',
+            padding: '12px 24px',
+            borderRadius: '12px',
+            boxShadow: '0 4px 20px rgba(102, 126, 234, 0.4)',
+            fontSize: '16px',
+            fontWeight: 'bold',
+            zIndex: 1000,
+            animation: 'slideDown 0.3s ease-out',
+            maxWidth: '600px',
+            textAlign: 'center',
+          }}
+        >
          {state.adaptiveFeedback.message}
        </div>
      )}

      {/* Stats Header - constrained width, hidden for sprint mode */}
      {state.style !== 'sprint' && (
-        <div data-component="stats-container" style={{
-          maxWidth: '1200px',
-          margin: '0 auto',
-          width: '100%',
-          padding: '0 20px',
-          marginTop: '10px'
-        }}>
-          <div data-component="stats-header" style={{
-            display: 'flex',
-            justifyContent: 'space-around',
-            marginBottom: '10px',
-            background: 'white',
-            borderRadius: '12px',
-            padding: '10px',
-            boxShadow: '0 2px 8px rgba(0, 0, 0, 0.1)'
-          }}>
-          <div data-stat="score" style={{ textAlign: 'center' }}>
-            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>Score</div>
-            <div style={{ fontWeight: 'bold', fontSize: '24px', color: '#3b82f6' }}>
-              {state.score}
+        <div
+          data-component="stats-container"
+          style={{
+            maxWidth: '1200px',
+            margin: '0 auto',
+            width: '100%',
+            padding: '0 20px',
+            marginTop: '10px',
+          }}
+        >
+          <div
+            data-component="stats-header"
+            style={{
+              display: 'flex',
+              justifyContent: 'space-around',
+              marginBottom: '10px',
+              background: 'white',
+              borderRadius: '12px',
+              padding: '10px',
+              boxShadow: '0 2px 8px rgba(0, 0, 0, 0.1)',
+            }}
+          >
+            <div data-stat="score" style={{ textAlign: 'center' }}>
+              <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>Score</div>
+              <div style={{ fontWeight: 'bold', fontSize: '24px', color: '#3b82f6' }}>
+                {state.score}
+              </div>
+            </div>
+            <div data-stat="streak" style={{ textAlign: 'center' }}>
+              <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>Streak</div>
+              <div style={{ fontWeight: 'bold', fontSize: '24px', color: '#10b981' }}>
+                {state.streak} 🔥
+              </div>
+            </div>
+            <div data-stat="progress" style={{ textAlign: 'center' }}>
+              <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>
+                Progress
+              </div>
+              <div style={{ fontWeight: 'bold', fontSize: '24px', color: '#f59e0b' }}>
+                {state.correctAnswers}/{state.raceGoal}
+              </div>
            </div>
          </div>
-          <div data-stat="streak" style={{ textAlign: 'center' }}>
-            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>Streak</div>
-            <div style={{ fontWeight: 'bold', fontSize: '24px', color: '#10b981' }}>
-              {state.streak} 🔥
-            </div>
-          </div>
-          <div data-stat="progress" style={{ textAlign: 'center' }}>
-            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>Progress</div>
-            <div style={{ fontWeight: 'bold', fontSize: '24px', color: '#f59e0b' }}>
-              {state.correctAnswers}/{state.raceGoal}
-            </div>
-          </div>
-        </div>
        </div>
      )}

      {/* Race Track - full width, break out of padding */}
-      <div data-component="track-container" style={{
-        width: '100vw',
-        position: 'relative',
-        left: '50%',
-        right: '50%',
-        marginLeft: '-50vw',
-        marginRight: '-50vw',
-        padding: state.style === 'sprint' ? '0' : '0 20px',
-        display: 'flex',
-        justifyContent: state.style === 'sprint' ? 'stretch' : 'center',
-        background: 'transparent',
-        flex: state.style === 'sprint' ? 1 : 'initial',
-        minHeight: state.style === 'sprint' ? 0 : 'initial'
-      }}>
+      <div
+        data-component="track-container"
+        style={{
+          width: '100vw',
+          position: 'relative',
+          left: '50%',
+          right: '50%',
+          marginLeft: '-50vw',
+          marginRight: '-50vw',
+          padding: state.style === 'sprint' ? '0' : '0 20px',
+          display: 'flex',
+          justifyContent: state.style === 'sprint' ? 'stretch' : 'center',
+          background: 'transparent',
+          flex: state.style === 'sprint' ? 1 : 'initial',
+          minHeight: state.style === 'sprint' ? 0 : 'initial',
+        }}
+      >
        {state.style === 'survival' ? (
          <CircularTrack
            playerProgress={state.correctAnswers}
@@ -290,54 +323,67 @@ export function GameDisplay() {

      {/* Question Display - only for non-sprint modes */}
      {state.style !== 'sprint' && (
-        <div data-component="question-container" style={{
-          maxWidth: '1200px',
-          margin: '0 auto',
-          width: '100%',
-          padding: '0 20px',
-          display: 'flex',
-          justifyContent: 'center',
-          marginTop: '20px'
-        }}>
-          <div data-component="question-display" style={{
-            background: 'rgba(255, 255, 255, 0.98)',
-            borderRadius: '24px',
-            padding: '28px 50px',
-            boxShadow: '0 16px 40px rgba(0, 0, 0, 0.3), 0 0 0 5px rgba(59, 130, 246, 0.4)',
-            backdropFilter: 'blur(12px)',
-            border: '4px solid rgba(255, 255, 255, 0.95)'
-          }}>
+        <div
+          data-component="question-container"
+          style={{
+            maxWidth: '1200px',
+            margin: '0 auto',
+            width: '100%',
+            padding: '0 20px',
+            display: 'flex',
+            justifyContent: 'center',
+            marginTop: '20px',
+          }}
+        >
+          <div
+            data-component="question-display"
+            style={{
+              background: 'rgba(255, 255, 255, 0.98)',
+              borderRadius: '24px',
+              padding: '28px 50px',
+              boxShadow: '0 16px 40px rgba(0, 0, 0, 0.3), 0 0 0 5px rgba(59, 130, 246, 0.4)',
+              backdropFilter: 'blur(12px)',
+              border: '4px solid rgba(255, 255, 255, 0.95)',
+            }}
+          >
            {/* Complement equation as main focus */}
-            <div data-element="question-equation" style={{
-              fontSize: '96px',
-              fontWeight: 'bold',
-              color: '#1f2937',
-              lineHeight: '1.1',
-              display: 'flex',
-              alignItems: 'center',
-              gap: '20px',
-              justifyContent: 'center'
-            }}>
-              <span style={{
-                background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
-                color: 'white',
-                padding: '12px 32px',
-                borderRadius: '16px',
-                minWidth: '140px',
-                display: 'inline-block',
-                textShadow: '0 3px 10px rgba(0, 0, 0, 0.3)'
-              }}>
+            <div
+              data-element="question-equation"
+              style={{
+                fontSize: '96px',
+                fontWeight: 'bold',
+                color: '#1f2937',
+                lineHeight: '1.1',
+                display: 'flex',
+                alignItems: 'center',
+                gap: '20px',
+                justifyContent: 'center',
+              }}
+            >
+              <span
+                style={{
+                  background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
+                  color: 'white',
+                  padding: '12px 32px',
+                  borderRadius: '16px',
+                  minWidth: '140px',
+                  display: 'inline-block',
+                  textShadow: '0 3px 10px rgba(0, 0, 0, 0.3)',
+                }}
+              >
                {state.currentInput || '?'}
              </span>
              <span style={{ color: '#6b7280' }}>+</span>
              {state.currentQuestion.showAsAbacus ? (
-                <div style={{
-                  transform: 'scale(2.4) translateY(8%)',
-                  transformOrigin: 'center center',
-                  display: 'flex',
-                  alignItems: 'center',
-                  justifyContent: 'center'
-                }}>
+                <div
+                  style={{
+                    transform: 'scale(2.4) translateY(8%)',
+                    transformOrigin: 'center center',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                  }}
+                >
                  <AbacusTarget number={state.currentQuestion.number} />
                </div>
              ) : (
@@ -360,4 +406,4 @@ export function GameDisplay() {
      )}
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/GameIntro.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/GameIntro.tsx
@@ -10,59 +10,71 @@ export function GameIntro() {
  }

  return (
-    <div style={{
-      textAlign: 'center',
-      padding: '40px 20px',
-      maxWidth: '800px',
-      margin: '20px auto 0'
-    }}>
-      <h1 style={{
-        fontSize: '48px',
-        fontWeight: 'bold',
-        marginBottom: '16px',
-        background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
-        WebkitBackgroundClip: 'text',
-        WebkitTextFillColor: 'transparent',
-        backgroundClip: 'text'
-      }}>
+    <div
+      style={{
+        textAlign: 'center',
+        padding: '40px 20px',
+        maxWidth: '800px',
+        margin: '20px auto 0',
+      }}
+    >
+      <h1
+        style={{
+          fontSize: '48px',
+          fontWeight: 'bold',
+          marginBottom: '16px',
+          background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
+          WebkitBackgroundClip: 'text',
+          WebkitTextFillColor: 'transparent',
+          backgroundClip: 'text',
+        }}
+      >
        Speed Complement Race
      </h1>

-      <p style={{
-        fontSize: '18px',
-        color: '#6b7280',
-        marginBottom: '32px',
-        lineHeight: '1.6'
-      }}>
-        Race against AI opponents while solving complement problems!
-        Find the missing number to complete the equation.
+      <p
+        style={{
+          fontSize: '18px',
+          color: '#6b7280',
+          marginBottom: '32px',
+          lineHeight: '1.6',
+        }}
+      >
+        Race against AI opponents while solving complement problems! Find the missing number to
+        complete the equation.
      </p>

-      <div style={{
-        background: 'white',
-        borderRadius: '16px',
-        padding: '32px',
-        marginBottom: '32px',
-        boxShadow: '0 4px 12px rgba(0, 0, 0, 0.1)',
-        textAlign: 'left'
-      }}>
-        <h2 style={{
-          fontSize: '24px',
-          fontWeight: 'bold',
-          marginBottom: '16px',
-          color: '#1f2937'
-        }}>
+      <div
+        style={{
+          background: 'white',
+          borderRadius: '16px',
+          padding: '32px',
+          marginBottom: '32px',
+          boxShadow: '0 4px 12px rgba(0, 0, 0, 0.1)',
+          textAlign: 'left',
+        }}
+      >
+        <h2
+          style={{
+            fontSize: '24px',
+            fontWeight: 'bold',
+            marginBottom: '16px',
+            color: '#1f2937',
+          }}
+        >
          How to Play
        </h2>

-        <ul style={{
-          listStyle: 'none',
-          padding: 0,
-          margin: 0,
-          display: 'flex',
-          flexDirection: 'column',
-          gap: '12px'
-        }}>
+        <ul
+          style={{
+            listStyle: 'none',
+            padding: 0,
+            margin: 0,
+            display: 'flex',
+            flexDirection: 'column',
+            gap: '12px',
+          }}
+        >
          <li style={{ display: 'flex', gap: '12px', alignItems: 'start' }}>
            <span style={{ fontSize: '24px' }}>🎯</span>
            <span style={{ color: '#4b5563', lineHeight: '1.6' }}>
@@ -102,7 +114,7 @@ export function GameIntro() {
          fontWeight: 'bold',
          cursor: 'pointer',
          boxShadow: '0 4px 12px rgba(16, 185, 129, 0.3)',
-          transition: 'all 0.2s ease'
+          transition: 'all 0.2s ease',
        }}
        onMouseEnter={(e) => {
          e.currentTarget.style.transform = 'translateY(-2px)'
@@ -117,4 +129,4 @@ export function GameIntro() {
      </button>
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/GameResults.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/GameResults.tsx
@@ -6,68 +6,81 @@ export function GameResults() {
  const { state, dispatch } = useComplementRace()

  // Determine race outcome
-  const playerWon = state.aiRacers.every(racer => state.correctAnswers > racer.position)
-  const playerPosition = state.aiRacers.filter(racer => racer.position >= state.correctAnswers).length + 1
+  const playerWon = state.aiRacers.every((racer) => state.correctAnswers > racer.position)
+  const playerPosition =
+    state.aiRacers.filter((racer) => racer.position >= state.correctAnswers).length + 1

  return (
-    <div style={{
-      flex: 1,
-      display: 'flex',
-      flexDirection: 'column',
-      alignItems: 'center',
-      justifyContent: 'center',
-      padding: '60px 40px 40px',
-      background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
-      minHeight: '100vh'
-    }}>
-      <div style={{
-        background: 'white',
-        borderRadius: '24px',
-        padding: '48px',
-        maxWidth: '600px',
-        width: '100%',
-        boxShadow: '0 20px 60px rgba(0, 0, 0, 0.3)',
-        textAlign: 'center'
-      }}>
+    <div
+      style={{
+        flex: 1,
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: '60px 40px 40px',
+        background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+        minHeight: '100vh',
+      }}
+    >
+      <div
+        style={{
+          background: 'white',
+          borderRadius: '24px',
+          padding: '48px',
+          maxWidth: '600px',
+          width: '100%',
+          boxShadow: '0 20px 60px rgba(0, 0, 0, 0.3)',
+          textAlign: 'center',
+        }}
+      >
        {/* Result Header */}
-        <div style={{
-          fontSize: '64px',
-          marginBottom: '16px'
-        }}>
+        <div
+          style={{
+            fontSize: '64px',
+            marginBottom: '16px',
+          }}
+        >
          {playerWon ? '🏆' : playerPosition === 2 ? '🥈' : playerPosition === 3 ? '🥉' : '🎯'}
        </div>

-        <h1 style={{
-          fontSize: '36px',
-          fontWeight: 'bold',
-          color: '#1f2937',
-          marginBottom: '8px'
-        }}>
+        <h1
+          style={{
+            fontSize: '36px',
+            fontWeight: 'bold',
+            color: '#1f2937',
+            marginBottom: '8px',
+          }}
+        >
          {playerWon ? 'Victory!' : `${playerPosition}${getOrdinalSuffix(playerPosition)} Place`}
        </h1>

-        <p style={{
-          fontSize: '18px',
-          color: '#6b7280',
-          marginBottom: '32px'
-        }}>
-          {playerWon
-            ? 'You beat all the AI racers!'
-            : `You finished the race!`}
+        <p
+          style={{
+            fontSize: '18px',
+            color: '#6b7280',
+            marginBottom: '32px',
+          }}
+        >
+          {playerWon ? 'You beat all the AI racers!' : `You finished the race!`}
        </p>

        {/* Stats */}
-        <div style={{
-          display: 'grid',
-          gridTemplateColumns: 'repeat(2, 1fr)',
-          gap: '16px',
-          marginBottom: '32px'
-        }}>
-          <div style={{
-            background: '#f3f4f6',
-            borderRadius: '12px',
-            padding: '16px'
-          }}>
+        <div
+          style={{
+            display: 'grid',
+            gridTemplateColumns: 'repeat(2, 1fr)',
+            gap: '16px',
+            marginBottom: '32px',
+          }}
+        >
+          <div
+            style={{
+              background: '#f3f4f6',
+              borderRadius: '12px',
+              padding: '16px',
+            }}
+          >
            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>
              Final Score
            </div>
@@ -76,11 +89,13 @@ export function GameResults() {
            </div>
          </div>

-          <div style={{
-            background: '#f3f4f6',
-            borderRadius: '12px',
-            padding: '16px'
-          }}>
+          <div
+            style={{
+              background: '#f3f4f6',
+              borderRadius: '12px',
+              padding: '16px',
+            }}
+          >
            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>
              Best Streak
            </div>
@@ -89,11 +104,13 @@ export function GameResults() {
            </div>
          </div>

-          <div style={{
-            background: '#f3f4f6',
-            borderRadius: '12px',
-            padding: '16px'
-          }}>
+          <div
+            style={{
+              background: '#f3f4f6',
+              borderRadius: '12px',
+              padding: '16px',
+            }}
+          >
            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>
              Total Questions
            </div>
@@ -102,43 +119,48 @@ export function GameResults() {
            </div>
          </div>

-          <div style={{
-            background: '#f3f4f6',
-            borderRadius: '12px',
-            padding: '16px'
-          }}>
-            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>
-              Accuracy
-            </div>
+          <div
+            style={{
+              background: '#f3f4f6',
+              borderRadius: '12px',
+              padding: '16px',
+            }}
+          >
+            <div style={{ color: '#6b7280', fontSize: '14px', marginBottom: '4px' }}>Accuracy</div>
            <div style={{ fontSize: '28px', fontWeight: 'bold', color: '#8b5cf6' }}>
              {state.totalQuestions > 0
                ? Math.round((state.correctAnswers / state.totalQuestions) * 100)
-                : 0}%
+                : 0}
+              %
            </div>
          </div>
        </div>

        {/* Final Standings */}
-        <div style={{
-          marginBottom: '32px',
-          textAlign: 'left'
-        }}>
-          <h3 style={{
-            fontSize: '18px',
-            fontWeight: 'bold',
-            color: '#1f2937',
-            marginBottom: '12px'
-          }}>
+        <div
+          style={{
+            marginBottom: '32px',
+            textAlign: 'left',
+          }}
+        >
+          <h3
+            style={{
+              fontSize: '18px',
+              fontWeight: 'bold',
+              color: '#1f2937',
+              marginBottom: '12px',
+            }}
+          >
            Final Standings
          </h3>

          {[
            { name: 'You', position: state.correctAnswers, icon: '👤' },
-            ...state.aiRacers.map(racer => ({
+            ...state.aiRacers.map((racer) => ({
              name: racer.name,
              position: racer.position,
-              icon: racer.icon
-            }))
+              icon: racer.icon,
+            })),
          ]
            .sort((a, b) => b.position - a.position)
            .map((racer, index) => (
@@ -152,11 +174,18 @@ export function GameResults() {
                  background: racer.name === 'You' ? '#eff6ff' : '#f9fafb',
                  borderRadius: '8px',
                  marginBottom: '8px',
-                  border: racer.name === 'You' ? '2px solid #3b82f6' : 'none'
+                  border: racer.name === 'You' ? '2px solid #3b82f6' : 'none',
                }}
              >
                <div style={{ display: 'flex', alignItems: 'center', gap: '12px' }}>
-                  <div style={{ fontSize: '24px', fontWeight: 'bold', color: '#9ca3af', minWidth: '32px' }}>
+                  <div
+                    style={{
+                      fontSize: '24px',
+                      fontWeight: 'bold',
+                      color: '#9ca3af',
+                      minWidth: '32px',
+                    }}
+                  >
                    #{index + 1}
                  </div>
                  <div style={{ fontSize: '20px' }}>{racer.icon}</div>
@@ -172,10 +201,12 @@ export function GameResults() {
        </div>

        {/* Buttons */}
-        <div style={{
-          display: 'flex',
-          gap: '12px'
-        }}>
+        <div
+          style={{
+            display: 'flex',
+            gap: '12px',
+          }}
+        >
          <button
            onClick={() => dispatch({ type: 'RESET_GAME' })}
            style={{
@@ -189,7 +220,7 @@ export function GameResults() {
              border: 'none',
              cursor: 'pointer',
              transition: 'transform 0.2s',
-              boxShadow: '0 4px 12px rgba(102, 126, 234, 0.4)'
+              boxShadow: '0 4px 12px rgba(102, 126, 234, 0.4)',
            }}
            onMouseEnter={(e) => {
              e.currentTarget.style.transform = 'translateY(-2px)'
@@ -211,4 +242,4 @@ function getOrdinalSuffix(num: number): string {
  if (num === 2) return 'nd'
  if (num === 3) return 'rd'
  return 'th'
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/PassengerCard.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/PassengerCard.tsx
@@ -9,29 +9,32 @@ interface PassengerCardProps {
  destinationStation: Station | undefined
 }

-export const PassengerCard = memo(function PassengerCard({ passenger, originStation, destinationStation }: PassengerCardProps) {
+export const PassengerCard = memo(function PassengerCard({
+  passenger,
+  originStation,
+  destinationStation,
+}: PassengerCardProps) {
  if (!destinationStation || !originStation) return null

  // Vintage train station colors
  const bgColor = passenger.isDelivered
    ? '#1a3a1a' // Dark green for delivered
    : !passenger.isBoarded
-    ? '#2a2419' // Dark brown/sepia for waiting
-    : passenger.isUrgent
-    ? '#3a2419' // Dark red-brown for urgent
-    : '#1a2a3a' // Dark blue for aboard
+      ? '#2a2419' // Dark brown/sepia for waiting
+      : passenger.isUrgent
+        ? '#3a2419' // Dark red-brown for urgent
+        : '#1a2a3a' // Dark blue for aboard

  const accentColor = passenger.isDelivered
    ? '#4ade80' // Green
    : !passenger.isBoarded
-    ? '#d4af37' // Gold for waiting
-    : passenger.isUrgent
-    ? '#ff6b35' // Orange-red for urgent
-    : '#60a5fa' // Blue for aboard
+      ? '#d4af37' // Gold for waiting
+      : passenger.isUrgent
+        ? '#ff6b35' // Orange-red for urgent
+        : '#60a5fa' // Blue for aboard

-  const borderColor = passenger.isUrgent && passenger.isBoarded && !passenger.isDelivered
-    ? '#ff6b35'
-    : '#d4af37'
+  const borderColor =
+    passenger.isUrgent && passenger.isBoarded && !passenger.isDelivered ? '#ff6b35' : '#d4af37'

  return (
    <div
@@ -42,122 +45,142 @@ export const PassengerCard = memo(function PassengerCard({ passenger, originStat
        padding: '8px 10px',
        minWidth: '220px',
        maxWidth: '280px',
-        boxShadow: passenger.isUrgent && !passenger.isDelivered && passenger.isBoarded
-          ? '0 0 16px rgba(255, 107, 53, 0.5)'
-          : '0 4px 12px rgba(0, 0, 0, 0.4)',
+        boxShadow:
+          passenger.isUrgent && !passenger.isDelivered && passenger.isBoarded
+            ? '0 0 16px rgba(255, 107, 53, 0.5)'
+            : '0 4px 12px rgba(0, 0, 0, 0.4)',
        position: 'relative',
        fontFamily: '"Courier New", Courier, monospace',
-        animation: passenger.isUrgent && !passenger.isDelivered && passenger.isBoarded
-          ? 'urgentFlicker 1.5s ease-in-out infinite'
-          : 'none',
-        transition: 'all 0.3s ease'
+        animation:
+          passenger.isUrgent && !passenger.isDelivered && passenger.isBoarded
+            ? 'urgentFlicker 1.5s ease-in-out infinite'
+            : 'none',
+        transition: 'all 0.3s ease',
      }}
    >
      {/* Top row: Passenger info and status */}
-      <div style={{
-        display: 'flex',
-        alignItems: 'flex-start',
-        justifyContent: 'space-between',
-        marginBottom: '6px',
-        borderBottom: `1px solid ${accentColor}33`,
-        paddingBottom: '4px',
-        paddingRight: '42px' // Make room for points badge
-      }}>
-        <div style={{
+      <div
+        style={{
          display: 'flex',
-          alignItems: 'center',
-          gap: '6px',
-          flex: 1
-        }}>
+          alignItems: 'flex-start',
+          justifyContent: 'space-between',
+          marginBottom: '6px',
+          borderBottom: `1px solid ${accentColor}33`,
+          paddingBottom: '4px',
+          paddingRight: '42px', // Make room for points badge
+        }}
+      >
+        <div
+          style={{
+            display: 'flex',
+            alignItems: 'center',
+            gap: '6px',
+            flex: 1,
+          }}
+        >
          <div style={{ fontSize: '20px', lineHeight: '1' }}>
            {passenger.isDelivered ? '✅' : passenger.avatar}
          </div>
-          <div style={{
-            fontSize: '11px',
-            fontWeight: 'bold',
-            color: accentColor,
-            letterSpacing: '0.5px',
-            textTransform: 'uppercase'
-          }}>
+          <div
+            style={{
+              fontSize: '11px',
+              fontWeight: 'bold',
+              color: accentColor,
+              letterSpacing: '0.5px',
+              textTransform: 'uppercase',
+            }}
+          >
            {passenger.name}
          </div>
        </div>

        {/* Status indicator */}
-        <div style={{
-          fontSize: '9px',
-          color: accentColor,
-          fontWeight: 'bold',
-          letterSpacing: '0.5px',
-          background: `${accentColor}22`,
-          padding: '2px 6px',
-          borderRadius: '2px',
-          border: `1px solid ${accentColor}66`,
-          whiteSpace: 'nowrap',
-          marginTop: '0'
-        }}>
+        <div
+          style={{
+            fontSize: '9px',
+            color: accentColor,
+            fontWeight: 'bold',
+            letterSpacing: '0.5px',
+            background: `${accentColor}22`,
+            padding: '2px 6px',
+            borderRadius: '2px',
+            border: `1px solid ${accentColor}66`,
+            whiteSpace: 'nowrap',
+            marginTop: '0',
+          }}
+        >
          {passenger.isDelivered ? 'DLVRD' : passenger.isBoarded ? 'BOARD' : 'WAIT'}
        </div>
      </div>

      {/* Route information */}
-      <div style={{
-        display: 'flex',
-        flexDirection: 'column',
-        gap: '3px',
-        fontSize: '10px',
-        color: '#e8d4a0'
-      }}>
-        {/* From station */}
-        <div style={{
+      <div
+        style={{
          display: 'flex',
-          alignItems: 'center',
-          gap: '6px'
-        }}>
-          <span style={{
-            color: accentColor,
-            fontSize: '8px',
-            fontWeight: 'bold',
-            width: '28px',
-            letterSpacing: '0.3px'
-          }}>
+          flexDirection: 'column',
+          gap: '3px',
+          fontSize: '10px',
+          color: '#e8d4a0',
+        }}
+      >
+        {/* From station */}
+        <div
+          style={{
+            display: 'flex',
+            alignItems: 'center',
+            gap: '6px',
+          }}
+        >
+          <span
+            style={{
+              color: accentColor,
+              fontSize: '8px',
+              fontWeight: 'bold',
+              width: '28px',
+              letterSpacing: '0.3px',
+            }}
+          >
            FROM:
          </span>
-          <span style={{ fontSize: '14px', lineHeight: '1' }}>
-            {originStation.icon}
-          </span>
-          <span style={{
-            fontWeight: '600',
-            fontSize: '10px',
-            letterSpacing: '0.3px'
-          }}>
+          <span style={{ fontSize: '14px', lineHeight: '1' }}>{originStation.icon}</span>
+          <span
+            style={{
+              fontWeight: '600',
+              fontSize: '10px',
+              letterSpacing: '0.3px',
+            }}
+          >
            {originStation.name}
          </span>
        </div>

        {/* To station */}
-        <div style={{
-          display: 'flex',
-          alignItems: 'center',
-          gap: '6px'
-        }}>
-          <span style={{
-            color: accentColor,
-            fontSize: '8px',
-            fontWeight: 'bold',
-            width: '28px',
-            letterSpacing: '0.3px'
-          }}>
+        <div
+          style={{
+            display: 'flex',
+            alignItems: 'center',
+            gap: '6px',
+          }}
+        >
+          <span
+            style={{
+              color: accentColor,
+              fontSize: '8px',
+              fontWeight: 'bold',
+              width: '28px',
+              letterSpacing: '0.3px',
+            }}
+          >
            TO:
          </span>
-          <span style={{ fontSize: '14px', lineHeight: '1' }}>
-            {destinationStation.icon}
-          </span>
-          <span style={{
-            fontWeight: '600',
-            fontSize: '10px',
-            letterSpacing: '0.3px'
-          }}>
+          <span style={{ fontSize: '14px', lineHeight: '1' }}>{destinationStation.icon}</span>
+          <span
+            style={{
+              fontWeight: '600',
+              fontSize: '10px',
+              letterSpacing: '0.3px',
+            }}
+          >
            {destinationStation.name}
          </span>
        </div>
@@ -165,33 +188,37 @@ export const PassengerCard = memo(function PassengerCard({ passenger, originStat

      {/* Points badge */}
      {!passenger.isDelivered && (
-        <div style={{
-          position: 'absolute',
-          top: '6px',
-          right: '6px',
-          background: `${accentColor}33`,
-          border: `1px solid ${accentColor}`,
-          borderRadius: '2px',
-          padding: '2px 6px',
-          fontSize: '10px',
-          fontWeight: 'bold',
-          color: accentColor,
-          letterSpacing: '0.5px'
-        }}>
+        <div
+          style={{
+            position: 'absolute',
+            top: '6px',
+            right: '6px',
+            background: `${accentColor}33`,
+            border: `1px solid ${accentColor}`,
+            borderRadius: '2px',
+            padding: '2px 6px',
+            fontSize: '10px',
+            fontWeight: 'bold',
+            color: accentColor,
+            letterSpacing: '0.5px',
+          }}
+        >
          {passenger.isUrgent ? '+20' : '+10'}
        </div>
      )}

      {/* Urgent indicator */}
      {passenger.isUrgent && !passenger.isDelivered && passenger.isBoarded && (
-        <div style={{
-          position: 'absolute',
-          left: '8px',
-          bottom: '6px',
-          fontSize: '10px',
-          animation: 'urgentBlink 0.8s ease-in-out infinite',
-          filter: 'drop-shadow(0 0 4px rgba(255, 107, 53, 0.8))'
-        }}>
+        <div
+          style={{
+            position: 'absolute',
+            left: '8px',
+            bottom: '6px',
+            fontSize: '10px',
+            animation: 'urgentBlink 0.8s ease-in-out infinite',
+            filter: 'drop-shadow(0 0 4px rgba(255, 107, 53, 0.8))',
+          }}
+        >
          ⚠️
        </div>
      )}
--- a/apps/web/src/app/arcade/complement-race/components/PressureGauge.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/PressureGauge.tsx
@@ -1,6 +1,6 @@
 'use client'

-import { useSpring, animated } from '@react-spring/web'
+import { animated, useSpring } from '@react-spring/web'
 import { AbacusReact } from '@soroban/abacus-react'

 interface PressureGaugeProps {
@@ -16,38 +16,42 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
    config: {
      tension: 120,
      friction: 14,
-      clamp: false
-    }
+      clamp: false,
+    },
  })

  // Calculate needle angle - sweeps 180° from left to right
  // 0 PSI = 180° (pointing left), 150 PSI = 0° (pointing right)
-  const angle = spring.pressure.to(p => 180 - (p / maxPressure) * 180)
+  const angle = spring.pressure.to((p) => 180 - (p / maxPressure) * 180)

  // Get pressure color (animated)
-  const color = spring.pressure.to(p => {
+  const color = spring.pressure.to((p) => {
    if (p < 50) return '#ef4444' // Red (low)
    if (p < 100) return '#f59e0b' // Orange (medium)
    return '#10b981' // Green (high)
  })

  return (
-    <div style={{
-      position: 'relative',
-      background: 'rgba(255, 255, 255, 0.95)',
-      padding: '16px',
-      borderRadius: '12px',
-      minWidth: '220px',
-      boxShadow: '0 2px 8px rgba(0, 0, 0, 0.2)'
-    }}>
+    <div
+      style={{
+        position: 'relative',
+        background: 'rgba(255, 255, 255, 0.95)',
+        padding: '16px',
+        borderRadius: '12px',
+        minWidth: '220px',
+        boxShadow: '0 2px 8px rgba(0, 0, 0, 0.2)',
+      }}
+    >
      {/* Title */}
-      <div style={{
-        fontSize: '12px',
-        color: '#6b7280',
-        marginBottom: '8px',
-        fontWeight: 'bold',
-        textAlign: 'center'
-      }}>
+      <div
+        style={{
+          fontSize: '12px',
+          color: '#6b7280',
+          marginBottom: '8px',
+          fontWeight: 'bold',
+          textAlign: 'center',
+        }}
+      >
        PRESSURE
      </div>

@@ -57,7 +61,7 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
        style={{
          width: '100%',
          height: 'auto',
-          marginBottom: '8px'
+          marginBottom: '8px',
        }}
      >
        {/* Background arc - semicircle from left to right (bottom half) */}
@@ -75,9 +79,9 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
          const tickAngle = 180 - (psi / maxPressure) * 180
          const tickRad = (tickAngle * Math.PI) / 180
          const x1 = 100 + Math.cos(tickRad) * 70
-          const y1 = 100 - Math.sin(tickRad) * 70  // Subtract for SVG coords
+          const y1 = 100 - Math.sin(tickRad) * 70 // Subtract for SVG coords
          const x2 = 100 + Math.cos(tickRad) * 80
-          const y2 = 100 - Math.sin(tickRad) * 80  // Subtract for SVG coords
+          const y2 = 100 - Math.sin(tickRad) * 80 // Subtract for SVG coords

          // Position for abacus label
          const labelX = 100 + Math.cos(tickRad) * 112
@@ -94,18 +98,15 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
                strokeWidth="2"
                strokeLinecap="round"
              />
-              <foreignObject
-                x={labelX - 30}
-                y={labelY - 25}
-                width="60"
-                height="100"
-              >
-                <div style={{
-                  display: 'flex',
-                  alignItems: 'center',
-                  justifyContent: 'center',
-                  lineHeight: 0
-                }}>
+              <foreignObject x={labelX - 30} y={labelY - 25} width="60" height="100">
+                <div
+                  style={{
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    lineHeight: 0,
+                  }}
+                >
                  <AbacusReact
                    value={psi}
                    columns={3}
@@ -114,7 +115,7 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
                    hideInactiveBeads={false}
                    scaleFactor={0.6}
                    customStyles={{
-                      columnPosts: { opacity: 0 }
+                      columnPosts: { opacity: 0 },
                    }}
                  />
                </div>
@@ -130,32 +131,36 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
        <animated.line
          x1="100"
          y1="100"
-          x2={angle.to(a => 100 + Math.cos((a * Math.PI) / 180) * 70)}
-          y2={angle.to(a => 100 - Math.sin((a * Math.PI) / 180) * 70)}
+          x2={angle.to((a) => 100 + Math.cos((a * Math.PI) / 180) * 70)}
+          y2={angle.to((a) => 100 - Math.sin((a * Math.PI) / 180) * 70)}
          stroke={color}
          strokeWidth="3"
          strokeLinecap="round"
          style={{
-            filter: color.to(c => `drop-shadow(0 2px 3px ${c})`)
+            filter: color.to((c) => `drop-shadow(0 2px 3px ${c})`),
          }}
        />
      </svg>

      {/* Abacus readout */}
-      <div style={{
-        textAlign: 'center',
-        display: 'flex',
-        alignItems: 'center',
-        justifyContent: 'center',
-        gap: '8px',
-        minHeight: '32px'
-      }}>
-        <div style={{
-          display: 'inline-flex',
+      <div
+        style={{
+          textAlign: 'center',
+          display: 'flex',
          alignItems: 'center',
          justifyContent: 'center',
-          lineHeight: 0
-        }}>
+          gap: '8px',
+          minHeight: '32px',
+        }}
+      >
+        <div
+          style={{
+            display: 'inline-flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            lineHeight: 0,
+          }}
+        >
          <AbacusReact
            value={Math.round(pressure)}
            columns={3}
@@ -164,7 +169,7 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
            hideInactiveBeads={true}
            scaleFactor={0.35}
            customStyles={{
-              columnPosts: { opacity: 0 }
+              columnPosts: { opacity: 0 },
            }}
          />
        </div>
@@ -172,4 +177,4 @@ export function PressureGauge({ pressure }: PressureGaugeProps) {
      </div>
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/CircularTrack.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/CircularTrack.tsx
@@ -1,12 +1,12 @@
 'use client'

 import { useEffect, useState } from 'react'
-import type { AIRacer } from '../../lib/gameTypes'
-import { SpeechBubble } from '../AISystem/SpeechBubble'
-import { useComplementRace } from '../../context/ComplementRaceContext'
 import { useGameMode } from '@/contexts/GameModeContext'
 import { useUserProfile } from '@/contexts/UserProfileContext'
+import { useComplementRace } from '../../context/ComplementRaceContext'
 import { useSoundEffects } from '../../hooks/useSoundEffects'
+import type { AIRacer } from '../../lib/gameTypes'
+import { SpeechBubble } from '../AISystem/SpeechBubble'

 interface CircularTrackProps {
  playerProgress: number
@@ -18,12 +18,12 @@ interface CircularTrackProps {
 export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: CircularTrackProps) {
  const { state, dispatch } = useComplementRace()
  const { players } = useGameMode()
-  const { profile } = useUserProfile()
+  const { profile: _profile } = useUserProfile()
  const { playSound } = useSoundEffects()
  const [celebrationCooldown, setCelebrationCooldown] = useState<Set<string>>(new Set())

  // Get the first active player's emoji
-  const activePlayers = Array.from(players.values()).filter(p => p.id)
+  const activePlayers = Array.from(players.values()).filter((p) => p.id)
  const firstActivePlayer = activePlayers[0]
  const playerEmoji = firstActivePlayer?.emoji ?? '👤'
  const [dimensions, setDimensions] = useState({ width: 600, height: 400 })
@@ -54,8 +54,8 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
  }, [])

  const padding = 40
-  const trackWidth = dimensions.width - (padding * 2)
-  const trackHeight = dimensions.height - (padding * 2)
+  const trackWidth = dimensions.width - padding * 2
+  const trackHeight = dimensions.height - padding * 2

  // For a rounded rectangle track, we have straight sections and curved ends
  const straightLength = Math.max(trackWidth, trackHeight) - Math.min(trackWidth, trackHeight)
@@ -70,7 +70,7 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
    // Track perimeter consists of: 2 straights + 2 semicircles
    const straightPerim = straightLength
    const curvePerim = Math.PI * radius
-    const totalPerim = (2 * straightPerim) + (2 * curvePerim)
+    const totalPerim = 2 * straightPerim + 2 * curvePerim

    const distanceAlongTrack = normalizedProgress * totalPerim

@@ -84,67 +84,67 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
      const topStraightEnd = straightPerim
      const rightCurveEnd = topStraightEnd + curvePerim
      const bottomStraightEnd = rightCurveEnd + straightPerim
-      const leftCurveEnd = bottomStraightEnd + curvePerim
+      const _leftCurveEnd = bottomStraightEnd + curvePerim

      if (distanceAlongTrack < topStraightEnd) {
        // Top straight (moving right)
        const t = distanceAlongTrack / straightPerim
-        x = centerX - (straightLength / 2) + (t * straightLength)
+        x = centerX - straightLength / 2 + t * straightLength
        y = centerY - radius
        angle = 90
      } else if (distanceAlongTrack < rightCurveEnd) {
        // Right curve
        const curveProgress = (distanceAlongTrack - topStraightEnd) / curvePerim
-        const curveAngle = curveProgress * Math.PI - (Math.PI / 2)
-        x = centerX + (straightLength / 2) + (radius * Math.cos(curveAngle))
-        y = centerY + (radius * Math.sin(curveAngle))
-        angle = (curveProgress * 180) + 90
+        const curveAngle = curveProgress * Math.PI - Math.PI / 2
+        x = centerX + straightLength / 2 + radius * Math.cos(curveAngle)
+        y = centerY + radius * Math.sin(curveAngle)
+        angle = curveProgress * 180 + 90
      } else if (distanceAlongTrack < bottomStraightEnd) {
        // Bottom straight (moving left)
        const t = (distanceAlongTrack - rightCurveEnd) / straightPerim
-        x = centerX + (straightLength / 2) - (t * straightLength)
+        x = centerX + straightLength / 2 - t * straightLength
        y = centerY + radius
        angle = 270
      } else {
        // Left curve
        const curveProgress = (distanceAlongTrack - bottomStraightEnd) / curvePerim
-        const curveAngle = curveProgress * Math.PI + (Math.PI / 2)
-        x = centerX - (straightLength / 2) + (radius * Math.cos(curveAngle))
-        y = centerY + (radius * Math.sin(curveAngle))
-        angle = (curveProgress * 180) + 270
+        const curveAngle = curveProgress * Math.PI + Math.PI / 2
+        x = centerX - straightLength / 2 + radius * Math.cos(curveAngle)
+        y = centerY + radius * Math.sin(curveAngle)
+        angle = curveProgress * 180 + 270
      }
    } else {
      // Vertical track: straight sections on left/right, curves on top/bottom
      const leftStraightEnd = straightPerim
      const bottomCurveEnd = leftStraightEnd + curvePerim
      const rightStraightEnd = bottomCurveEnd + straightPerim
-      const topCurveEnd = rightStraightEnd + curvePerim
+      const _topCurveEnd = rightStraightEnd + curvePerim

      if (distanceAlongTrack < leftStraightEnd) {
        // Left straight (moving down)
        const t = distanceAlongTrack / straightPerim
        x = centerX - radius
-        y = centerY - (straightLength / 2) + (t * straightLength)
+        y = centerY - straightLength / 2 + t * straightLength
        angle = 180
      } else if (distanceAlongTrack < bottomCurveEnd) {
        // Bottom curve
        const curveProgress = (distanceAlongTrack - leftStraightEnd) / curvePerim
        const curveAngle = curveProgress * Math.PI
-        x = centerX + (radius * Math.cos(curveAngle))
-        y = centerY + (straightLength / 2) + (radius * Math.sin(curveAngle))
-        angle = (curveProgress * 180) + 180
+        x = centerX + radius * Math.cos(curveAngle)
+        y = centerY + straightLength / 2 + radius * Math.sin(curveAngle)
+        angle = curveProgress * 180 + 180
      } else if (distanceAlongTrack < rightStraightEnd) {
        // Right straight (moving up)
        const t = (distanceAlongTrack - bottomCurveEnd) / straightPerim
        x = centerX + radius
-        y = centerY + (straightLength / 2) - (t * straightLength)
+        y = centerY + straightLength / 2 - t * straightLength
        angle = 0
      } else {
        // Top curve
        const curveProgress = (distanceAlongTrack - rightStraightEnd) / curvePerim
        const curveAngle = curveProgress * Math.PI + Math.PI
-        x = centerX + (radius * Math.cos(curveAngle))
-        y = centerY - (straightLength / 2) + (radius * Math.sin(curveAngle))
+        x = centerX + radius * Math.cos(curveAngle)
+        y = centerY - straightLength / 2 + radius * Math.sin(curveAngle)
        angle = curveProgress * 180
      }
    }
@@ -160,9 +160,9 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
      dispatch({ type: 'COMPLETE_LAP', racerId: 'player' })
      // Play celebration sound (line 12801)
      playSound('lap_celebration', 0.6)
-      setCelebrationCooldown(prev => new Set(prev).add('player'))
+      setCelebrationCooldown((prev) => new Set(prev).add('player'))
      setTimeout(() => {
-        setCelebrationCooldown(prev => {
+        setCelebrationCooldown((prev) => {
          const next = new Set(prev)
          next.delete('player')
          return next
@@ -171,14 +171,14 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
    }

    // Check AI laps
-    aiRacers.forEach(racer => {
+    aiRacers.forEach((racer) => {
      const aiCurrentLap = Math.floor(racer.position / 50)
      const aiPreviousLap = aiLaps.get(racer.id) || 0
      if (aiCurrentLap > aiPreviousLap && !celebrationCooldown.has(racer.id)) {
        dispatch({ type: 'COMPLETE_LAP', racerId: racer.id })
-        setCelebrationCooldown(prev => new Set(prev).add(racer.id))
+        setCelebrationCooldown((prev) => new Set(prev).add(racer.id))
        setTimeout(() => {
-          setCelebrationCooldown(prev => {
+          setCelebrationCooldown((prev) => {
            const next = new Set(prev)
            next.delete(racer.id)
            return next
@@ -186,7 +186,15 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
        }, 2000)
      }
    })
-  }, [playerProgress, playerLap, aiRacers, aiLaps, celebrationCooldown, dispatch])
+  }, [
+    playerProgress,
+    playerLap,
+    aiRacers,
+    aiLaps,
+    celebrationCooldown,
+    dispatch, // Play celebration sound (line 12801)
+    playSound,
+  ])

  const playerPos = getCircularPosition(playerProgress)

@@ -201,8 +209,8 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C

    if (isHorizontal) {
      // Horizontal track - curved ends on left/right
-      const leftCenterX = centerX - (straightLength / 2)
-      const rightCenterX = centerX + (straightLength / 2)
+      const leftCenterX = centerX - straightLength / 2
+      const rightCenterX = centerX + straightLength / 2
      const curveTopY = centerY - r
      const curveBottomY = centerY + r

@@ -216,8 +224,8 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
      `
    } else {
      // Vertical track - curved ends on top/bottom
-      const topCenterY = centerY - (straightLength / 2)
-      const bottomCenterY = centerY + (straightLength / 2)
+      const topCenterY = centerY - straightLength / 2
+      const bottomCenterY = centerY + straightLength / 2
      const curveLeftX = centerX - r
      const curveRightX = centerX + r

@@ -233,12 +241,15 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
  }

  return (
-    <div data-component="circular-track" style={{
-      position: 'relative',
-      width: `${dimensions.width}px`,
-      height: `${dimensions.height}px`,
-      margin: '0 auto'
-    }}>
+    <div
+      data-component="circular-track"
+      style={{
+        position: 'relative',
+        width: `${dimensions.width}px`,
+        height: `${dimensions.height}px`,
+        margin: '0 auto',
+      }}
+    >
      {/* SVG Track */}
      <svg
        data-component="track-svg"
@@ -247,38 +258,20 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
        style={{
          position: 'absolute',
          top: 0,
-          left: 0
+          left: 0,
        }}
      >
        {/* Infield grass */}
-        <path
-          d={createRoundedRectPath(15, false)}
-          fill="#7cb342"
-          stroke="none"
-        />
+        <path d={createRoundedRectPath(15, false)} fill="#7cb342" stroke="none" />

        {/* Track background - reddish clay color */}
-        <path
-          d={createRoundedRectPath(-10, true)}
-          fill="#d97757"
-          stroke="none"
-        />
+        <path d={createRoundedRectPath(-10, true)} fill="#d97757" stroke="none" />

        {/* Track outer edge - white boundary */}
-        <path
-          d={createRoundedRectPath(-15, true)}
-          fill="none"
-          stroke="white"
-          strokeWidth="3"
-        />
+        <path d={createRoundedRectPath(-15, true)} fill="none" stroke="white" strokeWidth="3" />

        {/* Track inner edge - white boundary */}
-        <path
-          d={createRoundedRectPath(15, false)}
-          fill="none"
-          stroke="white"
-          strokeWidth="3"
-        />
+        <path d={createRoundedRectPath(15, false)} fill="none" stroke="white" strokeWidth="3" />

        {/* Lane markers - dashed white lines */}
        {[-5, 0, 5].map((offset) => (
@@ -308,11 +301,11 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
            return (
              <g>
                {/* Checkered pattern - vertical line */}
-                {[0, 1, 2, 3, 4, 5].map(i => (
+                {[0, 1, 2, 3, 4, 5].map((i) => (
                  <rect
                    key={i}
                    x={x - lineWidth / 2}
-                    y={yStart + (squareSize * i)}
+                    y={yStart + squareSize * i}
                    width={lineWidth}
                    height={squareSize}
                    fill={i % 2 === 0 ? 'black' : 'white'}
@@ -329,10 +322,10 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
            return (
              <g>
                {/* Checkered pattern - horizontal line */}
-                {[0, 1, 2, 3, 4, 5].map(i => (
+                {[0, 1, 2, 3, 4, 5].map((i) => (
                  <rect
                    key={i}
-                    x={xStart + (squareSize * i)}
+                    x={xStart + squareSize * i}
                    y={y - lineWidth / 2}
                    width={squareSize}
                    height={lineWidth}
@@ -345,14 +338,14 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
        })()}

        {/* Distance markers (quarter points) */}
-        {[0.25, 0.5, 0.75].map(fraction => {
+        {[0.25, 0.5, 0.75].map((fraction) => {
          const pos = getCircularPosition(fraction * 50)
          const markerLength = 12
          const perpAngle = (pos.angle + 90) * (Math.PI / 180)
-          const x1 = pos.x - (markerLength * Math.cos(perpAngle))
-          const y1 = pos.y - (markerLength * Math.sin(perpAngle))
-          const x2 = pos.x + (markerLength * Math.cos(perpAngle))
-          const y2 = pos.y + (markerLength * Math.sin(perpAngle))
+          const x1 = pos.x - markerLength * Math.cos(perpAngle)
+          const y1 = pos.y - markerLength * Math.sin(perpAngle)
+          const x2 = pos.x + markerLength * Math.cos(perpAngle)
+          const y2 = pos.y + markerLength * Math.sin(perpAngle)
          return (
            <line
              key={fraction}
@@ -369,21 +362,23 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
      </svg>

      {/* Player racer */}
-      <div style={{
-        position: 'absolute',
-        left: `${playerPos.x}px`,
-        top: `${playerPos.y}px`,
-        transform: `translate(-50%, -50%) rotate(${playerPos.angle}deg)`,
-        fontSize: '32px',
-        filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.2))',
-        zIndex: 10,
-        transition: 'left 0.3s ease-out, top 0.3s ease-out'
-      }}>
+      <div
+        style={{
+          position: 'absolute',
+          left: `${playerPos.x}px`,
+          top: `${playerPos.y}px`,
+          transform: `translate(-50%, -50%) rotate(${playerPos.angle}deg)`,
+          fontSize: '32px',
+          filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.2))',
+          zIndex: 10,
+          transition: 'left 0.3s ease-out, top 0.3s ease-out',
+        }}
+      >
        {playerEmoji}
      </div>

      {/* AI racers */}
-      {aiRacers.map((racer, index) => {
+      {aiRacers.map((racer, _index) => {
        const aiPos = getCircularPosition(racer.position)
        const activeBubble = state.activeSpeechBubbles.get(racer.id)

@@ -398,14 +393,16 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
              fontSize: '28px',
              filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.2))',
              zIndex: 5,
-              transition: 'left 0.2s linear, top 0.2s linear'
+              transition: 'left 0.2s linear, top 0.2s linear',
            }}
          >
            {racer.icon}
            {activeBubble && (
-              <div style={{
-                transform: `rotate(${-aiPos.angle}deg)` // Counter-rotate bubble
-              }}>
+              <div
+                style={{
+                  transform: `rotate(${-aiPos.angle}deg)`, // Counter-rotate bubble
+                }}
+              >
                <SpeechBubble
                  message={activeBubble}
                  onHide={() => dispatch({ type: 'CLEAR_AI_COMMENT', racerId: racer.id })}
@@ -417,66 +414,76 @@ export function CircularTrack({ playerProgress, playerLap, aiRacers, aiLaps }: C
      })}

      {/* Lap counter */}
-      <div style={{
-        position: 'absolute',
-        top: '50%',
-        left: '50%',
-        transform: 'translate(-50%, -50%)',
-        background: 'rgba(255, 255, 255, 0.95)',
-        borderRadius: '50%',
-        width: '120px',
-        height: '120px',
-        display: 'flex',
-        flexDirection: 'column',
-        alignItems: 'center',
-        justifyContent: 'center',
-        boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
-        border: '3px solid #3b82f6'
-      }}>
-        <div style={{
-          fontSize: '14px',
-          color: '#6b7280',
-          marginBottom: '4px',
-          fontWeight: 'bold'
-        }}>
+      <div
+        style={{
+          position: 'absolute',
+          top: '50%',
+          left: '50%',
+          transform: 'translate(-50%, -50%)',
+          background: 'rgba(255, 255, 255, 0.95)',
+          borderRadius: '50%',
+          width: '120px',
+          height: '120px',
+          display: 'flex',
+          flexDirection: 'column',
+          alignItems: 'center',
+          justifyContent: 'center',
+          boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
+          border: '3px solid #3b82f6',
+        }}
+      >
+        <div
+          style={{
+            fontSize: '14px',
+            color: '#6b7280',
+            marginBottom: '4px',
+            fontWeight: 'bold',
+          }}
+        >
          Lap
        </div>
-        <div style={{
-          fontSize: '36px',
-          fontWeight: 'bold',
-          color: '#3b82f6'
-        }}>
+        <div
+          style={{
+            fontSize: '36px',
+            fontWeight: 'bold',
+            color: '#3b82f6',
+          }}
+        >
          {playerLap + 1}
        </div>
-        <div style={{
-          fontSize: '12px',
-          color: '#9ca3af',
-          marginTop: '4px'
-        }}>
-          {Math.floor((playerProgress % 50) / 50 * 100)}%
+        <div
+          style={{
+            fontSize: '12px',
+            color: '#9ca3af',
+            marginTop: '4px',
+          }}
+        >
+          {Math.floor(((playerProgress % 50) / 50) * 100)}%
        </div>
      </div>

      {/* Lap celebration */}
      {celebrationCooldown.has('player') && (
-        <div style={{
-          position: 'absolute',
-          top: '20px',
-          left: '50%',
-          transform: 'translateX(-50%)',
-          background: 'linear-gradient(135deg, #fbbf24, #f59e0b)',
-          color: 'white',
-          padding: '12px 24px',
-          borderRadius: '12px',
-          fontSize: '18px',
-          fontWeight: 'bold',
-          boxShadow: '0 4px 20px rgba(251, 191, 36, 0.4)',
-          animation: 'bounce 0.5s ease',
-          zIndex: 100
-        }}>
+        <div
+          style={{
+            position: 'absolute',
+            top: '20px',
+            left: '50%',
+            transform: 'translateX(-50%)',
+            background: 'linear-gradient(135deg, #fbbf24, #f59e0b)',
+            color: 'white',
+            padding: '12px 24px',
+            borderRadius: '12px',
+            fontSize: '18px',
+            fontWeight: 'bold',
+            boxShadow: '0 4px 20px rgba(251, 191, 36, 0.4)',
+            animation: 'bounce 0.5s ease',
+            zIndex: 100,
+          }}
+        >
          🎉 Lap {playerLap + 1} Complete! 🎉
        </div>
      )}
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/GameHUD.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/GameHUD.tsx
@@ -1,10 +1,10 @@
 'use client'

 import { memo } from 'react'
-import type { Station, Passenger, ComplementQuestion } from '../../lib/gameTypes'
+import type { ComplementQuestion, Passenger, Station } from '../../lib/gameTypes'
+import { AbacusTarget } from '../AbacusTarget'
 import { PassengerCard } from '../PassengerCard'
 import { PressureGauge } from '../PressureGauge'
-import { AbacusTarget } from '../AbacusTarget'

 interface RouteTheme {
  emoji: string
@@ -23,173 +23,201 @@ interface GameHUDProps {
  currentInput: string
 }

-export const GameHUD = memo(({
-  routeTheme,
-  currentRoute,
-  periodName,
-  timeRemaining,
-  pressure,
-  nonDeliveredPassengers,
-  stations,
-  currentQuestion,
-  currentInput
-}: GameHUDProps) => {
-  return (
-    <>
-      {/* Route and time of day indicator */}
-      <div data-component="route-info" style={{
-        position: 'absolute',
-        top: '10px',
-        left: '10px',
-        display: 'flex',
-        flexDirection: 'column',
-        gap: '8px',
-        zIndex: 10
-      }}>
-        {/* Current Route */}
-        <div style={{
-          background: 'rgba(0, 0, 0, 0.3)',
-          color: 'white',
-          padding: '8px 14px',
-          borderRadius: '8px',
-          fontSize: '16px',
-          fontWeight: 'bold',
-          backdropFilter: 'blur(4px)',
-          display: 'flex',
-          alignItems: 'center',
-          gap: '8px'
-        }}>
-          <span style={{ fontSize: '20px' }}>{routeTheme.emoji}</span>
-          <div>
-            <div style={{ fontSize: '14px', opacity: 0.8 }}>Route {currentRoute}</div>
-            <div style={{ fontSize: '12px', opacity: 0.9 }}>{routeTheme.name}</div>
+export const GameHUD = memo(
+  ({
+    routeTheme,
+    currentRoute,
+    periodName,
+    timeRemaining,
+    pressure,
+    nonDeliveredPassengers,
+    stations,
+    currentQuestion,
+    currentInput,
+  }: GameHUDProps) => {
+    return (
+      <>
+        {/* Route and time of day indicator */}
+        <div
+          data-component="route-info"
+          style={{
+            position: 'absolute',
+            top: '10px',
+            left: '10px',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: '8px',
+            zIndex: 10,
+          }}
+        >
+          {/* Current Route */}
+          <div
+            style={{
+              background: 'rgba(0, 0, 0, 0.3)',
+              color: 'white',
+              padding: '8px 14px',
+              borderRadius: '8px',
+              fontSize: '16px',
+              fontWeight: 'bold',
+              backdropFilter: 'blur(4px)',
+              display: 'flex',
+              alignItems: 'center',
+              gap: '8px',
+            }}
+          >
+            <span style={{ fontSize: '20px' }}>{routeTheme.emoji}</span>
+            <div>
+              <div style={{ fontSize: '14px', opacity: 0.8 }}>Route {currentRoute}</div>
+              <div style={{ fontSize: '12px', opacity: 0.9 }}>{routeTheme.name}</div>
+            </div>
+          </div>
+
+          {/* Time of Day */}
+          <div
+            style={{
+              background: 'rgba(0, 0, 0, 0.3)',
+              color: 'white',
+              padding: '6px 12px',
+              borderRadius: '8px',
+              fontSize: '14px',
+              fontWeight: 'bold',
+              backdropFilter: 'blur(4px)',
+            }}
+          >
+            {periodName}
          </div>
        </div>

-        {/* Time of Day */}
-        <div style={{
-          background: 'rgba(0, 0, 0, 0.3)',
-          color: 'white',
-          padding: '6px 12px',
-          borderRadius: '8px',
-          fontSize: '14px',
-          fontWeight: 'bold',
-          backdropFilter: 'blur(4px)'
-        }}>
-          {periodName}
-        </div>
-      </div>
-
-      {/* Time remaining */}
-      <div data-component="time-remaining" style={{
-        position: 'absolute',
-        top: '10px',
-        right: '10px',
-        background: 'rgba(0, 0, 0, 0.3)',
-        color: 'white',
-        padding: '6px 12px',
-        borderRadius: '8px',
-        fontSize: '18px',
-        fontWeight: 'bold',
-        backdropFilter: 'blur(4px)',
-        zIndex: 10
-      }}>
-        ⏱️ {timeRemaining}s
-      </div>
-
-      {/* Pressure gauge */}
-      <div data-component="pressure-gauge-container" style={{
-        position: 'fixed',
-        bottom: '20px',
-        left: '20px',
-        zIndex: 1000,
-        width: '120px'
-      }}>
-        <PressureGauge pressure={pressure} />
-      </div>
-
-      {/* Passenger cards - show all non-delivered passengers */}
-      {nonDeliveredPassengers.length > 0 && (
-        <div data-component="passenger-list" style={{
-          position: 'fixed',
-          bottom: '20px',
-          right: '20px',
-          display: 'flex',
-          flexDirection: 'column-reverse',
-          gap: '8px',
-          zIndex: 1000,
-          maxHeight: 'calc(100vh - 40px)',
-          overflowY: 'auto'
-        }}>
-          {nonDeliveredPassengers.map(passenger => (
-            <PassengerCard
-              key={passenger.id}
-              passenger={passenger}
-              originStation={stations.find(s => s.id === passenger.originStationId)}
-              destinationStation={stations.find(s => s.id === passenger.destinationStationId)}
-            />
-          ))}
-        </div>
-      )}
-
-      {/* Question Display - centered at bottom, equation-focused */}
-      {currentQuestion && (
-        <div data-component="sprint-question-display" style={{
-          position: 'fixed',
-          bottom: '20px',
-          left: '50%',
-          transform: 'translateX(-50%)',
-          background: 'rgba(255, 255, 255, 0.98)',
-          borderRadius: '24px',
-          padding: '28px 50px',
-          boxShadow: '0 16px 40px rgba(0, 0, 0, 0.5), 0 0 0 5px rgba(59, 130, 246, 0.4)',
-          backdropFilter: 'blur(12px)',
-          border: '4px solid rgba(255, 255, 255, 0.95)',
-          zIndex: 1000
-        }}>
-          {/* Complement equation as main focus */}
-          <div data-element="sprint-question-equation" style={{
-            fontSize: '96px',
+        {/* Time remaining */}
+        <div
+          data-component="time-remaining"
+          style={{
+            position: 'absolute',
+            top: '10px',
+            right: '10px',
+            background: 'rgba(0, 0, 0, 0.3)',
+            color: 'white',
+            padding: '6px 12px',
+            borderRadius: '8px',
+            fontSize: '18px',
            fontWeight: 'bold',
-            color: '#1f2937',
-            lineHeight: '1.1',
-            display: 'flex',
-            alignItems: 'center',
-            gap: '20px',
-            justifyContent: 'center'
-          }}>
-            <span style={{
-              background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
-              color: 'white',
-              padding: '12px 32px',
-              borderRadius: '16px',
-              minWidth: '140px',
-              display: 'inline-block',
-              textShadow: '0 3px 10px rgba(0, 0, 0, 0.3)'
-            }}>
-              {currentInput || '?'}
-            </span>
-            <span style={{ color: '#6b7280' }}>+</span>
-            {currentQuestion.showAsAbacus ? (
-              <div style={{
-                transform: 'scale(2.4) translateY(8%)',
-                transformOrigin: 'center center',
+            backdropFilter: 'blur(4px)',
+            zIndex: 10,
+          }}
+        >
+          ⏱️ {timeRemaining}s
+        </div>
+
+        {/* Pressure gauge */}
+        <div
+          data-component="pressure-gauge-container"
+          style={{
+            position: 'fixed',
+            bottom: '20px',
+            left: '20px',
+            zIndex: 1000,
+            width: '120px',
+          }}
+        >
+          <PressureGauge pressure={pressure} />
+        </div>
+
+        {/* Passenger cards - show all non-delivered passengers */}
+        {nonDeliveredPassengers.length > 0 && (
+          <div
+            data-component="passenger-list"
+            style={{
+              position: 'fixed',
+              bottom: '20px',
+              right: '20px',
+              display: 'flex',
+              flexDirection: 'column-reverse',
+              gap: '8px',
+              zIndex: 1000,
+              maxHeight: 'calc(100vh - 40px)',
+              overflowY: 'auto',
+            }}
+          >
+            {nonDeliveredPassengers.map((passenger) => (
+              <PassengerCard
+                key={passenger.id}
+                passenger={passenger}
+                originStation={stations.find((s) => s.id === passenger.originStationId)}
+                destinationStation={stations.find((s) => s.id === passenger.destinationStationId)}
+              />
+            ))}
+          </div>
+        )}
+
+        {/* Question Display - centered at bottom, equation-focused */}
+        {currentQuestion && (
+          <div
+            data-component="sprint-question-display"
+            style={{
+              position: 'fixed',
+              bottom: '20px',
+              left: '50%',
+              transform: 'translateX(-50%)',
+              background: 'rgba(255, 255, 255, 0.98)',
+              borderRadius: '24px',
+              padding: '28px 50px',
+              boxShadow: '0 16px 40px rgba(0, 0, 0, 0.5), 0 0 0 5px rgba(59, 130, 246, 0.4)',
+              backdropFilter: 'blur(12px)',
+              border: '4px solid rgba(255, 255, 255, 0.95)',
+              zIndex: 1000,
+            }}
+          >
+            {/* Complement equation as main focus */}
+            <div
+              data-element="sprint-question-equation"
+              style={{
+                fontSize: '96px',
+                fontWeight: 'bold',
+                color: '#1f2937',
+                lineHeight: '1.1',
                display: 'flex',
                alignItems: 'center',
-                justifyContent: 'center'
-              }}>
-                <AbacusTarget number={currentQuestion.number} />
-              </div>
-            ) : (
-              <span>{currentQuestion.number}</span>
-            )}
-            <span style={{ color: '#6b7280' }}>=</span>
-            <span style={{ color: '#10b981' }}>{currentQuestion.targetSum}</span>
+                gap: '20px',
+                justifyContent: 'center',
+              }}
+            >
+              <span
+                style={{
+                  background: 'linear-gradient(135deg, #3b82f6, #8b5cf6)',
+                  color: 'white',
+                  padding: '12px 32px',
+                  borderRadius: '16px',
+                  minWidth: '140px',
+                  display: 'inline-block',
+                  textShadow: '0 3px 10px rgba(0, 0, 0, 0.3)',
+                }}
+              >
+                {currentInput || '?'}
+              </span>
+              <span style={{ color: '#6b7280' }}>+</span>
+              {currentQuestion.showAsAbacus ? (
+                <div
+                  style={{
+                    transform: 'scale(2.4) translateY(8%)',
+                    transformOrigin: 'center center',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                  }}
+                >
+                  <AbacusTarget number={currentQuestion.number} />
+                </div>
+              ) : (
+                <span>{currentQuestion.number}</span>
+              )}
+              <span style={{ color: '#6b7280' }}>=</span>
+              <span style={{ color: '#10b981' }}>{currentQuestion.targetSum}</span>
+            </div>
          </div>
-        </div>
-      )}
-    </>
-  )
-})
+        )}
+      </>
+    )
+  }
+)

 GameHUD.displayName = 'GameHUD'
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/LinearTrack.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/LinearTrack.tsx
@@ -1,10 +1,10 @@
 'use client'

-import type { AIRacer } from '../../lib/gameTypes'
-import { SpeechBubble } from '../AISystem/SpeechBubble'
-import { useComplementRace } from '../../context/ComplementRaceContext'
 import { useGameMode } from '@/contexts/GameModeContext'
 import { useUserProfile } from '@/contexts/UserProfileContext'
+import { useComplementRace } from '../../context/ComplementRaceContext'
+import type { AIRacer } from '../../lib/gameTypes'
+import { SpeechBubble } from '../AISystem/SpeechBubble'

 interface LinearTrackProps {
  playerProgress: number
@@ -13,13 +13,18 @@ interface LinearTrackProps {
  showFinishLine?: boolean
 }

-export function LinearTrack({ playerProgress, aiRacers, raceGoal, showFinishLine = true }: LinearTrackProps) {
+export function LinearTrack({
+  playerProgress,
+  aiRacers,
+  raceGoal,
+  showFinishLine = true,
+}: LinearTrackProps) {
  const { state, dispatch } = useComplementRace()
  const { players } = useGameMode()
-  const { profile } = useUserProfile()
+  const { profile: _profile } = useUserProfile()

  // Get the first active player's emoji
-  const activePlayers = Array.from(players.values()).filter(p => p.id)
+  const activePlayers = Array.from(players.values()).filter((p) => p.id)
  const firstActivePlayer = activePlayers[0]
  const playerEmoji = firstActivePlayer?.emoji ?? '👤'

@@ -32,71 +37,86 @@ export function LinearTrack({ playerProgress, aiRacers, raceGoal, showFinishLine
  const playerPosition = getPosition(playerProgress)

  return (
-    <div data-component="linear-track" style={{
-      position: 'relative',
-      width: '100%',
-      height: '200px',
-      background: 'linear-gradient(to bottom, #87ceeb 0%, #e0f2fe 50%, #90ee90 50%, #d4f1d4 100%)',
-      borderRadius: '12px',
-      overflow: 'hidden',
-      boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
-      marginTop: '20px'
-    }}>
+    <div
+      data-component="linear-track"
+      style={{
+        position: 'relative',
+        width: '100%',
+        height: '200px',
+        background:
+          'linear-gradient(to bottom, #87ceeb 0%, #e0f2fe 50%, #90ee90 50%, #d4f1d4 100%)',
+        borderRadius: '12px',
+        overflow: 'hidden',
+        boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
+        marginTop: '20px',
+      }}
+    >
      {/* Track lines */}
-      <div style={{
-        position: 'absolute',
-        top: '50%',
-        left: 0,
-        right: 0,
-        height: '2px',
-        background: 'rgba(0, 0, 0, 0.1)',
-        transform: 'translateY(-50%)'
-      }} />
+      <div
+        style={{
+          position: 'absolute',
+          top: '50%',
+          left: 0,
+          right: 0,
+          height: '2px',
+          background: 'rgba(0, 0, 0, 0.1)',
+          transform: 'translateY(-50%)',
+        }}
+      />

-      <div style={{
-        position: 'absolute',
-        top: '40%',
-        left: 0,
-        right: 0,
-        height: '1px',
-        background: 'rgba(0, 0, 0, 0.05)',
-        transform: 'translateY(-50%)'
-      }} />
+      <div
+        style={{
+          position: 'absolute',
+          top: '40%',
+          left: 0,
+          right: 0,
+          height: '1px',
+          background: 'rgba(0, 0, 0, 0.05)',
+          transform: 'translateY(-50%)',
+        }}
+      />

-      <div style={{
-        position: 'absolute',
-        top: '60%',
-        left: 0,
-        right: 0,
-        height: '1px',
-        background: 'rgba(0, 0, 0, 0.05)',
-        transform: 'translateY(-50%)'
-      }} />
+      <div
+        style={{
+          position: 'absolute',
+          top: '60%',
+          left: 0,
+          right: 0,
+          height: '1px',
+          background: 'rgba(0, 0, 0, 0.05)',
+          transform: 'translateY(-50%)',
+        }}
+      />

      {/* Finish line */}
      {showFinishLine && (
-        <div style={{
-          position: 'absolute',
-          right: '2%',
-          top: 0,
-          bottom: 0,
-          width: '4px',
-          background: 'repeating-linear-gradient(0deg, black 0px, black 10px, white 10px, white 20px)',
-          boxShadow: '0 0 10px rgba(0, 0, 0, 0.3)'
-        }} />
+        <div
+          style={{
+            position: 'absolute',
+            right: '2%',
+            top: 0,
+            bottom: 0,
+            width: '4px',
+            background:
+              'repeating-linear-gradient(0deg, black 0px, black 10px, white 10px, white 20px)',
+            boxShadow: '0 0 10px rgba(0, 0, 0, 0.3)',
+          }}
+        />
      )}

      {/* Player racer */}
-      <div style={{
-        position: 'absolute',
-        left: `${playerPosition}%`,
-        top: '50%',
-        transform: 'translate(-50%, -50%)',
-        fontSize: '32px',
-        transition: 'left 0.3s ease-out',
-        filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.2))',
-        zIndex: 10
-      }}>
+      <div
+        style={{
+          position: 'absolute',
+          left: `${playerPosition}%`,
+          top: '50%',
+          transform: 'translate(-50%, -50%)',
+          fontSize: '32px',
+          transition: 'left 0.3s ease-out',
+          filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.2))',
+          zIndex: 10,
+        }}
+      >
        {playerEmoji}
      </div>

@@ -111,12 +131,12 @@ export function LinearTrack({ playerProgress, aiRacers, raceGoal, showFinishLine
            style={{
              position: 'absolute',
              left: `${aiPosition}%`,
-              top: `${35 + (index * 15)}%`,
+              top: `${35 + index * 15}%`,
              transform: 'translate(-50%, -50%)',
              fontSize: '28px',
              transition: 'left 0.2s linear',
              filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.2))',
-              zIndex: 5
+              zIndex: 5,
            }}
          >
            {racer.icon}
@@ -131,20 +151,22 @@ export function LinearTrack({ playerProgress, aiRacers, raceGoal, showFinishLine
      })}

      {/* Progress indicator */}
-      <div style={{
-        position: 'absolute',
-        bottom: '10px',
-        left: '10px',
-        background: 'rgba(255, 255, 255, 0.9)',
-        padding: '6px 12px',
-        borderRadius: '8px',
-        fontSize: '14px',
-        fontWeight: 'bold',
-        color: '#1f2937',
-        boxShadow: '0 2px 6px rgba(0, 0, 0, 0.1)'
-      }}>
+      <div
+        style={{
+          position: 'absolute',
+          bottom: '10px',
+          left: '10px',
+          background: 'rgba(255, 255, 255, 0.9)',
+          padding: '6px 12px',
+          borderRadius: '8px',
+          fontSize: '14px',
+          fontWeight: 'bold',
+          color: '#1f2937',
+          boxShadow: '0 2px 6px rgba(0, 0, 0, 0.1)',
+        }}
+      >
        {playerProgress} / {raceGoal}
      </div>
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/RailroadTrackPath.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/RailroadTrackPath.tsx
@@ -1,7 +1,7 @@
 'use client'

 import { memo } from 'react'
-import type { Station, Passenger } from '../../lib/gameTypes'
+import type { Passenger, Station } from '../../lib/gameTypes'
 import type { Landmark } from '../../lib/landmarks'

 interface RailroadTrackPathProps {
@@ -21,179 +21,184 @@ interface RailroadTrackPathProps {
  disembarkingAnimations: Map<string, unknown>
 }

-export const RailroadTrackPath = memo(({
-  tiesAndRails,
-  referencePath,
-  pathRef,
-  landmarkPositions,
-  landmarks,
-  stationPositions,
-  stations,
-  passengers,
-  boardingAnimations,
-  disembarkingAnimations
-}: RailroadTrackPathProps) => {
-  return (
-    <>
-      {/* Railroad ties */}
-      {tiesAndRails?.ties.map((tie, index) => (
-        <line
-          key={`tie-${index}`}
-          x1={tie.x1}
-          y1={tie.y1}
-          x2={tie.x2}
-          y2={tie.y2}
-          stroke="#654321"
-          strokeWidth="5"
-          strokeLinecap="round"
-          opacity="0.8"
-        />
-      ))}
+export const RailroadTrackPath = memo(
+  ({
+    tiesAndRails,
+    referencePath,
+    pathRef,
+    landmarkPositions,
+    landmarks,
+    stationPositions,
+    stations,
+    passengers,
+    boardingAnimations,
+    disembarkingAnimations,
+  }: RailroadTrackPathProps) => {
+    return (
+      <>
+        {/* Railroad ties */}
+        {tiesAndRails?.ties.map((tie, index) => (
+          <line
+            key={`tie-${index}`}
+            x1={tie.x1}
+            y1={tie.y1}
+            x2={tie.x2}
+            y2={tie.y2}
+            stroke="#654321"
+            strokeWidth="5"
+            strokeLinecap="round"
+            opacity="0.8"
+          />
+        ))}

-      {/* Left rail */}
-      {tiesAndRails && tiesAndRails.leftRailPath && (
-        <path
-          d={tiesAndRails.leftRailPath}
-          fill="none"
-          stroke="#C0C0C0"
-          strokeWidth="5"
-          strokeLinecap="round"
-          strokeLinejoin="round"
-        />
-      )}
+        {/* Left rail */}
+        {tiesAndRails?.leftRailPath && (
+          <path
+            d={tiesAndRails.leftRailPath}
+            fill="none"
+            stroke="#C0C0C0"
+            strokeWidth="5"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+        )}

-      {/* Right rail */}
-      {tiesAndRails && tiesAndRails.rightRailPath && (
-        <path
-          d={tiesAndRails.rightRailPath}
-          fill="none"
-          stroke="#C0C0C0"
-          strokeWidth="5"
-          strokeLinecap="round"
-          strokeLinejoin="round"
-        />
-      )}
+        {/* Right rail */}
+        {tiesAndRails?.rightRailPath && (
+          <path
+            d={tiesAndRails.rightRailPath}
+            fill="none"
+            stroke="#C0C0C0"
+            strokeWidth="5"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+        )}

-      {/* Reference path (invisible, used for positioning) */}
-      <path
-        ref={pathRef}
-        d={referencePath}
-        fill="none"
-        stroke="transparent"
-        strokeWidth="2"
-      />
+        {/* Reference path (invisible, used for positioning) */}
+        <path ref={pathRef} d={referencePath} fill="none" stroke="transparent" strokeWidth="2" />

-      {/* Landmarks - background scenery */}
-      {landmarkPositions.map((pos, index) => (
-        <text
-          key={`landmark-${index}`}
-          x={pos.x}
-          y={pos.y}
-          textAnchor="middle"
-          style={{
-            fontSize: `${(landmarks[index]?.size || 24) * 2.0}px`,
-            pointerEvents: 'none',
-            opacity: 0.7,
-            filter: 'drop-shadow(0 2px 3px rgba(0, 0, 0, 0.2))'
-          }}
-        >
-          {landmarks[index]?.emoji}
-        </text>
-      ))}
+        {/* Landmarks - background scenery */}
+        {landmarkPositions.map((pos, index) => (
+          <text
+            key={`landmark-${index}`}
+            x={pos.x}
+            y={pos.y}
+            textAnchor="middle"
+            style={{
+              fontSize: `${(landmarks[index]?.size || 24) * 2.0}px`,
+              pointerEvents: 'none',
+              opacity: 0.7,
+              filter: 'drop-shadow(0 2px 3px rgba(0, 0, 0, 0.2))',
+            }}
+          >
+            {landmarks[index]?.emoji}
+          </text>
+        ))}

-      {/* Station markers */}
-      {stationPositions.map((pos, index) => {
-        const station = stations[index]
-        // Find passengers waiting at this station (exclude currently boarding)
-        const waitingPassengers = passengers.filter(p =>
-          p.originStationId === station?.id && !p.isBoarded && !p.isDelivered && !boardingAnimations.has(p.id)
-        )
-        // Find passengers delivered at this station (exclude currently disembarking)
-        const deliveredPassengers = passengers.filter(p =>
-          p.destinationStationId === station?.id && p.isDelivered && !disembarkingAnimations.has(p.id)
-        )
+        {/* Station markers */}
+        {stationPositions.map((pos, index) => {
+          const station = stations[index]
+          // Find passengers waiting at this station (exclude currently boarding)
+          const waitingPassengers = passengers.filter(
+            (p) =>
+              p.originStationId === station?.id &&
+              !p.isBoarded &&
+              !p.isDelivered &&
+              !boardingAnimations.has(p.id)
+          )
+          // Find passengers delivered at this station (exclude currently disembarking)
+          const deliveredPassengers = passengers.filter(
+            (p) =>
+              p.destinationStationId === station?.id &&
+              p.isDelivered &&
+              !disembarkingAnimations.has(p.id)
+          )

-        return (
-          <g key={`station-${index}`}>
-            {/* Station platform */}
-            <circle
-              cx={pos.x}
-              cy={pos.y}
-              r="18"
-              fill="#8B4513"
-              stroke="#654321"
-              strokeWidth="4"
-            />
-            {/* Station icon */}
-            <text
-              x={pos.x}
-              y={pos.y - 40}
-              textAnchor="middle"
-              fontSize="48"
-              style={{ pointerEvents: 'none' }}
-            >
-              {station?.icon}
-            </text>
-            {/* Station name */}
-            <text
-              x={pos.x}
-              y={pos.y + 50}
-              textAnchor="middle"
-              fontSize="20"
-              fill="#1f2937"
-              stroke="#f59e0b"
-              strokeWidth="0.5"
-              style={{
-                fontWeight: 900,
-                pointerEvents: 'none',
-                fontFamily: '"Comic Sans MS", "Chalkboard SE", "Bradley Hand", cursive',
-                textShadow: '0 2px 4px rgba(0, 0, 0, 0.2)',
-                letterSpacing: '0.5px',
-                paintOrder: 'stroke fill'
-              }}
-            >
-              {station?.name}
-            </text>
-
-            {/* Waiting passengers at this station */}
-            {waitingPassengers.map((passenger, pIndex) => (
+          return (
+            <g key={`station-${index}`}>
+              {/* Station platform */}
+              <circle
+                cx={pos.x}
+                cy={pos.y}
+                r="18"
+                fill="#8B4513"
+                stroke="#654321"
+                strokeWidth="4"
+              />
+              {/* Station icon */}
              <text
-                key={`waiting-${passenger.id}`}
-                x={pos.x + (pIndex - waitingPassengers.length / 2 + 0.5) * 28}
-                y={pos.y - 30}
+                x={pos.x}
+                y={pos.y - 40}
                textAnchor="middle"
+                fontSize="48"
+                style={{ pointerEvents: 'none' }}
+              >
+                {station?.icon}
+              </text>
+              {/* Station name */}
+              <text
+                x={pos.x}
+                y={pos.y + 50}
+                textAnchor="middle"
+                fontSize="20"
+                fill="#1f2937"
+                stroke="#f59e0b"
+                strokeWidth="0.5"
                style={{
-                  fontSize: '55px',
+                  fontWeight: 900,
                  pointerEvents: 'none',
-                  filter: passenger.isUrgent ? 'drop-shadow(0 0 8px rgba(245, 158, 11, 0.8))' : 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))'
+                  fontFamily: '"Comic Sans MS", "Chalkboard SE", "Bradley Hand", cursive',
+                  textShadow: '0 2px 4px rgba(0, 0, 0, 0.2)',
+                  letterSpacing: '0.5px',
+                  paintOrder: 'stroke fill',
                }}
              >
-                {passenger.avatar}
+                {station?.name}
              </text>
-            ))}

-            {/* Delivered passengers at this station (celebrating) */}
-            {deliveredPassengers.map((passenger, pIndex) => (
-              <text
-                key={`delivered-${passenger.id}`}
-                x={pos.x + (pIndex - deliveredPassengers.length / 2 + 0.5) * 28}
-                y={pos.y - 30}
-                textAnchor="middle"
-                style={{
-                  fontSize: '55px',
-                  pointerEvents: 'none',
-                  filter: 'drop-shadow(0 0 12px rgba(16, 185, 129, 0.8))',
-                  animation: 'celebrateDelivery 2s ease-out forwards'
-                }}
-              >
-                {passenger.avatar}
-              </text>
-            ))}
-          </g>
-        )
-      })}
-    </>
-  )
-})
+              {/* Waiting passengers at this station */}
+              {waitingPassengers.map((passenger, pIndex) => (
+                <text
+                  key={`waiting-${passenger.id}`}
+                  x={pos.x + (pIndex - waitingPassengers.length / 2 + 0.5) * 28}
+                  y={pos.y - 30}
+                  textAnchor="middle"
+                  style={{
+                    fontSize: '55px',
+                    pointerEvents: 'none',
+                    filter: passenger.isUrgent
+                      ? 'drop-shadow(0 0 8px rgba(245, 158, 11, 0.8))'
+                      : 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
+                  }}
+                >
+                  {passenger.avatar}
+                </text>
+              ))}
+
+              {/* Delivered passengers at this station (celebrating) */}
+              {deliveredPassengers.map((passenger, pIndex) => (
+                <text
+                  key={`delivered-${passenger.id}`}
+                  x={pos.x + (pIndex - deliveredPassengers.length / 2 + 0.5) * 28}
+                  y={pos.y - 30}
+                  textAnchor="middle"
+                  style={{
+                    fontSize: '55px',
+                    pointerEvents: 'none',
+                    filter: 'drop-shadow(0 0 12px rgba(16, 185, 129, 0.8))',
+                    animation: 'celebrateDelivery 2s ease-out forwards',
+                  }}
+                >
+                  {passenger.avatar}
+                </text>
+              ))}
+            </g>
+          )
+        })}
+      </>
+    )
+  }
+)

 RailroadTrackPath.displayName = 'RailroadTrackPath'
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/SteamTrainJourney.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/SteamTrainJourney.tsx
@@ -1,27 +1,32 @@
 'use client'

-import { useRef, useState, useMemo, memo } from 'react'
-import { useSpring, animated } from '@react-spring/web'
-import { useSteamJourney } from '../../hooks/useSteamJourney'
-import { usePassengerAnimations, type BoardingAnimation, type DisembarkingAnimation } from '../../hooks/usePassengerAnimations'
-import { useTrainTransforms } from '../../hooks/useTrainTransforms'
-import { useTrackManagement } from '../../hooks/useTrackManagement'
-import { useComplementRace } from '../../context/ComplementRaceContext'
-import { RailroadTrackGenerator } from '../../lib/RailroadTrackGenerator'
-import { getRouteTheme } from '../../lib/routeThemes'
-import { calculateMaxConcurrentPassengers } from '../../lib/passengerGenerator'
+import { animated, useSpring } from '@react-spring/web'
+import { memo, useMemo, useRef, useState } from 'react'
 import { useGameMode } from '@/contexts/GameModeContext'
 import { useUserProfile } from '@/contexts/UserProfileContext'
-import { TrainTerrainBackground } from './TrainTerrainBackground'
+import { useComplementRace } from '../../context/ComplementRaceContext'
+import {
+  type BoardingAnimation,
+  type DisembarkingAnimation,
+  usePassengerAnimations,
+} from '../../hooks/usePassengerAnimations'
+import type { ComplementQuestion } from '../../lib/gameTypes'
+import { useSteamJourney } from '../../hooks/useSteamJourney'
+import { useTrackManagement } from '../../hooks/useTrackManagement'
+import { useTrainTransforms } from '../../hooks/useTrainTransforms'
+import { calculateMaxConcurrentPassengers } from '../../lib/passengerGenerator'
+import { RailroadTrackGenerator } from '../../lib/RailroadTrackGenerator'
+import { getRouteTheme } from '../../lib/routeThemes'
+import { GameHUD } from './GameHUD'
 import { RailroadTrackPath } from './RailroadTrackPath'
 import { TrainAndCars } from './TrainAndCars'
-import { GameHUD } from './GameHUD'
+import { TrainTerrainBackground } from './TrainTerrainBackground'

 const BoardingPassengerAnimation = memo(({ animation }: { animation: BoardingAnimation }) => {
  const spring = useSpring({
    from: { x: animation.fromX, y: animation.fromY, opacity: 1 },
    to: { x: animation.toX, y: animation.toY, opacity: 1 },
-    config: { tension: 120, friction: 14 }
+    config: { tension: 120, friction: 14 },
  })

  return (
@@ -35,7 +40,7 @@ const BoardingPassengerAnimation = memo(({ animation }: { animation: BoardingAni
        pointerEvents: 'none',
        filter: animation.passenger.isUrgent
          ? 'drop-shadow(0 0 8px rgba(245, 158, 11, 0.8))'
-          : 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))'
+          : 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
      }}
    >
      {animation.passenger.avatar}
@@ -44,29 +49,31 @@ const BoardingPassengerAnimation = memo(({ animation }: { animation: BoardingAni
 })
 BoardingPassengerAnimation.displayName = 'BoardingPassengerAnimation'

-const DisembarkingPassengerAnimation = memo(({ animation }: { animation: DisembarkingAnimation }) => {
-  const spring = useSpring({
-    from: { x: animation.fromX, y: animation.fromY, opacity: 1 },
-    to: { x: animation.toX, y: animation.toY, opacity: 1 },
-    config: { tension: 120, friction: 14 }
-  })
+const DisembarkingPassengerAnimation = memo(
+  ({ animation }: { animation: DisembarkingAnimation }) => {
+    const spring = useSpring({
+      from: { x: animation.fromX, y: animation.fromY, opacity: 1 },
+      to: { x: animation.toX, y: animation.toY, opacity: 1 },
+      config: { tension: 120, friction: 14 },
+    })

-  return (
-    <animated.text
-      x={spring.x}
-      y={spring.y}
-      textAnchor="middle"
-      opacity={spring.opacity}
-      style={{
-        fontSize: '55px',
-        pointerEvents: 'none',
-        filter: 'drop-shadow(0 0 12px rgba(16, 185, 129, 0.8))'
-      }}
-    >
-      {animation.passenger.avatar}
-    </animated.text>
-  )
-})
+    return (
+      <animated.text
+        x={spring.x}
+        y={spring.y}
+        textAnchor="middle"
+        opacity={spring.opacity}
+        style={{
+          fontSize: '55px',
+          pointerEvents: 'none',
+          filter: 'drop-shadow(0 0 12px rgba(16, 185, 129, 0.8))',
+        }}
+      >
+        {animation.passenger.avatar}
+      </animated.text>
+    )
+  }
+)
 DisembarkingPassengerAnimation.displayName = 'DisembarkingPassengerAnimation'

 interface SteamTrainJourneyProps {
@@ -74,20 +81,27 @@ interface SteamTrainJourneyProps {
  trainPosition: number
  pressure: number
  elapsedTime: number
-  currentQuestion: { number: number; targetSum: number; correctAnswer: number } | null
+  currentQuestion: ComplementQuestion | null
  currentInput: string
 }

-export function SteamTrainJourney({ momentum, trainPosition, pressure, elapsedTime, currentQuestion, currentInput }: SteamTrainJourneyProps) {
+export function SteamTrainJourney({
+  momentum,
+  trainPosition,
+  pressure,
+  elapsedTime,
+  currentQuestion,
+  currentInput,
+}: SteamTrainJourneyProps) {
  const { state } = useComplementRace()
  const { getSkyGradient, getTimeOfDayPeriod } = useSteamJourney()
-  const skyGradient = getSkyGradient()
+  const _skyGradient = getSkyGradient()
  const period = getTimeOfDayPeriod()
  const { players } = useGameMode()
-  const { profile } = useUserProfile()
+  const { profile: _profile } = useUserProfile()

  // Get the first active player's emoji
-  const activePlayers = Array.from(players.values()).filter(p => p.id)
+  const activePlayers = Array.from(players.values()).filter((p) => p.id)
  const firstActivePlayer = activePlayers[0]
  const playerEmoji = firstActivePlayer?.emoji ?? '👤'

@@ -110,11 +124,18 @@ export function SteamTrainJourney({ momentum, trainPosition, pressure, elapsedTi
    trackGenerator,
    pathRef,
    maxCars,
-    carSpacing
+    carSpacing,
  })

  // Track management (extracted to hook)
-  const { trackData, tiesAndRails, stationPositions, landmarks, landmarkPositions, displayPassengers } = useTrackManagement({
+  const {
+    trackData,
+    tiesAndRails,
+    stationPositions,
+    landmarks,
+    landmarkPositions,
+    displayPassengers,
+  } = useTrackManagement({
    currentRoute: state.currentRoute,
    trainPosition,
    trackGenerator,
@@ -122,7 +143,7 @@ export function SteamTrainJourney({ momentum, trainPosition, pressure, elapsedTi
    stations: state.stations,
    passengers: state.passengers,
    maxCars,
-    carSpacing
+    carSpacing,
  })

  // Passenger animations (extracted to hook)
@@ -132,7 +153,7 @@ export function SteamTrainJourney({ momentum, trainPosition, pressure, elapsedTi
    stationPositions,
    trainPosition,
    trackGenerator,
-    pathRef
+    pathRef,
  })

  // Time remaining (60 seconds total)
@@ -144,42 +165,45 @@ export function SteamTrainJourney({ momentum, trainPosition, pressure, elapsedTi
  // Get current route theme
  const routeTheme = getRouteTheme(state.currentRoute)

-
  // Memoize filtered passenger lists to avoid recalculating on every render
-  const boardedPassengers = useMemo(() =>
-    displayPassengers.filter(p => p.isBoarded && !p.isDelivered),
+  const boardedPassengers = useMemo(
+    () => displayPassengers.filter((p) => p.isBoarded && !p.isDelivered),
    [displayPassengers]
  )

-  const nonDeliveredPassengers = useMemo(() =>
-    displayPassengers.filter(p => !p.isDelivered),
+  const nonDeliveredPassengers = useMemo(
+    () => displayPassengers.filter((p) => !p.isDelivered),
    [displayPassengers]
  )

  // Memoize ground texture circles to avoid recreating on every render
-  const groundTextureCircles = useMemo(() =>
-    Array.from({ length: 30 }).map((_, i) => ({
-      key: `ground-texture-${i}`,
-      cx: -30 + (i * 28) + (i % 3) * 10,
-      cy: 140 + (i % 5) * 60,
-      r: 2 + (i % 3)
-    })),
+  const groundTextureCircles = useMemo(
+    () =>
+      Array.from({ length: 30 }).map((_, i) => ({
+        key: `ground-texture-${i}`,
+        cx: -30 + i * 28 + (i % 3) * 10,
+        cy: 140 + (i % 5) * 60,
+        r: 2 + (i % 3),
+      })),
    []
  )

  if (!trackData) return null

  return (
-    <div data-component="steam-train-journey" style={{
-      position: 'relative',
-      width: '100%',
-      height: '100%',
-      background: 'transparent',
-      overflow: 'visible',
-      display: 'flex',
-      alignItems: 'center',
-      justifyContent: 'stretch'
-    }}>
+    <div
+      data-component="steam-train-journey"
+      style={{
+        position: 'relative',
+        width: '100%',
+        height: '100%',
+        background: 'transparent',
+        overflow: 'visible',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'stretch',
+      }}
+    >
      {/* Game HUD - overlays and UI elements */}
      <GameHUD
        routeTheme={routeTheme}
@@ -202,7 +226,7 @@ export function SteamTrainJourney({ momentum, trainPosition, pressure, elapsedTi
          width: '100%',
          height: 'auto',
          aspectRatio: '800 / 600',
-          overflow: 'visible'
+          overflow: 'visible',
        }}
      >
        {/* Terrain background - ground, mountains, and tunnels */}
@@ -291,4 +315,4 @@ export function SteamTrainJourney({ momentum, trainPosition, pressure, elapsedTi
      `}</style>
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/TrainAndCars.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/TrainAndCars.tsx
@@ -31,131 +31,131 @@ interface TrainAndCarsProps {
  momentum: number
 }

-export const TrainAndCars = memo(({
-  boardingAnimations,
-  disembarkingAnimations,
-  BoardingPassengerAnimation,
-  DisembarkingPassengerAnimation,
-  trainCars,
-  boardedPassengers,
-  trainTransform,
-  locomotiveOpacity,
-  playerEmoji,
-  momentum
-}: TrainAndCarsProps) => {
-  return (
-    <>
-      {/* Boarding animations - passengers moving from station to train car */}
-      {Array.from(boardingAnimations.values()).map(animation => (
-        <BoardingPassengerAnimation
-          key={`boarding-${animation.passenger.id}`}
-          animation={animation}
-        />
-      ))}
+export const TrainAndCars = memo(
+  ({
+    boardingAnimations,
+    disembarkingAnimations,
+    BoardingPassengerAnimation,
+    DisembarkingPassengerAnimation,
+    trainCars,
+    boardedPassengers,
+    trainTransform,
+    locomotiveOpacity,
+    playerEmoji,
+    momentum,
+  }: TrainAndCarsProps) => {
+    return (
+      <>
+        {/* Boarding animations - passengers moving from station to train car */}
+        {Array.from(boardingAnimations.values()).map((animation) => (
+          <BoardingPassengerAnimation
+            key={`boarding-${animation.passenger.id}`}
+            animation={animation}
+          />
+        ))}

-      {/* Disembarking animations - passengers moving from train car to station */}
-      {Array.from(disembarkingAnimations.values()).map(animation => (
-        <DisembarkingPassengerAnimation
-          key={`disembarking-${animation.passenger.id}`}
-          animation={animation}
-        />
-      ))}
+        {/* Disembarking animations - passengers moving from train car to station */}
+        {Array.from(disembarkingAnimations.values()).map((animation) => (
+          <DisembarkingPassengerAnimation
+            key={`disembarking-${animation.passenger.id}`}
+            animation={animation}
+          />
+        ))}

-      {/* Train cars - render in reverse order so locomotive appears on top */}
-      {trainCars.map((carTransform, carIndex) => {
-        // Assign passenger to this car (if one exists for this car index)
-        const passenger = boardedPassengers[carIndex]
+        {/* Train cars - render in reverse order so locomotive appears on top */}
+        {trainCars.map((carTransform, carIndex) => {
+          // Assign passenger to this car (if one exists for this car index)
+          const passenger = boardedPassengers[carIndex]

-        return (
-          <g
-            key={`train-car-${carIndex}`}
-            data-component="train-car"
-            transform={`translate(${carTransform.x}, ${carTransform.y}) rotate(${carTransform.rotation}) scale(-1, 1)`}
-            opacity={carTransform.opacity}
-            style={{
-              transition: 'opacity 0.5s ease-in'
-            }}
-          >
-            {/* Train car */}
-            <text
-              data-element="train-car-body"
-              x={0}
-              y={0}
-              textAnchor="middle"
+          return (
+            <g
+              key={`train-car-${carIndex}`}
+              data-component="train-car"
+              transform={`translate(${carTransform.x}, ${carTransform.y}) rotate(${carTransform.rotation}) scale(-1, 1)`}
+              opacity={carTransform.opacity}
              style={{
-                fontSize: '65px',
-                filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
-                pointerEvents: 'none'
+                transition: 'opacity 0.5s ease-in',
              }}
            >
-              🚃
-            </text>
-
-            {/* Passenger inside this car (hide if currently boarding) */}
-            {passenger && !boardingAnimations.has(passenger.id) && (
+              {/* Train car */}
              <text
-                data-element="car-passenger"
+                data-element="train-car-body"
                x={0}
                y={0}
                textAnchor="middle"
                style={{
-                  fontSize: '42px',
-                  filter: passenger.isUrgent
-                    ? 'drop-shadow(0 0 6px rgba(245, 158, 11, 0.8))'
-                    : 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
-                  pointerEvents: 'none'
+                  fontSize: '65px',
+                  filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
+                  pointerEvents: 'none',
                }}
              >
-                {passenger.avatar}
+                🚃
              </text>
-            )}
-          </g>
-        )
-      })}

-      {/* Locomotive - rendered last so it appears on top */}
-      <g
-        data-component="locomotive-group"
-        transform={`translate(${trainTransform.x}, ${trainTransform.y}) rotate(${trainTransform.rotation}) scale(-1, 1)`}
-        opacity={locomotiveOpacity}
-        style={{
-          transition: 'opacity 0.5s ease-in'
-        }}
-      >
-        {/* Train locomotive */}
-        <text
-          data-element="train-locomotive"
-          x={0}
-          y={0}
-          textAnchor="middle"
+              {/* Passenger inside this car (hide if currently boarding) */}
+              {passenger && !boardingAnimations.has(passenger.id) && (
+                <text
+                  data-element="car-passenger"
+                  x={0}
+                  y={0}
+                  textAnchor="middle"
+                  style={{
+                    fontSize: '42px',
+                    filter: passenger.isUrgent
+                      ? 'drop-shadow(0 0 6px rgba(245, 158, 11, 0.8))'
+                      : 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
+                    pointerEvents: 'none',
+                  }}
+                >
+                  {passenger.avatar}
+                </text>
+              )}
+            </g>
+          )
+        })}
+
+        {/* Locomotive - rendered last so it appears on top */}
+        <g
+          data-component="locomotive-group"
+          transform={`translate(${trainTransform.x}, ${trainTransform.y}) rotate(${trainTransform.rotation}) scale(-1, 1)`}
+          opacity={locomotiveOpacity}
          style={{
-            fontSize: '100px',
-            filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
-            pointerEvents: 'none'
+            transition: 'opacity 0.5s ease-in',
          }}
        >
-          🚂
-        </text>
+          {/* Train locomotive */}
+          <text
+            data-element="train-locomotive"
+            x={0}
+            y={0}
+            textAnchor="middle"
+            style={{
+              fontSize: '100px',
+              filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
+              pointerEvents: 'none',
+            }}
+          >
+            🚂
+          </text>

-        {/* Player engineer - layered over the train */}
-        <text
-          data-element="player-engineer"
-          x={45}
-          y={0}
-          textAnchor="middle"
-          style={{
-            fontSize: '70px',
-            filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
-            pointerEvents: 'none'
-          }}
-        >
-          {playerEmoji}
-        </text>
+          {/* Player engineer - layered over the train */}
+          <text
+            data-element="player-engineer"
+            x={45}
+            y={0}
+            textAnchor="middle"
+            style={{
+              fontSize: '70px',
+              filter: 'drop-shadow(0 2px 4px rgba(0, 0, 0, 0.3))',
+              pointerEvents: 'none',
+            }}
+          >
+            {playerEmoji}
+          </text>

-        {/* Steam puffs - positioned at smokestack, layered over train */}
-        {momentum > 10 && (
-          <>
-            {[0, 0.6, 1.2].map((delay, i) => (
+          {/* Steam puffs - positioned at smokestack, layered over train */}
+          {momentum > 10 &&
+            [0, 0.6, 1.2].map((delay, i) => (
              <circle
                key={`steam-${i}`}
                cx={-35}
@@ -166,17 +166,14 @@ export const TrainAndCars = memo(({
                  filter: 'blur(4px)',
                  animation: `steamPuffSVG 2s ease-out infinite`,
                  animationDelay: `${delay}s`,
-                  pointerEvents: 'none'
+                  pointerEvents: 'none',
                }}
              />
            ))}
-          </>
-        )}

-        {/* Coal particles - animated when shoveling */}
-        {momentum > 60 && (
-          <>
-            {[0, 0.3, 0.6].map((delay, i) => (
+          {/* Coal particles - animated when shoveling */}
+          {momentum > 60 &&
+            [0, 0.3, 0.6].map((delay, i) => (
              <circle
                key={`coal-${i}`}
                cx={25}
@@ -186,15 +183,14 @@ export const TrainAndCars = memo(({
                style={{
                  animation: 'coalFallingSVG 1.2s ease-out infinite',
                  animationDelay: `${delay}s`,
-                  pointerEvents: 'none'
+                  pointerEvents: 'none',
                }}
              />
            ))}
-          </>
-        )}
-      </g>
-    </>
-  )
-})
+        </g>
+      </>
+    )
+  }
+)

 TrainAndCars.displayName = 'TrainAndCars'
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/TrainTerrainBackground.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/TrainTerrainBackground.tsx
@@ -12,187 +12,133 @@ interface TrainTerrainBackgroundProps {
  }>
 }

-export const TrainTerrainBackground = memo(({ ballastPath, groundTextureCircles }: TrainTerrainBackgroundProps) => {
-  return (
-    <>
-      {/* Gradient definitions for mountain shading and ground */}
-      <defs>
-        <linearGradient id="mountainGradientLeft" x1="0%" y1="0%" x2="100%" y2="100%">
-          <stop offset="0%" style={{ stopColor: '#a0a0a0', stopOpacity: 0.8 }} />
-          <stop offset="50%" style={{ stopColor: '#7a7a7a', stopOpacity: 0.6 }} />
-          <stop offset="100%" style={{ stopColor: '#5a5a5a', stopOpacity: 0.4 }} />
-        </linearGradient>
-        <linearGradient id="mountainGradientRight" x1="0%" y1="0%" x2="100%" y2="100%">
-          <stop offset="0%" style={{ stopColor: '#5a5a5a', stopOpacity: 0.4 }} />
-          <stop offset="50%" style={{ stopColor: '#7a7a7a', stopOpacity: 0.6 }} />
-          <stop offset="100%" style={{ stopColor: '#a0a0a0', stopOpacity: 0.8 }} />
-        </linearGradient>
-        <linearGradient id="groundGradient" x1="0%" y1="0%" x2="0%" y2="100%">
-          <stop offset="0%" style={{ stopColor: '#6a8759', stopOpacity: 0.3 }} />
-          <stop offset="100%" style={{ stopColor: '#8B7355', stopOpacity: 0 }} />
-        </linearGradient>
-      </defs>
+export const TrainTerrainBackground = memo(
+  ({ ballastPath, groundTextureCircles }: TrainTerrainBackgroundProps) => {
+    return (
+      <>
+        {/* Gradient definitions for mountain shading and ground */}
+        <defs>
+          <linearGradient id="mountainGradientLeft" x1="0%" y1="0%" x2="100%" y2="100%">
+            <stop offset="0%" style={{ stopColor: '#a0a0a0', stopOpacity: 0.8 }} />
+            <stop offset="50%" style={{ stopColor: '#7a7a7a', stopOpacity: 0.6 }} />
+            <stop offset="100%" style={{ stopColor: '#5a5a5a', stopOpacity: 0.4 }} />
+          </linearGradient>
+          <linearGradient id="mountainGradientRight" x1="0%" y1="0%" x2="100%" y2="100%">
+            <stop offset="0%" style={{ stopColor: '#5a5a5a', stopOpacity: 0.4 }} />
+            <stop offset="50%" style={{ stopColor: '#7a7a7a', stopOpacity: 0.6 }} />
+            <stop offset="100%" style={{ stopColor: '#a0a0a0', stopOpacity: 0.8 }} />
+          </linearGradient>
+          <linearGradient id="groundGradient" x1="0%" y1="0%" x2="0%" y2="100%">
+            <stop offset="0%" style={{ stopColor: '#6a8759', stopOpacity: 0.3 }} />
+            <stop offset="100%" style={{ stopColor: '#8B7355', stopOpacity: 0 }} />
+          </linearGradient>
+        </defs>

-      {/* Ground layer - extends full width and height to cover entire track area */}
-      <rect
-        x="-50"
-        y="120"
-        width="900"
-        height="530"
-        fill="#8B7355"
-      />
+        {/* Ground layer - extends full width and height to cover entire track area */}
+        <rect x="-50" y="120" width="900" height="530" fill="#8B7355" />

-      {/* Ground surface gradient for depth */}
-      <rect
-        x="-50"
-        y="120"
-        width="900"
-        height="60"
-        fill="url(#groundGradient)"
-      />
+        {/* Ground surface gradient for depth */}
+        <rect x="-50" y="120" width="900" height="60" fill="url(#groundGradient)" />

-      {/* Ground texture - scattered rocks/pebbles */}
-      {groundTextureCircles.map((circle) => (
-        <circle
-          key={circle.key}
-          cx={circle.cx}
-          cy={circle.cy}
-          r={circle.r}
-          fill="#654321"
-          opacity={0.3}
-        />
-      ))}
+        {/* Ground texture - scattered rocks/pebbles */}
+        {groundTextureCircles.map((circle) => (
+          <circle
+            key={circle.key}
+            cx={circle.cx}
+            cy={circle.cy}
+            r={circle.r}
+            fill="#654321"
+            opacity={0.3}
+          />
+        ))}

-      {/* Railroad ballast (gravel bed) */}
-      <path
-        d={ballastPath}
-        fill="none"
-        stroke="#8B7355"
-        strokeWidth="40"
-        strokeLinecap="round"
-      />
+        {/* Railroad ballast (gravel bed) */}
+        <path d={ballastPath} fill="none" stroke="#8B7355" strokeWidth="40" strokeLinecap="round" />

-      {/* Left mountain and tunnel */}
-      <g data-element="left-tunnel">
-        {/* Mountain base - extends from left edge */}
-        <rect
-          x="-50"
-          y="200"
-          width="120"
-          height="450"
-          fill="#6b7280"
-        />
+        {/* Left mountain and tunnel */}
+        <g data-element="left-tunnel">
+          {/* Mountain base - extends from left edge */}
+          <rect x="-50" y="200" width="120" height="450" fill="#6b7280" />

-        {/* Mountain peak - triangular slope */}
-        <path
-          d="M -50 200 L 70 200 L 20 -50 L -50 100 Z"
-          fill="#8b8b8b"
-        />
+          {/* Mountain peak - triangular slope */}
+          <path d="M -50 200 L 70 200 L 20 -50 L -50 100 Z" fill="#8b8b8b" />

-        {/* Mountain ridge shading */}
-        <path
-          d="M -50 200 L 70 200 L 20 -50 Z"
-          fill="url(#mountainGradientLeft)"
-        />
+          {/* Mountain ridge shading */}
+          <path d="M -50 200 L 70 200 L 20 -50 Z" fill="url(#mountainGradientLeft)" />

+          {/* Tunnel depth/interior (dark entrance) */}
+          <ellipse cx="20" cy="300" rx="50" ry="55" fill="#0a0a0a" />

-        {/* Tunnel depth/interior (dark entrance) */}
-        <ellipse
-          cx="20"
-          cy="300"
-          rx="50"
-          ry="55"
-          fill="#0a0a0a"
-        />
+          {/* Tunnel arch opening */}
+          <path
+            d="M 20 355 L -50 355 L -50 245 Q -50 235, 20 235 Q 70 235, 70 245 L 70 355 Z"
+            fill="#1a1a1a"
+            stroke="#4a4a4a"
+            strokeWidth="3"
+          />

-        {/* Tunnel arch opening */}
-        <path
-          d="M 20 355 L -50 355 L -50 245 Q -50 235, 20 235 Q 70 235, 70 245 L 70 355 Z"
-          fill="#1a1a1a"
-          stroke="#4a4a4a"
-          strokeWidth="3"
-        />
+          {/* Tunnel arch rim (stone bricks) */}
+          <path
+            d="M -50 245 Q -50 235, 20 235 Q 70 235, 70 245"
+            fill="none"
+            stroke="#8b7355"
+            strokeWidth="8"
+            strokeLinecap="round"
+          />

-        {/* Tunnel arch rim (stone bricks) */}
-        <path
-          d="M -50 245 Q -50 235, 20 235 Q 70 235, 70 245"
-          fill="none"
-          stroke="#8b7355"
-          strokeWidth="8"
-          strokeLinecap="round"
-        />
+          {/* Stone brick texture around arch */}
+          <path
+            d="M -50 245 Q -50 235, 20 235 Q 70 235, 70 245"
+            fill="none"
+            stroke="#654321"
+            strokeWidth="2"
+            strokeDasharray="15,10"
+          />
+        </g>

-        {/* Stone brick texture around arch */}
-        <path
-          d="M -50 245 Q -50 235, 20 235 Q 70 235, 70 245"
-          fill="none"
-          stroke="#654321"
-          strokeWidth="2"
-          strokeDasharray="15,10"
-        />
-      </g>
+        {/* Right mountain and tunnel */}
+        <g data-element="right-tunnel">
+          {/* Mountain base - extends to right edge */}
+          <rect x="680" y="200" width="170" height="450" fill="#6b7280" />

-      {/* Right mountain and tunnel */}
-      <g data-element="right-tunnel">
-        {/* Mountain base - extends to right edge */}
-        <rect
-          x="680"
-          y="200"
-          width="170"
-          height="450"
-          fill="#6b7280"
-        />
+          {/* Mountain peak - triangular slope */}
+          <path d="M 730 200 L 850 200 L 850 100 L 780 -50 Z" fill="#8b8b8b" />

-        {/* Mountain peak - triangular slope */}
-        <path
-          d="M 730 200 L 850 200 L 850 100 L 780 -50 Z"
-          fill="#8b8b8b"
-        />
+          {/* Mountain ridge shading */}
+          <path d="M 730 200 L 850 150 L 780 -50 Z" fill="url(#mountainGradientRight)" />

-        {/* Mountain ridge shading */}
-        <path
-          d="M 730 200 L 850 150 L 780 -50 Z"
-          fill="url(#mountainGradientRight)"
-        />
+          {/* Tunnel depth/interior (dark entrance) */}
+          <ellipse cx="780" cy="300" rx="50" ry="55" fill="#0a0a0a" />

+          {/* Tunnel arch opening */}
+          <path
+            d="M 780 355 L 730 355 L 730 245 Q 730 235, 780 235 Q 850 235, 850 245 L 850 355 Z"
+            fill="#1a1a1a"
+            stroke="#4a4a4a"
+            strokeWidth="3"
+          />

-        {/* Tunnel depth/interior (dark entrance) */}
-        <ellipse
-          cx="780"
-          cy="300"
-          rx="50"
-          ry="55"
-          fill="#0a0a0a"
-        />
+          {/* Tunnel arch rim (stone bricks) */}
+          <path
+            d="M 730 245 Q 730 235, 780 235 Q 850 235, 850 245"
+            fill="none"
+            stroke="#8b7355"
+            strokeWidth="8"
+            strokeLinecap="round"
+          />

-        {/* Tunnel arch opening */}
-        <path
-          d="M 780 355 L 730 355 L 730 245 Q 730 235, 780 235 Q 850 235, 850 245 L 850 355 Z"
-          fill="#1a1a1a"
-          stroke="#4a4a4a"
-          strokeWidth="3"
-        />
-
-        {/* Tunnel arch rim (stone bricks) */}
-        <path
-          d="M 730 245 Q 730 235, 780 235 Q 850 235, 850 245"
-          fill="none"
-          stroke="#8b7355"
-          strokeWidth="8"
-          strokeLinecap="round"
-        />
-
-        {/* Stone brick texture around arch */}
-        <path
-          d="M 730 245 Q 730 235, 780 235 Q 850 235, 850 245"
-          fill="none"
-          stroke="#654321"
-          strokeWidth="2"
-          strokeDasharray="15,10"
-        />
-      </g>
-    </>
-  )
-})
+          {/* Stone brick texture around arch */}
+          <path
+            d="M 730 245 Q 730 235, 780 235 Q 850 235, 850 245"
+            fill="none"
+            stroke="#654321"
+            strokeWidth="2"
+            strokeDasharray="15,10"
+          />
+        </g>
+      </>
+    )
+  }
+)

 TrainTerrainBackground.displayName = 'TrainTerrainBackground'
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/tests/GameHUD.test.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/tests/GameHUD.test.tsx
@@ -1,40 +1,41 @@
 import { render, screen } from '@testing-library/react'
-import { describe, test, expect, vi } from 'vitest'
+import { describe, expect, test, vi } from 'vitest'
+import type { Passenger, Station } from '../../../lib/gameTypes'
 import { GameHUD } from '../GameHUD'
-import type { Station, Passenger } from '../../../lib/gameTypes'

 // Mock child components
 vi.mock('../../PassengerCard', () => ({
  PassengerCard: ({ passenger }: { passenger: Passenger }) => (
    <div data-testid="passenger-card">{passenger.avatar}</div>
-  )
+  ),
 }))

 vi.mock('../../PressureGauge', () => ({
  PressureGauge: ({ pressure }: { pressure: number }) => (
    <div data-testid="pressure-gauge">{pressure}</div>
-  )
+  ),
 }))

 describe('GameHUD', () => {
  const mockRouteTheme = {
    emoji: '🚂',
-    name: 'Mountain Pass'
+    name: 'Mountain Pass',
  }

  const mockStations: Station[] = [
    { id: 'station-1', name: 'Station 1', position: 20, icon: '🏭' },
-    { id: 'station-2', name: 'Station 2', position: 60, icon: '🏛️' }
+    { id: 'station-2', name: 'Station 2', position: 60, icon: '🏛️' },
  ]

  const mockPassenger: Passenger = {
    id: 'passenger-1',
+    name: 'Test Passenger',
    avatar: '👨',
    originStationId: 'station-1',
    destinationStationId: 'station-2',
    isBoarded: false,
    isDelivered: false,
-    isUrgent: false
+    isUrgent: false,
  }

  const defaultProps = {
@@ -48,9 +49,10 @@ describe('GameHUD', () => {
    currentQuestion: {
      number: 3,
      targetSum: 10,
-      correctAnswer: 7
+      correctAnswer: 7,
+      showAsAbacus: false,
    },
-    currentInput: '7'
+    currentInput: '7',
  }

  test('renders route information', () => {
@@ -120,7 +122,7 @@ describe('GameHUD', () => {
    const passengers = [
      mockPassenger,
      { ...mockPassenger, id: 'passenger-2', avatar: '👩' },
-      { ...mockPassenger, id: 'passenger-3', avatar: '👧' }
+      { ...mockPassenger, id: 'passenger-3', avatar: '👧' },
    ]

    render(<GameHUD {...defaultProps} nonDeliveredPassengers={passengers} />)
--- a/apps/web/src/app/arcade/complement-race/components/RaceTrack/tests/TrainTerrainBackground.test.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RaceTrack/tests/TrainTerrainBackground.test.tsx
@@ -1,17 +1,20 @@
 import { render } from '@testing-library/react'
-import { describe, test, expect } from 'vitest'
+import { describe, expect, test } from 'vitest'
 import { TrainTerrainBackground } from '../TrainTerrainBackground'

 describe('TrainTerrainBackground', () => {
  const mockGroundCircles = [
    { key: 'ground-1', cx: 10, cy: 150, r: 2 },
-    { key: 'ground-2', cx: 40, cy: 180, r: 3 }
+    { key: 'ground-2', cx: 40, cy: 180, r: 3 },
  ]

  test('renders without crashing', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

@@ -21,7 +24,10 @@ describe('TrainTerrainBackground', () => {
  test('renders gradient definitions', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

@@ -37,7 +43,10 @@ describe('TrainTerrainBackground', () => {
  test('renders ground layer rects', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

@@ -46,7 +55,7 @@ describe('TrainTerrainBackground', () => {

    // Check for ground base layer
    const groundRect = Array.from(rects).find(
-      rect => rect.getAttribute('fill') === '#8B7355' && rect.getAttribute('width') === '900'
+      (rect) => rect.getAttribute('fill') === '#8B7355' && rect.getAttribute('width') === '900'
    )
    expect(groundRect).toBeTruthy()
  })
@@ -54,7 +63,10 @@ describe('TrainTerrainBackground', () => {
  test('renders ground texture circles', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

@@ -71,12 +83,16 @@ describe('TrainTerrainBackground', () => {
  test('renders ballast path with correct attributes', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

    const ballastPath = Array.from(container.querySelectorAll('path')).find(
-      path => path.getAttribute('d') === 'M 0 300 L 800 300' && path.getAttribute('stroke') === '#8B7355'
+      (path) =>
+        path.getAttribute('d') === 'M 0 300 L 800 300' && path.getAttribute('stroke') === '#8B7355'
    )
    expect(ballastPath).toBeTruthy()
    expect(ballastPath?.getAttribute('stroke-width')).toBe('40')
@@ -85,7 +101,10 @@ describe('TrainTerrainBackground', () => {
  test('renders left tunnel structure', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

@@ -100,7 +119,10 @@ describe('TrainTerrainBackground', () => {
  test('renders right tunnel structure', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

@@ -115,12 +137,15 @@ describe('TrainTerrainBackground', () => {
  test('renders mountains with gradient fills', () => {
    const { container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

    // Check for paths with gradient fills
-    const gradientPaths = Array.from(container.querySelectorAll('path')).filter(path =>
+    const gradientPaths = Array.from(container.querySelectorAll('path')).filter((path) =>
      path.getAttribute('fill')?.includes('url(#mountainGradient')
    )
    expect(gradientPaths.length).toBeGreaterThanOrEqual(2)
@@ -141,7 +166,10 @@ describe('TrainTerrainBackground', () => {
  test('memoization: does not re-render with same props', () => {
    const { rerender, container } = render(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

@@ -150,7 +178,10 @@ describe('TrainTerrainBackground', () => {
    // Rerender with same props
    rerender(
      <svg>
-        <TrainTerrainBackground ballastPath="M 0 300 L 800 300" groundTextureCircles={mockGroundCircles} />
+        <TrainTerrainBackground
+          ballastPath="M 0 300 L 800 300"
+          groundTextureCircles={mockGroundCircles}
+        />
      </svg>
    )

--- a/apps/web/src/app/arcade/complement-race/components/RouteCelebration.tsx
+++ b/apps/web/src/app/arcade/complement-race/components/RouteCelebration.tsx
@@ -8,91 +8,101 @@ interface RouteCelebrationProps {
  onContinue: () => void
 }

-export function RouteCelebration({ completedRouteNumber, nextRouteNumber, onContinue }: RouteCelebrationProps) {
+export function RouteCelebration({
+  completedRouteNumber,
+  nextRouteNumber,
+  onContinue,
+}: RouteCelebrationProps) {
  const completedTheme = getRouteTheme(completedRouteNumber)
  const nextTheme = getRouteTheme(nextRouteNumber)

  return (
-    <div style={{
-      position: 'fixed',
-      top: 0,
-      left: 0,
-      right: 0,
-      bottom: 0,
-      background: 'rgba(0, 0, 0, 0.7)',
-      display: 'flex',
-      alignItems: 'center',
-      justifyContent: 'center',
-      zIndex: 9999,
-      animation: 'fadeIn 0.3s ease-out'
-    }}>
-      <div style={{
-        background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
-        borderRadius: '24px',
-        padding: '40px',
-        maxWidth: '500px',
-        textAlign: 'center',
-        boxShadow: '0 20px 60px rgba(0, 0, 0, 0.5)',
-        animation: 'scaleIn 0.5s ease-out',
-        color: 'white'
-      }}>
+    <div
+      style={{
+        position: 'fixed',
+        top: 0,
+        left: 0,
+        right: 0,
+        bottom: 0,
+        background: 'rgba(0, 0, 0, 0.7)',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        zIndex: 9999,
+        animation: 'fadeIn 0.3s ease-out',
+      }}
+    >
+      <div
+        style={{
+          background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+          borderRadius: '24px',
+          padding: '40px',
+          maxWidth: '500px',
+          textAlign: 'center',
+          boxShadow: '0 20px 60px rgba(0, 0, 0, 0.5)',
+          animation: 'scaleIn 0.5s ease-out',
+          color: 'white',
+        }}
+      >
        {/* Celebration header */}
-        <div style={{
-          fontSize: '64px',
-          marginBottom: '20px',
-          animation: 'bounce 1s ease-in-out infinite'
-        }}>
+        <div
+          style={{
+            fontSize: '64px',
+            marginBottom: '20px',
+            animation: 'bounce 1s ease-in-out infinite',
+          }}
+        >
          🎉
        </div>

-        <h2 style={{
-          fontSize: '32px',
-          fontWeight: 'bold',
-          marginBottom: '16px',
-          textShadow: '0 2px 10px rgba(0, 0, 0, 0.3)'
-        }}>
+        <h2
+          style={{
+            fontSize: '32px',
+            fontWeight: 'bold',
+            marginBottom: '16px',
+            textShadow: '0 2px 10px rgba(0, 0, 0, 0.3)',
+          }}
+        >
          Route Complete!
        </h2>

        {/* Completed route info */}
-        <div style={{
-          background: 'rgba(255, 255, 255, 0.2)',
-          borderRadius: '12px',
-          padding: '16px',
-          marginBottom: '24px'
-        }}>
-          <div style={{ fontSize: '40px', marginBottom: '8px' }}>
-            {completedTheme.emoji}
-          </div>
-          <div style={{ fontSize: '20px', fontWeight: '600' }}>
-            {completedTheme.name}
-          </div>
+        <div
+          style={{
+            background: 'rgba(255, 255, 255, 0.2)',
+            borderRadius: '12px',
+            padding: '16px',
+            marginBottom: '24px',
+          }}
+        >
+          <div style={{ fontSize: '40px', marginBottom: '8px' }}>{completedTheme.emoji}</div>
+          <div style={{ fontSize: '20px', fontWeight: '600' }}>{completedTheme.name}</div>
          <div style={{ fontSize: '16px', opacity: 0.9, marginTop: '4px' }}>
            Route {completedRouteNumber}
          </div>
        </div>

        {/* Next route preview */}
-        <div style={{
-          fontSize: '14px',
-          opacity: 0.9,
-          marginBottom: '8px'
-        }}>
+        <div
+          style={{
+            fontSize: '14px',
+            opacity: 0.9,
+            marginBottom: '8px',
+          }}
+        >
          Next destination:
        </div>
-        <div style={{
-          background: 'rgba(255, 255, 255, 0.15)',
-          borderRadius: '12px',
-          padding: '12px',
-          marginBottom: '24px',
-          border: '2px dashed rgba(255, 255, 255, 0.3)'
-        }}>
-          <div style={{ fontSize: '32px', marginBottom: '4px' }}>
-            {nextTheme.emoji}
-          </div>
-          <div style={{ fontSize: '18px', fontWeight: '600' }}>
-            {nextTheme.name}
-          </div>
+        <div
+          style={{
+            background: 'rgba(255, 255, 255, 0.15)',
+            borderRadius: '12px',
+            padding: '12px',
+            marginBottom: '24px',
+            border: '2px dashed rgba(255, 255, 255, 0.3)',
+          }}
+        >
+          <div style={{ fontSize: '32px', marginBottom: '4px' }}>{nextTheme.emoji}</div>
+          <div style={{ fontSize: '18px', fontWeight: '600' }}>{nextTheme.name}</div>
          <div style={{ fontSize: '14px', opacity: 0.8, marginTop: '4px' }}>
            Route {nextRouteNumber}
          </div>
@@ -111,7 +121,7 @@ export function RouteCelebration({ completedRouteNumber, nextRouteNumber, onCont
            fontWeight: 'bold',
            cursor: 'pointer',
            boxShadow: '0 4px 12px rgba(0, 0, 0, 0.2)',
-            transition: 'transform 0.2s ease, box-shadow 0.2s ease'
+            transition: 'transform 0.2s ease, box-shadow 0.2s ease',
          }}
          onMouseEnter={(e) => {
            e.currentTarget.style.transform = 'translateY(-2px)'
@@ -158,4 +168,4 @@ export function RouteCelebration({ completedRouteNumber, nextRouteNumber, onCont
      `}</style>
    </div>
  )
-}
+}
--- a/apps/web/src/app/arcade/complement-race/context/ComplementRaceContext.tsx
+++ b/apps/web/src/app/arcade/complement-race/context/ComplementRaceContext.tsx
@@ -1,7 +1,8 @@
 'use client'

-import React, { createContext, useContext, useReducer, ReactNode } from 'react'
-import type { GameState, GameAction, AIRacer, DifficultyTracker, Station, Passenger } from '../lib/gameTypes'
+import type React from 'react'
+import { createContext, type ReactNode, useContext, useReducer } from 'react'
+import type { AIRacer, DifficultyTracker, GameAction, GameState, Station } from '../lib/gameTypes'

 const initialDifficultyTracker: DifficultyTracker = {
  pairPerformance: new Map(),
@@ -11,32 +12,32 @@ const initialDifficultyTracker: DifficultyTracker = {
  consecutiveCorrect: 0,
  consecutiveIncorrect: 0,
  learningMode: true,
-  adaptationRate: 0.1
+  adaptationRate: 0.1,
 }

 const initialAIRacers: AIRacer[] = [
  {
    id: 'ai-racer-1',
    position: 0,
-    speed: 0.32,  // Balanced speed for good challenge
+    speed: 0.32, // Balanced speed for good challenge
    name: 'Swift AI',
    personality: 'competitive',
    icon: '🏃‍♂️',
    lastComment: 0,
    commentCooldown: 0,
-    previousPosition: 0
+    previousPosition: 0,
  },
  {
    id: 'ai-racer-2',
    position: 0,
-    speed: 0.20,  // Balanced speed for good challenge
+    speed: 0.2, // Balanced speed for good challenge
    name: 'Math Bot',
    personality: 'analytical',
    icon: '🏃',
    lastComment: 0,
    commentCooldown: 0,
-    previousPosition: 0
-  }
+    previousPosition: 0,
+  },
 ]

 const initialStations: Station[] = [
@@ -45,7 +46,7 @@ const initialStations: Station[] = [
  { id: 'station-2', name: 'Hillside', position: 40, icon: '⛰️' },
  { id: 'station-3', name: 'Canyon View', position: 60, icon: '🏜️' },
  { id: 'station-4', name: 'Meadows', position: 80, icon: '🌾' },
-  { id: 'station-5', name: 'Grand Central', position: 100, icon: '🏛️' }
+  { id: 'station-5', name: 'Grand Central', position: 100, icon: '🏛️' },
 ]

 const initialState: GameState = {
@@ -108,7 +109,7 @@ const initialState: GameState = {
  // UI state
  showScoreModal: false,
  activeSpeechBubbles: new Map(),
-  adaptiveFeedback: null
+  adaptiveFeedback: null,
 }

 function gameReducer(state: GameState, action: GameAction): GameState {
@@ -131,7 +132,7 @@ function gameReducer(state: GameState, action: GameAction): GameState {
    case 'START_COUNTDOWN':
      return { ...state, gamePhase: 'countdown' }

-    case 'BEGIN_GAME':
+    case 'BEGIN_GAME': {
      // Generate first question when game starts
      const generateFirstQuestion = () => {
        let targetSum: number
@@ -143,19 +144,19 @@ function gameReducer(state: GameState, action: GameAction): GameState {
          targetSum = Math.random() > 0.5 ? 5 : 10
        }

-        const newNumber = targetSum === 5
-          ? Math.floor(Math.random() * 5)
-          : Math.floor(Math.random() * 10)
+        const newNumber =
+          targetSum === 5 ? Math.floor(Math.random() * 5) : Math.floor(Math.random() * 10)

        // Decide once whether to show as abacus
-        const showAsAbacus = state.complementDisplay === 'abacus' ||
+        const showAsAbacus =
+          state.complementDisplay === 'abacus' ||
          (state.complementDisplay === 'random' && Math.random() < 0.5)

        return {
          number: newNumber,
          targetSum,
          correctAnswer: targetSum - newNumber,
-          showAsAbacus
+          showAsAbacus,
        }
      }

@@ -165,10 +166,11 @@ function gameReducer(state: GameState, action: GameAction): GameState {
        isGameActive: true,
        gameStartTime: Date.now(),
        questionStartTime: Date.now(),
-        currentQuestion: generateFirstQuestion()
+        currentQuestion: generateFirstQuestion(),
      }
+    }

-    case 'NEXT_QUESTION':
+    case 'NEXT_QUESTION': {
      // Generate new question based on mode
      const generateQuestion = () => {
        let targetSum: number
@@ -198,14 +200,15 @@ function gameReducer(state: GameState, action: GameAction): GameState {
        )

        // Decide once whether to show as abacus
-        const showAsAbacus = state.complementDisplay === 'abacus' ||
+        const showAsAbacus =
+          state.complementDisplay === 'abacus' ||
          (state.complementDisplay === 'random' && Math.random() < 0.5)

        return {
          number: newNumber,
          targetSum,
          correctAnswer: targetSum - newNumber,
-          showAsAbacus
+          showAsAbacus,
        }
      }

@@ -214,13 +217,14 @@ function gameReducer(state: GameState, action: GameAction): GameState {
        previousQuestion: state.currentQuestion,
        currentQuestion: generateQuestion(),
        questionStartTime: Date.now(),
-        currentInput: ''
+        currentInput: '',
      }
+    }

    case 'UPDATE_INPUT':
      return { ...state, currentInput: action.input }

-    case 'SUBMIT_ANSWER':
+    case 'SUBMIT_ANSWER': {
      if (!state.currentQuestion) return state

      const isCorrect = action.answer === state.currentQuestion.correctAnswer
@@ -228,12 +232,12 @@ function gameReducer(state: GameState, action: GameAction): GameState {

      if (isCorrect) {
        // Calculate speed bonus: max(0, 300 - (avgTime * 10))
-        const speedBonus = Math.max(0, 300 - (responseTime / 100))
+        const speedBonus = Math.max(0, 300 - responseTime / 100)

        // Update score: correctAnswers * 100 + streak * 50 + speedBonus
        const newStreak = state.streak + 1
        const newCorrectAnswers = state.correctAnswers + 1
-        const newScore = state.score + 100 + (newStreak * 50) + speedBonus
+        const newScore = state.score + 100 + newStreak * 50 + speedBonus

        return {
          ...state,
@@ -241,26 +245,27 @@ function gameReducer(state: GameState, action: GameAction): GameState {
          streak: newStreak,
          bestStreak: Math.max(state.bestStreak, newStreak),
          score: Math.round(newScore),
-          totalQuestions: state.totalQuestions + 1
+          totalQuestions: state.totalQuestions + 1,
        }
      } else {
        // Incorrect answer - reset streak but keep score
        return {
          ...state,
          streak: 0,
-          totalQuestions: state.totalQuestions + 1
+          totalQuestions: state.totalQuestions + 1,
        }
      }
+    }

    case 'UPDATE_AI_POSITIONS':
      return {
        ...state,
-        aiRacers: state.aiRacers.map(racer => {
-          const update = action.positions.find(p => p.id === racer.id)
+        aiRacers: state.aiRacers.map((racer) => {
+          const update = action.positions.find((p) => p.id === racer.id)
          return update
            ? { ...racer, previousPosition: racer.position, position: update.position }
            : racer
-        })
+        }),
      }

    case 'UPDATE_MOMENTUM':
@@ -275,7 +280,7 @@ function gameReducer(state: GameState, action: GameAction): GameState {
        momentum: action.momentum,
        trainPosition: action.trainPosition,
        pressure: action.pressure,
-        elapsedTime: action.elapsedTime
+        elapsedTime: action.elapsedTime,
      }

    case 'COMPLETE_LAP':
@@ -307,81 +312,83 @@ function gameReducer(state: GameState, action: GameAction): GameState {
        style: state.style,
        timeoutSetting: state.timeoutSetting,
        complementDisplay: state.complementDisplay,
-        gamePhase: 'controls'
+        gamePhase: 'controls',
      }

-    case 'TRIGGER_AI_COMMENTARY':
+    case 'TRIGGER_AI_COMMENTARY': {
      const newBubbles = new Map(state.activeSpeechBubbles)
      newBubbles.set(action.racerId, action.message)
      return {
        ...state,
        activeSpeechBubbles: newBubbles,
        // Update racer's lastComment time and cooldown
-        aiRacers: state.aiRacers.map(racer =>
+        aiRacers: state.aiRacers.map((racer) =>
          racer.id === action.racerId
            ? {
                ...racer,
                lastComment: Date.now(),
-                commentCooldown: Math.random() * 4000 + 2000  // 2-6 seconds
+                commentCooldown: Math.random() * 4000 + 2000, // 2-6 seconds
              }
            : racer
-        )
+        ),
      }
+    }

-    case 'CLEAR_AI_COMMENT':
+    case 'CLEAR_AI_COMMENT': {
      const clearedBubbles = new Map(state.activeSpeechBubbles)
      clearedBubbles.delete(action.racerId)
      return {
        ...state,
-        activeSpeechBubbles: clearedBubbles
+        activeSpeechBubbles: clearedBubbles,
      }
+    }

    case 'UPDATE_DIFFICULTY_TRACKER':
      return {
        ...state,
-        difficultyTracker: action.tracker
+        difficultyTracker: action.tracker,
      }

    case 'UPDATE_AI_SPEEDS':
      return {
        ...state,
-        aiRacers: action.racers
+        aiRacers: action.racers,
      }

    case 'SHOW_ADAPTIVE_FEEDBACK':
      return {
        ...state,
-        adaptiveFeedback: action.feedback
+        adaptiveFeedback: action.feedback,
      }

    case 'CLEAR_ADAPTIVE_FEEDBACK':
      return {
        ...state,
-        adaptiveFeedback: null
+        adaptiveFeedback: null,
      }

    case 'GENERATE_PASSENGERS':
      return {
        ...state,
-        passengers: action.passengers
+        passengers: action.passengers,
      }

    case 'BOARD_PASSENGER':
      return {
        ...state,
-        passengers: state.passengers.map(p =>
+        passengers: state.passengers.map((p) =>
          p.id === action.passengerId ? { ...p, isBoarded: true } : p
-        )
+        ),
      }

    case 'DELIVER_PASSENGER':
      return {
        ...state,
-        passengers: state.passengers.map(p =>
+        passengers: state.passengers.map((p) =>
          p.id === action.passengerId ? { ...p, isDelivered: true } : p
        ),
        deliveredPassengers: state.deliveredPassengers + 1,
-        score: state.score + action.points
+        score: state.score + action.points,
      }

    case 'START_NEW_ROUTE':
@@ -393,20 +400,20 @@ function gameReducer(state: GameState, action: GameAction): GameState {
        deliveredPassengers: 0,
        showRouteCelebration: false,
        momentum: 50, // Give some starting momentum for the new route
-        pressure: 50
+        pressure: 50,
      }

    case 'COMPLETE_ROUTE':
      return {
        ...state,
        cumulativeDistance: state.cumulativeDistance + 100,
-        showRouteCelebration: true
+        showRouteCelebration: true,
      }

    case 'HIDE_ROUTE_CELEBRATION':
      return {
        ...state,
-        showRouteCelebration: false
+        showRouteCelebration: false,
      }

    default:
@@ -429,7 +436,7 @@ interface ComplementRaceProviderProps {
 export function ComplementRaceProvider({ children, initialStyle }: ComplementRaceProviderProps) {
  const [state, dispatch] = useReducer(gameReducer, {
    ...initialState,
-    style: initialStyle || initialState.style
+    style: initialStyle || initialState.style,
  })

  return (
@@ -445,4 +452,4 @@ export function useComplementRace() {
    throw new Error('useComplementRace must be used within ComplementRaceProvider')
  }
  return context
-}
+}
--- a/apps/web/src/app/arcade/complement-race/hooks/tests/usePassengerAnimations.test.ts
+++ b/apps/web/src/app/arcade/complement-race/hooks/tests/usePassengerAnimations.test.ts
@@ -1,8 +1,8 @@
 import { renderHook } from '@testing-library/react'
-import { describe, test, expect, beforeEach, vi } from 'vitest'
-import { usePassengerAnimations } from '../usePassengerAnimations'
+import { beforeEach, describe, expect, test, vi } from 'vitest'
 import type { Passenger, Station } from '../../lib/gameTypes'
 import type { RailroadTrackGenerator } from '../../lib/RailroadTrackGenerator'
+import { usePassengerAnimations } from '../usePassengerAnimations'

 describe('usePassengerAnimations', () => {
  let mockPathRef: React.RefObject<SVGPathElement>
@@ -19,11 +19,11 @@ describe('usePassengerAnimations', () => {

    // Mock track generator
    mockTrackGenerator = {
-      getTrainTransform: vi.fn((path: SVGPathElement, position: number) => ({
+      getTrainTransform: vi.fn((_path: SVGPathElement, position: number) => ({
        x: position * 10,
        y: 300,
-        rotation: 0
-      }))
+        rotation: 0,
+      })),
    } as unknown as RailroadTrackGenerator

    // Create mock stations
@@ -31,35 +31,37 @@ describe('usePassengerAnimations', () => {
      id: 'station-1',
      name: 'Station 1',
      position: 20,
-      icon: '🏭'
+      icon: '🏭',
    }

    mockStation2 = {
      id: 'station-2',
      name: 'Station 2',
      position: 60,
-      icon: '🏛️'
+      icon: '🏛️',
    }

    // Create mock passengers
    mockPassenger1 = {
      id: 'passenger-1',
+      name: 'Passenger 1',
      avatar: '👨',
      originStationId: 'station-1',
      destinationStationId: 'station-2',
      isBoarded: false,
      isDelivered: false,
-      isUrgent: false
+      isUrgent: false,
    }

    mockPassenger2 = {
      id: 'passenger-2',
+      name: 'Passenger 2',
      avatar: '👩',
      originStationId: 'station-1',
      destinationStationId: 'station-2',
      isBoarded: false,
      isDelivered: false,
-      isUrgent: true
+      isUrgent: true,
    }

    vi.clearAllMocks()
@@ -72,11 +74,11 @@ describe('usePassengerAnimations', () => {
        stations: [mockStation1, mockStation2],
        stationPositions: [
          { x: 100, y: 300 },
-          { x: 500, y: 300 }
+          { x: 500, y: 300 },
        ],
        trainPosition: 0,
        trackGenerator: mockTrackGenerator,
-        pathRef: mockPathRef
+        pathRef: mockPathRef,
      })
    )

@@ -92,16 +94,16 @@ describe('usePassengerAnimations', () => {
          stations: [mockStation1, mockStation2],
          stationPositions: [
            { x: 100, y: 300 },
-            { x: 500, y: 300 }
+            { x: 500, y: 300 },
          ],
          trainPosition: 20,
          trackGenerator: mockTrackGenerator,
-          pathRef: mockPathRef
+          pathRef: mockPathRef,
        }),
      {
        initialProps: {
-          passengers: [mockPassenger1]
-        }
+          passengers: [mockPassenger1],
+        },
      }
    )

@@ -134,16 +136,16 @@ describe('usePassengerAnimations', () => {
          stations: [mockStation1, mockStation2],
          stationPositions: [
            { x: 100, y: 300 },
-            { x: 500, y: 300 }
+            { x: 500, y: 300 },
          ],
          trainPosition: 60,
          trackGenerator: mockTrackGenerator,
-          pathRef: mockPathRef
+          pathRef: mockPathRef,
        }),
      {
        initialProps: {
-          passengers: [boardedPassenger]
-        }
+          passengers: [boardedPassenger],
+        },
      }
    )

@@ -173,23 +175,23 @@ describe('usePassengerAnimations', () => {
          stations: [mockStation1, mockStation2],
          stationPositions: [
            { x: 100, y: 300 },
-            { x: 500, y: 300 }
+            { x: 500, y: 300 },
          ],
          trainPosition: 20,
          trackGenerator: mockTrackGenerator,
-          pathRef: mockPathRef
+          pathRef: mockPathRef,
        }),
      {
        initialProps: {
-          passengers: [mockPassenger1, mockPassenger2]
-        }
+          passengers: [mockPassenger1, mockPassenger2],
+        },
      }
    )

    // Both passengers board
    const boardedPassengers = [
      { ...mockPassenger1, isBoarded: true },
-      { ...mockPassenger2, isBoarded: true }
+      { ...mockPassenger2, isBoarded: true },
    ]
    rerender({ passengers: boardedPassengers })

@@ -208,11 +210,11 @@ describe('usePassengerAnimations', () => {
        stations: [mockStation1, mockStation2],
        stationPositions: [
          { x: 100, y: 300 },
-          { x: 500, y: 300 }
+          { x: 500, y: 300 },
        ],
        trainPosition: 20,
        trackGenerator: mockTrackGenerator,
-        pathRef: mockPathRef
+        pathRef: mockPathRef,
      })
    )

@@ -230,16 +232,16 @@ describe('usePassengerAnimations', () => {
          stations: [mockStation1, mockStation2],
          stationPositions: [
            { x: 100, y: 300 },
-            { x: 500, y: 300 }
+            { x: 500, y: 300 },
          ],
          trainPosition: 20,
          trackGenerator: mockTrackGenerator,
-          pathRef: nullPathRef
+          pathRef: nullPathRef,
        }),
      {
        initialProps: {
-          passengers: [mockPassenger1]
-        }
+          passengers: [mockPassenger1],
+        },
      }
    )

@@ -260,12 +262,12 @@ describe('usePassengerAnimations', () => {
          stationPositions: [],
          trainPosition: 20,
          trackGenerator: mockTrackGenerator,
-          pathRef: mockPathRef
+          pathRef: mockPathRef,
        }),
      {
        initialProps: {
-          passengers: [mockPassenger1]
-        }
+          passengers: [mockPassenger1],
+        },
      }
    )

--- a/apps/web/src/app/arcade/complement-race/hooks/tests/useSteamJourney.boarding.test.ts
+++ b/apps/web/src/app/arcade/complement-race/hooks/tests/useSteamJourney.boarding.test.ts
@@ -1,10 +1,10 @@
-import { describe, test, expect, beforeEach, afterEach, vi } from 'vitest'
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest'

 // Mock sound effects
 vi.mock('../useSoundEffects', () => ({
  useSoundEffects: () => ({
-    playSound: vi.fn()
-  })
+    playSound: vi.fn(),
+  }),
 }))

 /**
@@ -61,7 +61,7 @@ describe('useSteamJourney - Boarding Logic', () => {
    maxCars: number
  ): Passenger[] {
    const updatedPassengers = [...passengers]
-    const currentBoardedPassengers = updatedPassengers.filter(p => p.isBoarded && !p.isDelivered)
+    const currentBoardedPassengers = updatedPassengers.filter((p) => p.isBoarded && !p.isDelivered)

    // Track which cars are assigned in THIS frame to prevent double-boarding
    const carsAssignedThisFrame = new Set<number>()
@@ -70,7 +70,7 @@ describe('useSteamJourney - Boarding Logic', () => {
    updatedPassengers.forEach((passenger, passengerIndex) => {
      if (passenger.isBoarded || passenger.isDelivered) return

-      const station = stations.find(s => s.id === passenger.originStationId)
+      const station = stations.find((s) => s.id === passenger.originStationId)
      if (!station) return

      // Check if any empty car is at this station
@@ -104,12 +104,12 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Train at position 27%, first car at position 20% (station 1)
-    let result = simulateBoardingAtPosition(27, passengers, stations, 1)
+    const result = simulateBoardingAtPosition(27, passengers, stations, 1)

    expect(result[0].isBoarded).toBe(true)
  })
@@ -124,7 +124,7 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p2',
@@ -134,7 +134,7 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p3',
@@ -144,8 +144,8 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Train at position 34%, cars at: 27%, 20%, 13%
@@ -187,7 +187,7 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p2',
@@ -197,8 +197,8 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Simulate train speeding through station
@@ -220,7 +220,7 @@ describe('useSteamJourney - Boarding Logic', () => {
    // Car 1 at 38%, car 2 at 31% - both way past 20%

    // All passengers should have boarded
-    expect(result.every(p => p.isBoarded)).toBe(true)
+    expect(result.every((p) => p.isBoarded)).toBe(true)
  })

  test('EDGE CASE: passenger left behind when boarding window is missed', () => {
@@ -233,7 +233,7 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p2',
@@ -243,8 +243,8 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Only 1 car, 2 passengers
@@ -271,7 +271,7 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p2',
@@ -281,8 +281,8 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Only 1 car, both passengers at same station
@@ -305,7 +305,7 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p2',
@@ -315,7 +315,7 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p3',
@@ -325,8 +325,8 @@ describe('useSteamJourney - Boarding Logic', () => {
        destinationStationId: 's2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // 3 passengers, 3 cars
@@ -339,12 +339,15 @@ describe('useSteamJourney - Boarding Logic', () => {
    }

    // All passengers should have boarded by the time last car passes
-    const allBoarded = result.every(p => p.isBoarded)
-    const leftBehind = result.filter(p => !p.isBoarded)
+    const allBoarded = result.every((p) => p.isBoarded)
+    const leftBehind = result.filter((p) => !p.isBoarded)

    expect(allBoarded).toBe(true)
    if (!allBoarded) {
-      console.log('Passengers left behind:', leftBehind.map(p => p.name))
+      console.log(
+        'Passengers left behind:',
+        leftBehind.map((p) => p.name)
+      )
    }
  })
 })
--- a/apps/web/src/app/arcade/complement-race/hooks/tests/useSteamJourney.passenger.test.tsx
+++ b/apps/web/src/app/arcade/complement-race/hooks/tests/useSteamJourney.passenger.test.tsx
@@ -8,25 +8,22 @@
 * 4. Passengers are delivered to the correct destination
 */

-import { renderHook, act } from '@testing-library/react'
-import { ReactNode } from 'react'
-import { ComplementRaceProvider } from '../../context/ComplementRaceContext'
-import { useSteamJourney } from '../useSteamJourney'
-import { useComplementRace } from '../../context/ComplementRaceContext'
+import { act, renderHook } from '@testing-library/react'
+import type { ReactNode } from 'react'
+import { ComplementRaceProvider, useComplementRace } from '../../context/ComplementRaceContext'
 import type { Passenger, Station } from '../../lib/gameTypes'
+import { useSteamJourney } from '../useSteamJourney'

 // Mock sound effects
-jest.mock('../useSoundEffects', () => ({
+vi.mock('../useSoundEffects', () => ({
  useSoundEffects: () => ({
-    playSound: jest.fn()
-  })
+    playSound: vi.fn(),
+  }),
 }))

 // Wrapper component
 const wrapper = ({ children }: { children: ReactNode }) => (
-  <ComplementRaceProvider initialStyle="sprint">
-    {children}
-  </ComplementRaceProvider>
+  <ComplementRaceProvider initialStyle="sprint">{children}</ComplementRaceProvider>
 )

 // Helper to create test passengers
@@ -44,32 +41,35 @@ const createPassenger = (
  destinationStationId,
  isUrgent: false,
  isBoarded,
-  isDelivered
+  isDelivered,
 })

 // Test stations
-const testStations: Station[] = [
+const _testStations: Station[] = [
  { id: 'station-0', name: 'Start', position: 0, icon: '🏁' },
  { id: 'station-1', name: 'Middle', position: 50, icon: '🏢' },
-  { id: 'station-2', name: 'End', position: 100, icon: '🏁' }
+  { id: 'station-2', name: 'End', position: 100, icon: '🏁' },
 ]

 describe('useSteamJourney - Passenger Boarding', () => {
  beforeEach(() => {
-    jest.useFakeTimers()
+    vi.useFakeTimers()
  })

  afterEach(() => {
-    jest.runOnlyPendingTimers()
-    jest.useRealTimers()
+    vi.runOnlyPendingTimers()
+    vi.useRealTimers()
  })

  test('passenger boards when train reaches their origin station', () => {
-    const { result } = renderHook(() => {
-      const journey = useSteamJourney()
-      const race = useComplementRace()
-      return { journey, race }
-    }, { wrapper })
+    const { result } = renderHook(
+      () => {
+        const journey = useSteamJourney()
+        const race = useComplementRace()
+        return { journey, race }
+      },
+      { wrapper }
+    )

    // Setup: Add passenger waiting at station-1 (position 50)
    const passenger = createPassenger('p1', 'station-1', 'station-2')
@@ -78,7 +78,7 @@ describe('useSteamJourney - Passenger Boarding', () => {
      result.current.race.dispatch({ type: 'BEGIN_GAME' })
      result.current.race.dispatch({
        type: 'GENERATE_PASSENGERS',
-        passengers: [passenger]
+        passengers: [passenger],
      })
      // Set train position just before station-1
      result.current.race.dispatch({
@@ -86,7 +86,7 @@ describe('useSteamJourney - Passenger Boarding', () => {
        momentum: 50,
        trainPosition: 40, // First car will be at ~33 (40 - 7)
        pressure: 75,
-        elapsedTime: 1000
+        elapsedTime: 1000,
      })
    })

@@ -100,39 +100,42 @@ describe('useSteamJourney - Passenger Boarding', () => {
        momentum: 50,
        trainPosition: 57, // First car at position 50 (57 - 7)
        pressure: 75,
-        elapsedTime: 2000
+        elapsedTime: 2000,
      })
    })

    // Advance timers to trigger the interval
    act(() => {
-      jest.advanceTimersByTime(100)
+      vi.advanceTimersByTime(100)
    })

    // Verify passenger boarded
-    const boardedPassenger = result.current.race.state.passengers.find(p => p.id === 'p1')
+    const boardedPassenger = result.current.race.state.passengers.find((p) => p.id === 'p1')
    expect(boardedPassenger?.isBoarded).toBe(true)
  })

  test('multiple passengers can board at the same station on different cars', () => {
-    const { result } = renderHook(() => {
-      const journey = useSteamJourney()
-      const race = useComplementRace()
-      return { journey, race }
-    }, { wrapper })
+    const { result } = renderHook(
+      () => {
+        const journey = useSteamJourney()
+        const race = useComplementRace()
+        return { journey, race }
+      },
+      { wrapper }
+    )

    // Setup: Three passengers waiting at station-1
    const passengers = [
      createPassenger('p1', 'station-1', 'station-2'),
      createPassenger('p2', 'station-1', 'station-2'),
-      createPassenger('p3', 'station-1', 'station-2')
+      createPassenger('p3', 'station-1', 'station-2'),
    ]

    act(() => {
      result.current.race.dispatch({ type: 'BEGIN_GAME' })
      result.current.race.dispatch({
        type: 'GENERATE_PASSENGERS',
-        passengers
+        passengers,
      })
      // Set train with 3 empty cars approaching station-1 (position 50)
      // Cars at: 50 (57-7), 43 (57-14), 36 (57-21)
@@ -141,26 +144,29 @@ describe('useSteamJourney - Passenger Boarding', () => {
        momentum: 60,
        trainPosition: 57,
        pressure: 90,
-        elapsedTime: 1000
+        elapsedTime: 1000,
      })
    })

    // Advance timers
    act(() => {
-      jest.advanceTimersByTime(100)
+      vi.advanceTimersByTime(100)
    })

    // All three passengers should board (one per car)
-    const boardedCount = result.current.race.state.passengers.filter(p => p.isBoarded).length
+    const boardedCount = result.current.race.state.passengers.filter((p) => p.isBoarded).length
    expect(boardedCount).toBe(3)
  })

  test('passenger is not left behind when train passes quickly', () => {
-    const { result } = renderHook(() => {
-      const journey = useSteamJourney()
-      const race = useComplementRace()
-      return { journey, race }
-    }, { wrapper })
+    const { result } = renderHook(
+      () => {
+        const journey = useSteamJourney()
+        const race = useComplementRace()
+        return { journey, race }
+      },
+      { wrapper }
+    )

    const passenger = createPassenger('p1', 'station-1', 'station-2')

@@ -168,7 +174,7 @@ describe('useSteamJourney - Passenger Boarding', () => {
      result.current.race.dispatch({ type: 'BEGIN_GAME' })
      result.current.race.dispatch({
        type: 'GENERATE_PASSENGERS',
-        passengers: [passenger]
+        passengers: [passenger],
      })
    })

@@ -182,13 +188,13 @@ describe('useSteamJourney - Passenger Boarding', () => {
          momentum: 80,
          trainPosition: pos,
          pressure: 120,
-          elapsedTime: 1000 + pos * 50
+          elapsedTime: 1000 + pos * 50,
        })
-        jest.advanceTimersByTime(50)
+        vi.advanceTimersByTime(50)
      })

      // Check if passenger boarded
-      const boardedPassenger = result.current.race.state.passengers.find(p => p.id === 'p1')
+      const boardedPassenger = result.current.race.state.passengers.find((p) => p.id === 'p1')
      if (boardedPassenger?.isBoarded) {
        // Success! Passenger boarded during the pass
        return
@@ -196,28 +202,31 @@ describe('useSteamJourney - Passenger Boarding', () => {
    }

    // If we get here, passenger was left behind
-    const boardedPassenger = result.current.race.state.passengers.find(p => p.id === 'p1')
+    const boardedPassenger = result.current.race.state.passengers.find((p) => p.id === 'p1')
    expect(boardedPassenger?.isBoarded).toBe(true)
  })

  test('passenger boards on correct car based on availability', () => {
-    const { result } = renderHook(() => {
-      const journey = useSteamJourney()
-      const race = useComplementRace()
-      return { journey, race }
-    }, { wrapper })
+    const { result } = renderHook(
+      () => {
+        const journey = useSteamJourney()
+        const race = useComplementRace()
+        return { journey, race }
+      },
+      { wrapper }
+    )

    // Setup: One passenger already on car 0, another waiting
    const passengers = [
      createPassenger('p1', 'station-0', 'station-2', true, false), // Already boarded on car 0
-      createPassenger('p2', 'station-1', 'station-2') // Waiting at station-1
+      createPassenger('p2', 'station-1', 'station-2'), // Waiting at station-1
    ]

    act(() => {
      result.current.race.dispatch({ type: 'BEGIN_GAME' })
      result.current.race.dispatch({
        type: 'GENERATE_PASSENGERS',
-        passengers
+        passengers,
      })
      // Train at station-1, car 0 occupied, car 1 empty
      result.current.race.dispatch({
@@ -225,30 +234,33 @@ describe('useSteamJourney - Passenger Boarding', () => {
        momentum: 50,
        trainPosition: 57, // Car 0 at 50, Car 1 at 43
        pressure: 75,
-        elapsedTime: 2000
+        elapsedTime: 2000,
      })
    })

    act(() => {
-      jest.advanceTimersByTime(100)
+      vi.advanceTimersByTime(100)
    })

    // p2 should board (on car 1 since car 0 is occupied)
-    const p2 = result.current.race.state.passengers.find(p => p.id === 'p2')
+    const p2 = result.current.race.state.passengers.find((p) => p.id === 'p2')
    expect(p2?.isBoarded).toBe(true)

    // p1 should still be boarded
-    const p1 = result.current.race.state.passengers.find(p => p.id === 'p1')
+    const p1 = result.current.race.state.passengers.find((p) => p.id === 'p1')
    expect(p1?.isBoarded).toBe(true)
    expect(p1?.isDelivered).toBe(false)
  })

  test('passenger is delivered when their car reaches destination', () => {
-    const { result } = renderHook(() => {
-      const journey = useSteamJourney()
-      const race = useComplementRace()
-      return { journey, race }
-    }, { wrapper })
+    const { result } = renderHook(
+      () => {
+        const journey = useSteamJourney()
+        const race = useComplementRace()
+        return { journey, race }
+      },
+      { wrapper }
+    )

    // Setup: Passenger already boarded, heading to station-2 (position 100)
    const passenger = createPassenger('p1', 'station-0', 'station-2', true, false)
@@ -257,7 +269,7 @@ describe('useSteamJourney - Passenger Boarding', () => {
      result.current.race.dispatch({ type: 'BEGIN_GAME' })
      result.current.race.dispatch({
        type: 'GENERATE_PASSENGERS',
-        passengers: [passenger]
+        passengers: [passenger],
      })
      // Move train so car 0 reaches station-2
      result.current.race.dispatch({
@@ -265,16 +277,16 @@ describe('useSteamJourney - Passenger Boarding', () => {
        momentum: 50,
        trainPosition: 107, // Car 0 at position 100 (107 - 7)
        pressure: 75,
-        elapsedTime: 5000
+        elapsedTime: 5000,
      })
    })

    act(() => {
-      jest.advanceTimersByTime(100)
+      vi.advanceTimersByTime(100)
    })

    // Passenger should be delivered
-    const deliveredPassenger = result.current.race.state.passengers.find(p => p.id === 'p1')
+    const deliveredPassenger = result.current.race.state.passengers.find((p) => p.id === 'p1')
    expect(deliveredPassenger?.isDelivered).toBe(true)
  })
 })
--- a/apps/web/src/app/arcade/complement-race/hooks/tests/useTrackManagement.passenger-display.test.ts
+++ b/apps/web/src/app/arcade/complement-race/hooks/tests/useTrackManagement.passenger-display.test.ts
@@ -1,8 +1,8 @@
 import { renderHook } from '@testing-library/react'
-import { describe, test, expect, beforeEach, vi } from 'vitest'
-import { useTrackManagement } from '../useTrackManagement'
+import { beforeEach, describe, expect, test, vi } from 'vitest'
+import type { Passenger, Station } from '../../lib/gameTypes'
 import type { RailroadTrackGenerator } from '../../lib/RailroadTrackGenerator'
-import type { Station, Passenger } from '../../lib/gameTypes'
+import { useTrackManagement } from '../useTrackManagement'

 describe('useTrackManagement - Passenger Display', () => {
  let mockPathRef: React.RefObject<SVGPathElement>
@@ -17,7 +17,11 @@ describe('useTrackManagement - Passenger Display', () => {
    mockPath.getPointAtLength = vi.fn((distance: number) => ({
      x: distance,
      y: 300,
-    }))
+      w: 1,
+      z: 0,
+      matrixTransform: () => new DOMPoint(),
+      toJSON: () => ({ x: distance, y: 300, w: 1, z: 0 }),
+    })) as any
    mockPathRef = { current: mockPath }

    // Mock track generator
@@ -27,13 +31,13 @@ describe('useTrackManagement - Passenger Display', () => {
        referencePath: 'M 0 0',
        ties: [],
        leftRailPath: 'M 0 0',
-        rightRailPath: 'M 0 0'
+        rightRailPath: 'M 0 0',
      })),
      generateTiesAndRails: vi.fn(() => ({
        ties: [],
        leftRailPath: 'M 0 0',
-        rightRailPath: 'M 0 0'
-      }))
+        rightRailPath: 'M 0 0',
+      })),
    } as unknown as RailroadTrackGenerator

    // Mock stations
@@ -53,7 +57,7 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station2',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
+        isUrgent: false,
      },
      {
        id: 'p2',
@@ -63,8 +67,8 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station3',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    vi.clearAllMocks()
@@ -80,7 +84,7 @@ describe('useTrackManagement - Passenger Display', () => {
        stations: mockStations,
        passengers: mockPassengers,
        maxCars: 3,
-        carSpacing: 7
+        carSpacing: 7,
      })
    )

@@ -100,7 +104,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { passengers: mockPassengers, position: 25 } }
    )
@@ -110,7 +114,7 @@ describe('useTrackManagement - Passenger Display', () => {
    expect(result.current.displayPassengers[0].isBoarded).toBe(false)

    // Board first passenger
-    const boardedPassengers = mockPassengers.map(p =>
+    const boardedPassengers = mockPassengers.map((p) =>
      p.id === 'p1' ? { ...p, isBoarded: true } : p
    )

@@ -132,7 +136,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { route: 1, passengers: mockPassengers, position: 50 } }
    )
@@ -151,8 +155,8 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station3',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Change route but train still moving
@@ -175,7 +179,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { route: 1, passengers: mockPassengers, position: 50 } }
    )
@@ -194,8 +198,8 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station3',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Change route and train resets
@@ -218,7 +222,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { route: 1, passengers: mockPassengers, position: 95 } }
    )
@@ -237,8 +241,8 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station3',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Train exits (105%) but route hasn't changed yet
@@ -274,7 +278,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { passengers: mockPassengers, position: 50 } }
    )
@@ -284,7 +288,7 @@ describe('useTrackManagement - Passenger Display', () => {
    expect(result.current.displayPassengers[0].id).toBe('p1')

    // Create new array with same content (different reference)
-    const samePassengersNewRef = mockPassengers.map(p => ({ ...p }))
+    const samePassengersNewRef = mockPassengers.map((p) => ({ ...p }))

    // Update with new reference but same content
    rerender({ passengers: samePassengersNewRef, position: 50 })
@@ -305,7 +309,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { passengers: mockPassengers, position: 25 } }
    )
@@ -315,7 +319,7 @@ describe('useTrackManagement - Passenger Display', () => {
    expect(result.current.displayPassengers[0].isDelivered).toBe(false)

    // Deliver first passenger
-    const deliveredPassengers = mockPassengers.map(p =>
+    const deliveredPassengers = mockPassengers.map((p) =>
      p.id === 'p1' ? { ...p, isBoarded: true, isDelivered: true } : p
    )

@@ -337,7 +341,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { passengers: mockPassengers, position: 25 } }
    )
@@ -346,23 +350,17 @@ describe('useTrackManagement - Passenger Display', () => {
    expect(result.current.displayPassengers).toHaveLength(2)

    // Board p1
-    let updated = mockPassengers.map(p =>
-      p.id === 'p1' ? { ...p, isBoarded: true } : p
-    )
+    let updated = mockPassengers.map((p) => (p.id === 'p1' ? { ...p, isBoarded: true } : p))
    rerender({ passengers: updated, position: 26 })
    expect(result.current.displayPassengers[0].isBoarded).toBe(true)

    // Board p2
-    updated = updated.map(p =>
-      p.id === 'p2' ? { ...p, isBoarded: true } : p
-    )
+    updated = updated.map((p) => (p.id === 'p2' ? { ...p, isBoarded: true } : p))
    rerender({ passengers: updated, position: 52 })
    expect(result.current.displayPassengers[1].isBoarded).toBe(true)

    // Deliver p1
-    updated = updated.map(p =>
-      p.id === 'p1' ? { ...p, isDelivered: true } : p
-    )
+    updated = updated.map((p) => (p.id === 'p1' ? { ...p, isDelivered: true } : p))
    rerender({ passengers: updated, position: 53 })
    expect(result.current.displayPassengers[0].isDelivered).toBe(true)

@@ -384,7 +382,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { route: 1, passengers: mockPassengers, position: 95 } }
    )
@@ -406,8 +404,8 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station3',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // CRITICAL: New passengers, old route, position = 0
@@ -431,7 +429,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { route: 1, passengers: mockPassengers, position: 95 } }
    )
@@ -449,8 +447,8 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station3',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // CRITICAL: New passengers array, same route, position within 0-100
@@ -471,7 +469,7 @@ describe('useTrackManagement - Passenger Display', () => {
          stations: mockStations,
          passengers,
          maxCars: 3,
-          carSpacing: 7
+          carSpacing: 7,
        }),
      { initialProps: { route: 1, passengers: mockPassengers, position: 50 } }
    )
@@ -487,8 +485,8 @@ describe('useTrackManagement - Passenger Display', () => {
        destinationStationId: 'station3',
        isBoarded: false,
        isDelivered: false,
-        isUrgent: false
-      }
+        isUrgent: false,
+      },
    ]

    // Route changes, position goes positive briefly before negative
--- a/Show More
+++ b/Show More