Skip to content

Client side of web app based on Spotify's API that tracks user's top songs and artists in specif period of times. Built using React with Vite, you can find the backend in https://github.com/Chibah-Fawzi/SFS-SERVER.

Notifications You must be signed in to change notification settings

Chibah-Fawzi/SFS-CLIENT

Repository files navigation

StatsForSpotify

StatsForSpotify is a web app that uses the Spotify API to deliver personalized music insights. Instantly view your top artists, tracks, and genres—with rich visualizations—based on your Spotify listening history.

Features

  • Spotify Login & Authorization
    • Secure OAuth integration—private and safe.
  • Top Artists & Songs
    • Shows your most-listened artists and tracks by customizable time frames (last month, 6 months, all-time).
  • Top Genres
    • Ranks your favorite musical genres using official Spotify metadata.
  • Data Visualization
    • Charts and lists to present key statistics in a friendly UI.
  • Intuitive UI
    • Responsive, clean design for desktop and mobile.

How It Works

StatsForSpotify connects to the Spotify Web API using OAuth2 login. After authentication, it fetches top tracks, artists, and genres from your listening history, then analyzes and displays the data with interactive charts and lists. Insights update automatically as you continue listening on Spotify.

Technologies

  • Frontend: React.js, Tailwind CSS
  • Backend: Node.js
  • Auth: Spotify OAuth 2.0
  • Data: Spotify Web API

Getting Started

  1. Clone the repository
    git clone https://github.com/Chibah-Fawzi/SFS-CLIENT.git
  2. Install dependencies
    npm install
  3. Set up Spotify Developer credentials
  4. Run the development server
    npm start
  5. Visit the local site and log in with Spotify to see your stats.

Description

StatsForSpotify provides an instant overview of your Spotify listening habits. View your overall top songs, artists, and genres, compare across timeframes, and share results. Your data is fetched securely from Spotify and not stored on external servers.

License

MIT

About

Client side of web app based on Spotify's API that tracks user's top songs and artists in specif period of times. Built using React with Vite, you can find the backend in https://github.com/Chibah-Fawzi/SFS-SERVER.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published