How moses-tec/spotify-clone works
This is a Spotify-style music streaming application with album and song browsing, playback, chat, authentication, and an admin catalog. Users enter through the routed frontend; authenticated sessions initialize API credentials and chat connectivity, while the backend exposes catalog, user, admin, and statistics routes. Admins can upload songs and albums, and backend controllers persist catalog data and retrieve statistics. The source index supports the cited module relationships; frontend-to-API calls and some unsampled feature internals are not shown, so those links are omitted.
Main entry points: App.tsx App routes · index.js HTTP server · admin.controller.js Catalog management · song.model.js Song records
Components 29
Client experience
- App routes
frontend/src/App.tsx - Home discovery
frontend/src/pages/home/HomePage.tsx - Album view
frontend/src/pages/album/AlbumPage.tsx - Playback controls
frontend/src/layout/components/PlaybackControls.tsx - Main layout
frontend/src/layout/MainLayout.tsx
Identity and chat
- Chat page
frontend/src/pages/chat/ChatPage.tsx - Chat user list
frontend/src/pages/chat/components/UsersList.tsx - Auth provider
frontend/src/providers/AuthProvider.tsx - Auth state
frontend/src/stores/useAuthStore.ts - Chat state
frontend/src/stores/useChatStore.ts - User and messages
backend/src/controller/user.controller.js - Realtime socket
backend/src/lib/socket.js
Catalog and administration
- Admin console
frontend/src/pages/admin/AdminPage.tsx - Song queries
backend/src/controller/song.controller.js - Album queries
backend/src/controller/album.controller.js - Catalog management
backend/src/controller/admin.controller.js - Catalog statistics
backend/src/controller/stat.controller.js
Backend runtime and data
- HTTP server
backend/src/index.js - Song routes
backend/src/routes/song.route.js - Album routes
backend/src/routes/album.route.js - Admin routes
backend/src/routes/admin.route.js - Song records
backend/src/models/song.model.js - Album records
backend/src/models/album.model.js - User records
backend/src/models/user.model.js - Message records
backend/src/models/message.model.js
Other components
- Listener
- Cloudinary
- Clerk identity
- MongoDB
Connections 34
- Listener → App routes: uses
frontend/src/App.tsx - App routes → Home discovery: routes to
frontend/src/App.tsx - App routes → Album view: routes to
frontend/src/App.tsx - App routes → Chat page: routes to
frontend/src/App.tsx - App routes → Admin console: routes to
frontend/src/App.tsx - App routes → Main layout: wraps
frontend/src/App.tsx - Main layout → Playback controls: renders
frontend/src/layout/MainLayout.tsx - Chat page → Chat user list: renders
frontend/src/pages/chat/ChatPage.tsx - Auth provider → Auth state: checks admin
frontend/src/providers/AuthProvider.tsx - Auth provider → Chat state: starts socket
frontend/src/providers/AuthProvider.tsx - Auth provider → Clerk identity: gets token
frontend/src/providers/AuthProvider.tsx - HTTP server → Song routes: mounts routes
backend/src/index.js - HTTP server → Album routes: mounts routes
backend/src/index.js - HTTP server → Admin routes: mounts routes
backend/src/index.js - Song routes → Song queries: dispatches
backend/src/routes/song.route.js - Album routes → Album queries: dispatches
backend/src/routes/album.route.js - Admin routes → Catalog management: dispatches
backend/src/routes/admin.route.js - Song queries → Song records: queries
backend/src/controller/song.controller.js - Album queries → Album records: queries
backend/src/controller/album.controller.js - Catalog management → Song records: writes
backend/src/controller/admin.controller.js - Catalog management → Album records: writes
backend/src/controller/admin.controller.js - Catalog management → Cloudinary: uploads media
backend/src/controller/admin.controller.js - Catalog statistics → Song records: counts and aggregates
backend/src/controller/stat.controller.js - Catalog statistics → Album records: counts and aggregates
backend/src/controller/stat.controller.js - Catalog statistics → User records: counts
backend/src/controller/stat.controller.js - User and messages → User records: queries
backend/src/controller/user.controller.js - User and messages → Message records: queries
backend/src/controller/user.controller.js - HTTP server → Realtime socket: initializes
backend/src/index.js - Realtime socket → Message records: uses
backend/src/lib/socket.js - HTTP server → MongoDB: connects
backend/src/index.js - Song records → MongoDB: stores records
- Album records → MongoDB: stores records
- User records → MongoDB: stores records
- Message records → MongoDB: stores records