JukeBox

JukeBox is a social media platform designed for music lovers to share, rate, and discover music. Built using modern web development frameworks, JukeBox integrates the Spotify API to enhance music discovery and provides a seamless, user-friendly experience.

---

Features

• Dynamic Music Reviews: Users can post reviews, rate albums, and interact with others' opinions.
• Spotify Integration: Search and explore music directly from Spotify's extensive library.
• User Authentication: Secure login and account management through Appwrite.
• Responsive Design: Optimized for desktop and mobile for an enhanced user experience.

---

Usage

1. Sign Up/Login: Create an account or log in securely using the Appwrite authentication system.
2. Discover Music: Search for tracks and albums directly via the Spotify API.
3. Write Reviews: Post your thoughts, rate music, and engage with other users.

---

Screenshots

Tech Stack

Frontend:

• React: A JavaScript library for building user interfaces.
• TailWind CSS: Ensures responsive and visually appealing design.

Backend:

• Appwrite: Manages database and user authentication.
• Spotify API: Powers music search and discovery features.

---

Installation

Prerequisites:

1. Node.js and npm installed.
2. An Appwrite instance set up.
3. Spotify API credentials (client ID and secret).

Steps:

1. Clone the repository:

   git clone https://github.com/not-finley/jukebox.git
   cd jukebox

2. Install dependencies:

   npm install

3. Configure environment variables: Create a .env file in the root directory with the following:

   REACT_APP_SPOTIFY_CLIENT_ID=your_spotify_client_id
   REACT_APP_SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
   REACT_APP_APPWRITE_ENDPOINT=your_appwrite_endpoint
   REACT_APP_APPWRITE_PROJECT_ID=your_appwrite_project_id

4. Start the development server:

   npm run dev

---

Roadmap

• Social Features: Follow your friends or other accounts and get updated on their activity.
• Personalized Recommendations: Explore music tailored to your preferences.
• Playlist Sharing: Allow users to create and share playlists, and import exsiting ones from spotify.
• Advanced Analytics: Provide insights into user listening trends. (Like Spotify wrapped but year round)

---

Contributing

I welcome contributions! Please follow these steps:

1. Fork the repository.
2. Create a new branch (feature/your-feature-name).
3. Commit your changes and push to your branch.
4. Open a pull request.

---

Acknowledgments

• Spotify API
• Appwrite
• React

---

Contact

For questions or feedback, feel free to reach out:

• Email: [email protected]
• GitHub: not-finley
• LinkedIn: Finley Harrison