How andrechiapetta/karaokeando works
Karaokêando is a real-time social karaoke app: a host creates a room, guests join on mobile to find and queue songs or choose duet partners, and the TV plays songs while displaying live room state and rankings. The backend owns room coordination, WebSocket updates, authentication, and persistence; the frontend supplies host, guest, and TV experiences. The README documents the main product capabilities; some subsystem connections are omitted where sampled source does not show the caller.
Main entry points: main.tsx App routing · api.ts API and WebSocket · prisma.ts Prisma client · RoomMobile.tsx Mobile controller
Components 23
Web experiences
- App routing
frontend/src/main.tsx - Auth flows
frontend/src/context/AuthContext.tsx - Room setup
frontend/src/pages/CreateRoom.tsx - Home and join
frontend/src/pages/Home.tsx - Mobile controller
frontend/src/pages/RoomMobile.tsx - TV player
frontend/src/pages/RoomTV.tsx - Admin dashboard
frontend/src/pages/Dashboard.tsx - API and WebSocket
frontend/src/api.ts
Live room
- Room runtime
backend/src/server.ts - Room endpoints
backend/src/routes/rooms.ts
Identity and rooms
- Auth endpoints
backend/src/routes/auth.ts - Password and tokens
backend/src/lib/auth.ts - Prisma client
backend/src/lib/prisma.ts - PostgreSQL
backend/prisma/schema.prisma
Song catalog and scoring
- Song search
backend/src/server.ts - Saved songs
backend/src/lib/songs.ts - Score display
frontend/src/components/ScoreOverlay.tsx - Score calculation
frontend/src/score/pikaraokeScore.ts - Score reviews
frontend/src/score/pikaraokeReviews.ts - Score effects
frontend/src/score/fireworks.ts
Other components
- Host
- Guests
- YouTube
Connections 30
- Host → App routing: uses
README.md - Guests → App routing: join rooms
README.md - App routing → Home and join: routes to
frontend/src/main.tsx - App routing → Mobile controller: routes to
frontend/src/main.tsx - App routing → TV player: routes to
frontend/src/main.tsx - App routing → Admin dashboard: routes to
frontend/src/main.tsx - App routing → Auth flows: provides
frontend/src/main.tsx - Host → Room setup: creates rooms
README.md - Room setup → API and WebSocket: creates room
frontend/src/pages/CreateRoom.tsx - Mobile controller → API and WebSocket: searches and queues
frontend/src/pages/RoomMobile.tsx - TV player → API and WebSocket: controls playback
frontend/src/pages/RoomTV.tsx - Admin dashboard → API and WebSocket: requests data
frontend/src/pages/Dashboard.tsx - Auth flows → API and WebSocket: requests auth
frontend/src/context/AuthContext.tsx - API and WebSocket → Room runtime: calls API and WebSocket
README.md - Room runtime → Room endpoints: registers routes
backend/src/server.ts - Room runtime → Prisma client: restores rooms
backend/src/server.ts - Room endpoints → Prisma client: reads and writes
backend/src/routes/rooms.ts - Auth endpoints → Prisma client: reads and writes
backend/src/routes/auth.ts - Auth endpoints → Password and tokens: hashes and verifies
backend/src/routes/auth.ts - Room endpoints → Auth endpoints: checks user
backend/src/routes/rooms.ts - Prisma client → PostgreSQL: persists data
README.md - Mobile controller → Song search: searches YouTube
frontend/src/pages/RoomMobile.tsx - Mobile controller → Saved songs: loads saved songs
README.md - Room runtime → Saved songs: loads library
backend/src/server.ts - Saved songs → Prisma client: reads songs
backend/src/lib/songs.ts - Song search → YouTube: searches videos
README.md - TV player → Score display: shows score
README.md - Score display → Score calculation: calculates score
frontend/src/components/ScoreOverlay.tsx - Score display → Score effects: launches effects
frontend/src/components/ScoreOverlay.tsx - Score calculation → Score reviews: selects review
frontend/src/score/pikaraokeScore.ts