How nathanblatter/impostor works
This is a browser-based multiplayer party-game platform: players create or join rooms, configure a game, play one of several social-deduction and party-game modes, then vote or reveal results. The WebSocket server manages room membership and routes game actions through a room-level orchestrator to mode-specific engines; the client presents room and play interfaces and receives game state. Source excerpts show these core connections, but not all UI routing or every server message handler, so those relationships are omitted where unverified.
Main entry points: GameRoom.ts Room orchestrator · main.ts HTTP and WebSocket server · messages.ts Message protocol · Playing.tsx Core game screens
Components 21
Browser client
- Application shell
client/components/App.tsx - Socket session
client/useSocket.ts - Narration playback
client/useAudio.ts - Core game screens
client/components/Playing.tsx - Room lobby
client/components/Lobby.tsx - Results view
client/components/Results.tsx - Mode screens
client/components - Game timer
client/useTimer.ts - Sound effects
client/useSound.ts
Realtime server
- HTTP and WebSocket server
server/main.ts - Room registry
server/RoomManager.ts - Room orchestrator
server/GameRoom.ts - Player connection
server/Player.ts
Game engines
- Mode engines
server - Word pool
server/WordPool.ts
Shared protocol
- Message protocol
shared/messages.ts - Game state types
shared/types.ts
Data and AI
- AI content generation
server/AiPlayer.ts - Persistent assets and sessions
server/db.ts
Other components
- Player
- Anthropic API
Connections 26
- Player → Application shell: uses
- Application shell → Socket session: opens session
client/components/App.tsx - Socket session → Narration playback: queues narration
client/useSocket.ts - Core game screens → Game timer: uses timer
client/components/Playing.tsx - Core game screens → Sound effects: plays effects
client/components/Playing.tsx - Mode screens → Game timer: uses timer
client/components/BonusPlaying.tsx - Mode screens → Sound effects: plays effects
client/components/Voting.tsx - HTTP and WebSocket server → Room registry: manages rooms
server/main.ts - Room registry → Room orchestrator: creates rooms
server/RoomManager.ts - Room registry → Player connection: tracks players
server/RoomManager.ts - HTTP and WebSocket server → Player connection: constructs players
server/main.ts - HTTP and WebSocket server → Room orchestrator: routes game actions
server/main.ts - Room orchestrator → Mode engines: delegates mode play
server/GameRoom.ts - Room orchestrator → Player connection: broadcasts state
server/GameRoom.ts - Room orchestrator → Word pool: loads word data
server/GameRoom.ts - Room orchestrator → AI content generation: requests generated content
server/GameRoom.ts - AI content generation → Persistent assets and sessions: reads and saves assets
server/AiPlayer.ts - AI content generation → Anthropic API: generates content
server/AiPlayer.ts - HTTP and WebSocket server → Persistent assets and sessions: initializes and records sessions
server/main.ts - Application shell → Message protocol: uses message types
client/components/App.tsx - Socket session → Message protocol: sends and receives
client/useSocket.ts - Core game screens → Message protocol: uses message types
client/components/Playing.tsx - HTTP and WebSocket server → Message protocol: dispatches messages
server/main.ts - Room orchestrator → Game state types: builds game state
server/GameRoom.ts - Room lobby → Game state types: uses settings and state
client/components/Lobby.tsx - Results view → Game state types: renders results
client/components/Results.tsx