How aniket-314/soundcloud-music-app works
This is a SoundCloud music-streaming web app. Users authenticate, discover tracks, artists, and playlists, then play tracks, manage a queue, and maintain liked and recently played music. The graph highlights routing, authentication, discovery, library state, and playback. Evidence is limited to the README, source index, and sampled excerpts; unsampled page behavior and integrations are not inferred beyond indexed references.
Main entry points: App.tsx App routes · soundcloud.ts SoundCloud API · PlayerBar.tsx Player bar · Search.tsx Search
Components 26
App and navigation
- App routes
src/App.tsx - App layout
src/components/layout/AppLayout.tsx
Identity and library
- Authentication state
src/contexts/AuthContext.tsx - Login button
src/components/LoginButton.tsx - Library state
src/contexts/LibraryContext.tsx - OAuth callback
src/pages/Callback.tsx
Music discovery
- Home
src/pages/Home.tsx - Search
src/pages/Search.tsx - Library page
src/pages/Library.tsx - Liked songs
src/pages/LikedSongs.tsx - Playlist detail
src/pages/PlaylistDetail.tsx - Artist detail
src/pages/ArtistDetail.tsx - Track row
src/components/cards/TrackRow.tsx - Artist card
src/components/cards/ArtistCard.tsx - Playlist card
src/components/cards/PlaylistCard.tsx
Playback
- Player state
src/contexts/PlayerContext.tsx - Player bar
src/components/layout/PlayerBar.tsx - Player controls
src/components/player/PlayerControls.tsx - Progress bar
src/components/player/ProgressBar.tsx - Volume slider
src/components/player/VolumeSlider.tsx - Queue panel
src/components/player/QueuePanel.tsx
SoundCloud integration
- SoundCloud API
src/lib/soundcloud.ts - OAuth helpers
src/lib/soundcloudAuth.ts
Other components
- Listener
- SoundCloud service
- Browser audio
Connections 35
- Listener → App routes: opens
src/App.tsx - App routes → App layout: routes through
src/App.tsx - App routes → Home: routes to
src/App.tsx - App routes → Search: routes to
src/App.tsx - App routes → Library page: routes to
src/App.tsx - App routes → Playlist detail: routes to
src/App.tsx - App routes → Artist detail: routes to
src/App.tsx - App routes → Liked songs: routes to
src/App.tsx - App routes → OAuth callback: routes to
src/App.tsx - App routes → Authentication state: provides
src/App.tsx - Login button → Authentication state: invokes login
src/components/LoginButton.tsx - Authentication state → OAuth helpers: exchanges code
src/contexts/AuthContext.tsx - Authentication state → SoundCloud API: fetches profile
src/contexts/AuthContext.tsx - OAuth helpers → SoundCloud service: authenticates with
- SoundCloud API → SoundCloud service: requests data
src/lib/soundcloud.ts - Search → SoundCloud API: searches catalog
src/pages/Search.tsx - Search → Track row: renders tracks
src/pages/Search.tsx - Search → Artist card: renders artists
src/pages/Search.tsx - Search → Playlist card: renders playlists
src/pages/Search.tsx - Library page → Library state: uses library state
src/pages/Library.tsx - Liked songs → SoundCloud API: loads liked tracks
src/pages/LikedSongs.tsx - Playlist detail → SoundCloud API: loads playlist
src/pages/PlaylistDetail.tsx - Artist detail → SoundCloud API: loads artist data
src/pages/ArtistDetail.tsx - Home → Library state: uses library state
src/pages/Home.tsx - Track row → Player state: starts playback
src/components/cards/TrackRow.tsx - Track row → Library state: toggles likes
src/components/cards/TrackRow.tsx - Library state → Authentication state: reads token
src/contexts/LibraryContext.tsx - Library state → SoundCloud API: updates favorites
src/contexts/LibraryContext.tsx - Player state → SoundCloud API: resolves stream
src/contexts/PlayerContext.tsx - Player state → Browser audio: plays stream
src/contexts/PlayerContext.tsx - Player bar → Player state: reads playback state
src/components/layout/PlayerBar.tsx - Player bar → Player controls: renders controls
src/components/layout/PlayerBar.tsx - Player bar → Progress bar: renders progress
src/components/layout/PlayerBar.tsx - Player bar → Volume slider: renders volume
src/components/layout/PlayerBar.tsx - Player bar → Queue panel: renders queue
src/components/layout/PlayerBar.tsx