How kaierhyeh/music-room works
MusicRoom is a collaborative music platform for live track-voting events and shared playlists, with accounts, friends, Google sign-in, and subscription tiers. Users enter through the mobile/web app, authenticate, then use social and music features backed by a Go API and PostgreSQL. The diagram preserves the documented feature branches, while sampled source confirms only selected client and server connections; dashed links mark documented but unsampled client-to-API interactions.
Main entry points: router.go Route wiring · client.ts API client · events Event screens · App.tsx App entry
Components 26
App Experience
- App entry
musicroom-app/App.tsx - Auth navigation
musicroom-app/src/navigation/AuthNavigator.tsx - Auth session
musicroom-app/src/context/AuthContext.tsx
Social Features
- Friend screens
musicroom-app/src/screens/friends - Profile screens
musicroom-app/src/screens/profile - Friend service
musicroom-backend/internal/service/friend.go - User service
musicroom-backend/internal/service/user.go
Music Collaboration
- Event screens
musicroom-app/src/screens/events - Playlist screens
musicroom-app/src/screens/playlists - Track previews
musicroom-app/src/audio/usePreviewPlayer.ts - Event service
musicroom-backend/internal/service/event.go - Playlist service
musicroom-backend/internal/service/playlist.go
API Services
- HTTP server
musicroom-backend/cmd/server/main.go - Route wiring
musicroom-backend/internal/api/router.go - Account service
musicroom-backend/internal/service/auth.go - Subscription service
musicroom-backend/internal/service/subscription.go - HTTP handlers
musicroom-backend/internal/api/handlers
State and Integrations
- API client
musicroom-app/src/api/client.ts - Token storage
musicroom-app/src/storage/storage.ts - SQL repository
musicroom-backend/internal/repository - Realtime hub
musicroom-backend/internal/hub/hub.go - Deezer integration
musicroom-backend/internal/deezer/client.go - Email delivery
musicroom-backend/internal/mail/mail.go - Google OAuth
musicroom-backend/internal/auth/googleoauth.go
Other components
- MusicRoom user
- MusicRoom API
Connections 27
- MusicRoom user → App entry: uses
- App entry → Auth session: provides auth
musicroom-app/App.tsx - App entry → Auth navigation: mounts navigation
- Auth session → API client: calls auth APIs
musicroom-app/src/context/AuthContext.tsx - Auth session → Token storage: stores tokens
musicroom-app/src/context/AuthContext.tsx - Event screens → API client: requests event data
- Event screens → Track previews: plays previews
musicroom-app/src/screens/events/EventDetailScreen.tsx - Event screens → Realtime hub: receives updates
- Playlist screens → API client: requests playlist data
- Friend screens → API client: requests friend data
- Profile screens → API client: requests profile data
- API client → Token storage: reads tokens
musicroom-app/src/api/client.ts - API client → MusicRoom API: sends requests
- HTTP server → Route wiring: creates router
musicroom-backend/cmd/server/main.go - Route wiring → HTTP handlers: registers routes
musicroom-backend/internal/api/router.go - Route wiring → Account service: constructs service
musicroom-backend/internal/api/router.go - Route wiring → Event service: constructs service
musicroom-backend/internal/api/router.go - Route wiring → Playlist service: constructs service
musicroom-backend/internal/api/router.go - Route wiring → Friend service: constructs service
musicroom-backend/internal/api/router.go - Route wiring → User service: constructs service
musicroom-backend/internal/api/router.go - Route wiring → Subscription service: constructs service
musicroom-backend/internal/api/router.go - Route wiring → SQL repository: creates queries
musicroom-backend/internal/api/router.go - Route wiring → Realtime hub: creates hub
musicroom-backend/internal/api/router.go - Route wiring → Deezer integration: creates client
musicroom-backend/internal/api/router.go - Route wiring → Email delivery: creates mailer
musicroom-backend/internal/api/router.go - Route wiring → Google OAuth: creates OAuth flow
musicroom-backend/internal/api/router.go - MusicRoom API → Route wiring: routes requests