Spot-A-Song

An intelligent algorithm that enables users to create awesome playlists based on a song.

Website live at: https://spot-a-song.com/

App Screenshots

Home	Login	Playlist	Playlist Modal

Spotify	Profile	Playlists	And More!

Features

• You can create a playlist based on a song
• You can listen to song previews
• You can re-arrange and modify your playlist to your liking
• You can give your new playlist a name and save it to your Spotify account
• You can reference the playlists you've created any time in your playlists section
• You can view other features like top tracks in the app home

Quickstart

React Frontend

Run the following commands to bootstrap your environment

git clone https://github.com/Polvyer/Spot-A-Song.git
cd Spot-A-Song/react-frontend
npm install

To run the web application use:

npm start

Flask Backend

Before running shell commands, set the FLASK_APP and FLASK_DEBUG environment variables

export FLASK_APP=/path/to/spot-a-song.py
export FLASK_DEBUG=1

Then run the following commands to bootstrap your environment

git clone https://github.com/Polvyer/Spot-A-Song.git
cd Spot-A-Song/flask-backend
pip install -r requirements.txt

Run the following commands to create your app's database tables and perform the initial migration

flask db init
flask db migrate
flask db upgrade

To run the web application use:

flask run

Shell

To open the interactive shell, run

flask shell

By default, you will have access to the flask app and models.

Migrations

Whenever a database migration needs to be made. Run the following commands

flask db migrate

This will generate a new migration script. Then run

flask db upgrade

To apply the migration.

For a full migration command reference, run flask db --help.