Skip to content

Get a personalized spotify playlist based on your current taste of music

License

Notifications You must be signed in to change notification settings

Dun-sin/HearItFresh

Repository files navigation

image

HearItFresh

Discover new tracks with Hear It Fresh! This user-friendly web app generates personalized Spotify playlists based on your favourite artists or a Spotify playlist link. Explore fresh music.

💫 Features

  • Authentication of users is carried out through Spotify Login.
  • Create new playlists using your favourite artists or an existing playlist
  • Get better results by changing the parameters to either getting a playlist of different artists opposite to your taste or get less popular artists
  • Your Spotify library will automatically receive newly added playlists.

👨‍💻 Usage

To use HearItFresh, simply navigate to the website and LogIn using your spotify account. Once logged in, you can create new playlists based on your favourite artists or based on a existing spotify playlist.

👥 Contributing

Contributions to HearItFresh are welcome! If you find a bug or have a feature request, please create an issue in the GitHub repository. If you would like to contribute code, please follow these steps:

  • Take a look at the existing Issues or create a new issue!
  • Fork the Repo. Then, create a branch for any issue that you are working on. Finally, commit your work.
  • Create a Pull Request (PR), which will be promptly reviewed and given suggestions for improvements by the community.
  • Add screenshots or screen captures to your Pull Request to help us understand the effects of the changes proposed in your PR.

Please ensure that your code follows the project's coding conventions and has adequate test coverage.

⚒️ Installation

  • To begin, create a copy of the HearItFresh repository by forking it.Click on the Fork symbol at the top right corner.
  • Clone your new fork of the repository in the terminal/CLI on your computer with the following command:
    git clone https://github.com/<your-github-username>/HearItFresh
  • Navigate to the newly created HearItFresh project directory:
    cd HearItFresh
  • Install the dependencies
    npm install && npm install -g commitizen
    
  • Run the project
    npm run dev
    

🛡️ License

HearItFresh is licensed under the MIT License.

🤝 Support

If you liked the project, please consider giving it a ⭐️