How muhammed-ali-dev/parlorbit works
Parlorbit supports private Codenames nights: guests create Houses, invite friends for host approval, organize rooms, and play together with live presence; optional calls add voice and video. The React app uses HTTP for House and invite actions and WebSockets for room presence and switching. The Go server handles routes and domain operations, with SQLite-backed state. Mutation Lab is a secondary multiplayer experiment, and the Codenames arena is another documented game capability. The graph reflects README claims and sampled references; unsampled implementations and connections are shown only where documented.
Main entry points: server.go HTTP server · App.tsx Parlorbit UI · voice.ts Voice client · store.go SQLite store
Components 19
Web client
- Parlorbit UI
web/src/App.tsx - House cards
web/src/components/HouseCard.tsx - HTTP client
web/src/api.ts - Realtime client
web/src/realtime.ts - Voice client
web/src/voice.ts - Video tiles
web/src/components/VideoTile.tsx
Application server
- HTTP server
internal/app/server.go - House membership
internal/app - Room management
internal/app - Game assignment
internal/app - Voice tokens
internal/app/voice.go
Games and calls
- Codenames arena
web/public/battle - Mutation Lab
internal/app/battle.go - LiveKit calls
Persistence and realtime
- SQLite store
internal/app/store.go - House repository
internal/app/repository.go - Realtime hub
internal/app/hub.go - Realtime outbox
internal/app/realtime_outbox.go
Other components
- Guest
Connections 23
- Guest → Parlorbit UI: uses
README.md - Parlorbit UI → House cards: renders
web/src/App.tsx - Parlorbit UI → HTTP client: requests
web/src/App.tsx - Parlorbit UI → Realtime client: subscribes
web/src/App.tsx - Parlorbit UI → Voice client: joins calls
web/src/App.tsx - Video tiles → Voice client: attaches tracks
web/src/components/VideoTile.tsx - HTTP client → HTTP server: HTTP requests
web/src/api.ts - Realtime client → HTTP server: WebSocket messages
web/src/realtime.ts - HTTP server → SQLite store: reads and writes
internal/app/server.go - HTTP server → House membership: handles membership
- HTTP server → Room management: handles rooms
- HTTP server → Game assignment: sets room game
- HTTP server → Realtime hub: broadcasts updates
internal/app/server.go - HTTP server → Voice tokens: issues tokens
internal/app/server.go - Voice client → HTTP client: requests token
web/src/voice.ts - Voice client → LiveKit calls: connects
web/src/voice.ts - Parlorbit UI → Codenames arena: opens game
README.md - Parlorbit UI → Mutation Lab: supports experiment
README.md - Codenames arena → HTTP server: sends game actions
- Mutation Lab → SQLite store: uses persisted state
- SQLite store → House repository: stores domain data
- Realtime hub → SQLite store: reads presence state
- Realtime hub → Realtime outbox: queues updates