Beatbox - Feel the Rhythm

Beatbox is a Spotify-inspired music streaming platform where artists can upload their own music and listen to their favorite tracks. This project combines the power of React and Flask to deliver a smooth music playback experience with full user authentication with playlist and album management.

Technologies Used

• Frontend: React with Vite for fast, modern frontend development.
• State Management: Redux for global state management.
• Backend: Flask for handling server-side logic and API requests.
• ORM: SQLAlchemy for robust and easy-to-use object-relational-mapping.
• Database: PostgreSQL for production and SQLite for development.

Local Development & Usage

Prerequisites

Ensure you have the following installed:

• Node.js (v18 or higher)
• npm (v9 or higher)
• Python (v3.9.4 or higher)
• PostgreSQL (v14 or higher)

1. Clone the Repository

git clone https://github.com/recondemon/Beatbox.git

2. Install Frontend Dependencies

cd react-vite && npm i

3. Set Up Backend

cp .env.example .env
pipenv install -r requirements.txt
pipenv shell
flask db upgrade
flask seed all

Note: You will have to add your own S3 bucket credentials to the .env file with the following keys:

• S3_BUCKET
• S3_SECRET
• S3_KEY

Running the Application

1. Set Up Database

pipenv run flask db upgrade && pipenv run flask db seed all

2. Start the Backend Server

pipenv run flask run

3. Start the Frontend Server

cd react-vite && npm run dev

4. Access the Application

Visit http://localhost:5173/ in your browser to start using Beatbox.