How chinjuku/beatdrop works
BeatDrop is a Thai/international snippet-guessing game: players configure a mode and difficulty, play staged audio rounds, submit guesses, and view results or leaderboards. The architecture also supports daily challenges, artist and catalog management, and multiplayer rooms. Edges below reflect README statements and the shown source references; unsampled routes and room internals are represented conservatively, so some capabilities have no asserted internal call chain.
Main entry points: GameContext.tsx Game interface · songPool.ts Song pool · roundEngine.ts Round engine · artistRoutes.ts Artist services
Components 28
Game play
- Game interface
context/GameContext.tsx - Play modes
app/[locale]/play/page.tsx - Round endpoints
app/api/rounds/start/route.ts - Round engine
lib/engine/roundEngine.ts - Audio playback
hooks/useAudioController.ts - Audio proxy
app/api/proxy/audio/route.ts - Song Guesser
app/[locale]/guesser/page.tsx
Daily challenge
- Daily play
app/[locale]/daily/page.tsx - Daily endpoints
app/api/daily/route.ts - Daily engine
lib/engine/dailyEngine.ts - Daily results
components/daily/DailyResults.tsx - Leaderboard
lib/engine/leaderboard.ts
Music catalog
- Catalog browsing
app/[locale]/categories/page.tsx - Artist view
components/artist/ArtistPageView.tsx - Artist endpoints
app/api/artists/sync/route.ts - Artist services
lib/engine/artistRoutes.ts - Song pool
lib/engine/songPool.ts - iTunes ingestion
lib/itunes.ts
Multiplayer rooms
- Room interface
app/[locale]/room/[code]/page.tsx - Room endpoints
app/api/rooms/route.ts - Room service
lib/rooms/service.ts - Room state
lib/rooms/store.ts
Storage and platform
- Database service
lib/db.ts - Supabase storage
shared/supabase.ts - Local preferences
lib/preferenceStorage.ts - Daily scheduler
app/api/cron/daily/route.ts
Other components
- Player
- iTunes API
Connections 28
- Player → Game interface: plays
- Game interface → Round endpoints: starts rounds
- Play modes → Game interface: uses game state
- Round endpoints → Round engine: dispatches
- Round engine → Song pool: loads songs
lib/engine/roundEngine.ts - Game interface → Audio playback: controls audio
context/GameContext.tsx - Audio playback → Audio proxy: requests audio
hooks/useAudioController.ts - Song Guesser → Game interface: uses game state
- Daily play → Daily endpoints: loads challenge
- Daily endpoints → Daily engine: handles challenge
- Round engine → Daily engine: scopes daily player
lib/engine/roundEngine.ts - Daily play → Daily results: renders results
app/[locale]/daily/page.tsx - Leaderboard → Database service: reads and writes
- Catalog browsing → Game interface: sets filters
app/[locale]/categories/page.tsx - Artist view → Artist endpoints: requests artist data
- Artist endpoints → Artist services: delegates
app/api/artists/sync/route.ts - Artist services → Song pool: fetches songs
lib/engine/artistRoutes.ts - Artist services → iTunes ingestion: searches catalog
lib/engine/artistRoutes.ts - iTunes ingestion → iTunes API: fetches previews
- Song pool → Database service: loads catalog
lib/engine/songPool.ts - Player → Room interface: joins room
- Room interface → Room endpoints: controls room
- Room endpoints → Room service: delegates
app/api/rooms/route.ts - Room service → Room state: uses room store
lib/rooms/service.ts - Room service → Song pool: selects songs
lib/rooms/service.ts - Database service → Supabase storage: cloud persistence
lib/db.ts - Game interface → Local preferences: reads preferences
context/GameContext.tsx - Daily scheduler → Daily engine: creates daily set