Alternify

Find Alternatives to your Spotify Tracks & share them with your friends!

https://github.com/user-attachments/assets/9a50901d-3e72-4977-a913-651c92c76fc2

🛠️ Stack

• Astro - Web framework for content-driven websites.
• Typescript - JavaScript with syntax for types.
• Tailwindcss - A utility-first CSS framework for rapidly building custom designs.
• Vercel - Provides the developer tools and cloud infrastructure.
• Flask - A lightweight WSGI web application framework.
• Spotify API - Web API that provides access to Spotify music catalog.
• Astro DB - fully managed SQL database.
• svgl - Beautiful library with SVG logos.

🚀 Quick start (Frontend)

1. Fork this repository and clone it locally:

git clone [email protected]:your_username/alternify.git

2. Go to the frontend/ folder and follow next steps.

3. Install dependencies:

# Install dependencies:
npm install

# Start the development server:
npm run dev

🚀 Quick start (Backend)

1. Go to the api/ folder and follow next steps.

2. Create a virtual environment:

# activate the virtual environment
# Windows
venv\Scripts\activate
# Unix
source venv/bin/activate

3. Install dependencies:

# Install dependencies:
pip install -r requirements.txt

# Start the development server:
python main.py

4. Create a .env file in the root of the project and add the following variables (check the .env.example file):

# Get your client id and secret from https://developer.spotify.com
SPOTIFY_CLIENT_ID=
SPOTIFY_CLIENT_SECRET=
# Get your client id and secret from https://developer.tidal.com
TIDAL_CLIENT_ID=
TIDAL_CLIENT_SECRET=
# Get your Astro Studio app token from https://studio.astro.build
ASTRO_STUDIO_APP_TOKEN=

🔑 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Want to contribute? Open an issue with your proposal ✨ (soon we will have a contributing guide).