SoundScore

🎵 Rate, Share, and Discover Music

A modern web application for music enthusiasts to rate albums, share their musical journey, and connect with like-minded listeners.

✨ Features

• 🎧 Spotify Integration: Seamlessly connect with your Spotify account
• 📊 Album Ratings: Rate and review your favorite albums
• 🔍 Smart Discovery: Get personalized album recommendations
• 👥 Social Features: Connect with friends and share your music taste
• 📱 Responsive Design: Beautiful interface on any device
• 🌙 Dark Mode: Easy on the eyes, perfect for night listening sessions

🖼️ Screenshots

Main Features

Album Experience

User Features

Social Features

Additional Features

🚀 Getting Started

Prerequisites

• Node.js (v14 or higher)
• MongoDB
• Spotify Developer Account

Installation

1. Clone the repository:

git clone https://github.com/yourusername/SoundScore.git
cd SoundScore

2. Install dependencies:

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

3. Set up environment variables:

# Backend (.env)
MONGODB_URI=your_mongodb_uri
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
JWT_SECRET=your_jwt_secret

# Frontend (.env)
REACT_APP_API_URL=http://localhost:5000

4. Start the development servers:

# Start backend server
cd backend
npm run dev

# Start frontend server (in a new terminal)
cd frontend
npm start

🛠️ Tech Stack

Frontend

• React.js
• Framer Motion
• Tailwind CSS
• Axios

Backend

• Node.js
• Express.js
• MongoDB
• JWT Authentication

APIs

• Spotify Web API
• Last.fm API (for additional music data)

📱 Key Features Breakdown

Album Discovery

• Personalized recommendations based on listening history
• Trending albums in your network
• New releases from favorite artists

Rating System

• Half-star rating system (0.5 to 5 stars)
• Detailed review support
• Rating history and statistics

Social Features

• Follow other music enthusiasts
• Share ratings and reviews
• Collaborative playlists
• Activity feed

Profile Customization

• Listening statistics
• Rating distribution
• Favorite genres
• Custom lists and collections

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

• Spotify Web API
• Last.fm API
• Tailwind CSS
• Framer Motion

---

_{Built with ❤️ by music lovers, for music lovers.}