zimnickico / spotify-recommendations

The repository behind rects.app, the ultimate spotify-backed music recommendations.

Using Spotify Recommendations

All you need to do is head to https://rects.app/ and type in your favourite song(s) to get some recommendations. If you're interested in new features or would like to simply follow the development journey, please take a look at the Roadmap.

Deploying Your Own

You are also free to clone this repository and make any changes to personalize spotify-recommendations to your needs. The easiest way to do that is by following the guide below.

1. Clone the repository and run bun install inside the root directory to install the dependencies. Note: you're free to use any other package manager, but it might require additional setup.

2. Create a developer account at Spotify for Developers and create a new app.

3. Create a file called .env.local inside the root folder and populate it with your Client ID and Client Secret, as seen in .env.example

4. Run bunx vercel dev to run the project locally and tinker from there ;)

Tech Stack

• Bun - Package Manager
• Next.js - App Router and Server Actions
• Vercel - Hosting
• Spotify Web API - Recommendations Engine

Author(s)

Spotify Recommendations and the Rects app are solo-made by Krzysztof Zimnicki.

If you're interested in contributing, feel free to take a look at CONTRIBUTING.md or create a new issue.

spotify-recommendations's Issues

Comprehensive README