🎵 Tuneflow – A Full-Stack Music Streaming Web App
Tuneflow is a Spotify-inspired full-stack music streaming platform built with the MERN stack. It allows users to stream songs, explore albums, create playlists, and listen to podcasts — all through a sleek and responsive UI.
🚀 Features
🎶 Music Streaming – Play/pause, next/previous, and seek functionality
📀 Albums & Songs – Explore and stream songs within albums
🎧 Playlists – Create, manage, and play personal playlists
🎙 Podcasts – Browse and stream podcast episodes
👩💻 Admin Dashboard – Upload and manage songs, albums, and podcasts
☁️ Cloudinary Integration – Store & fetch audio and images securely
📱 Responsive Design – Optimized for desktop and mobile
🔗 RESTful APIs – For songs, albums, playlists, and podcasts
🛠 Tech Stack
Frontend: React.js, React Router, Tailwind CSS, Context API Backend: Node.js, Express.js Database: MongoDB Storage: Cloudinary Others: Axios, Nodemon, dotenv
📂 Project Structure tuneflow/ │── backend/ # Express server, routes, controllers, models │── frontend/ # React frontend (components, context, pages) │── public/ # Static files & outputs │── .env # Environment variables │── package.json # Dependencies & scripts
⚡ Getting Started 1️⃣ Clone the repository git clone https://github.com/yourusername/tuneflow.git cd tuneflow
2️⃣ Backend Setup cd backend npm install npm run server
3️⃣ Frontend Setup cd frontend npm install npm run dev
4️⃣ Environment Variables (.env) MONGO_URI=your_mongodb_connection_string CLOUDINARY_NAME=your_cloudinary_name CLOUDINARY_API_KEY=your_cloudinary_api_key CLOUDINARY_API_SECRET=your_cloudinary_api_secret PORT=4000
📸 Screenshots
📌 Future Enhancements
🔍 Search functionality for songs, albums & podcasts
❤️ Like/Save songs to favorites
📊 Personalized recommendations
🌐 Deploy with CI/CD
🤝 Contributing
Contributions are welcome! Feel free to fork the repo and create a pull request.