How comp426-25f/final-project-team-6 works
Echo is a private-room music listening app. Users sign up or log in, create or join a room, then share synchronized playback and manage its song queue; room members can also request AI song suggestions. The graph covers the documented product stages and the sampled tRPC, database, and realtime layers. Several feature implementations are unsampled, so their internal calls are not inferred; documented capabilities are shown without inventing backend wiring.
Main entry points: root.ts Router registry · queue.tsx Queue controls · app-sidebar.tsx Room navigation · api.ts Typed API client
Components 21
User experience
- Sign in and signup
pages/login.tsx - Room view
pages/[roomId].tsx - Room navigation
components/sidebar/app-sidebar.tsx - Profile controls
components/sidebar/nav-user.tsx - Profile avatar
components/profile/profile-avatar.tsx
Room and music
- Synchronized player
components/song-player/song-player.tsx - Queue controls
components/queue/queue.tsx - AI song search
utils/openai/client.ts
API and domain
- Typed API client
utils/trpc/api.ts - tRPC endpoint
pages/api/trpc/[trpc].ts - Auth context
server/api/trpc.ts - Router registry
server/api/root.ts - Room operations
server/api/routers/rooms.ts - Queue operations
server/api/routers/queues.ts - Song operations
server/api/routers/songs.ts - Profile operations
server/api/routers/profiles.ts
Identity and data
- Database access
server/db/index.ts - Room and song schema
server/db/schema.ts - Supabase authentication
- Avatar storage
utils/supabase/storage.ts
Other components
- Listener
Connections 24
- Listener → Sign in and signup: signs in
- Listener → Room navigation: creates or joins
- Listener → Queue controls: manages queue
- Listener → Synchronized player: controls playback
- Listener → AI song search: requests suggestions
- Sign in and signup → Supabase authentication: authenticates
- Room navigation → Avatar storage: uploads room avatar
components/sidebar/app-sidebar.tsx - Room view → Synchronized player: renders
pages/[roomId].tsx - Room view → Queue controls: renders
pages/[roomId].tsx - Queue controls → Typed API client: mutates queue
components/queue/queue.tsx - Queue controls → Supabase authentication: subscribes to changes
components/queue/queue.tsx - Room navigation → Typed API client: uses API
components/sidebar/app-sidebar.tsx - Typed API client → Router registry: types routes
utils/trpc/api.ts - tRPC endpoint → Router registry: serves router
pages/api/trpc/[trpc].ts - tRPC endpoint → Auth context: creates context
pages/api/trpc/[trpc].ts - Auth context → Supabase authentication: checks claims
server/api/trpc.ts - Router registry → Room operations: registers
server/api/root.ts - Router registry → Queue operations: registers
server/api/root.ts - Router registry → Song operations: registers
server/api/root.ts - Router registry → Profile operations: registers
server/api/root.ts - Room operations → Database access: queries
server/api/routers/rooms.ts - Database access → Room and song schema: configures ORM
server/db/index.ts - Profile controls → Profile avatar: renders
components/sidebar/nav-user.tsx - Profile controls → Avatar storage: uploads avatar
components/sidebar/nav-user.tsx