MusIQ is a modern, social-first music discovery and rating platform. Built with a native iOS experience and a robust TypeScript backend, it's designed for music lovers who want to track their taste and connect with a community that shares their passion.
- Rating Hub: Rate albums, songs, and artists on a scale of 1-10.
- Social Connectivity: Find friends, compare music tastes, and share your latest favorites.
- Live Updates: Get notified instantly about interactions and trending music.
Whether you're looking to contribute or just play around with the code, here's how to get MusIQ running locally.
- Frontend: Xcode (latest stable version)
- Backend: Node.js v18+ & PostgreSQL/Supabase
- Package Manager: npm or yarn
-
Clone the repository:
git clone https://github.com/aprameyak/MusIQ.git cd MusIQ -
Backend Setup:
cd backend npm install npm run dev -
Frontend Setup:
cd frontend
We love contributors! MusIQ is an open-source project and we welcome contributions of all kinds: from bug fixes and documentation to new features and UI improvements.
- Find an Issue: Browse our GitHub Issues
- Report Bugs: Found something wrong? Open an issue!
- Suggest Features: Have a great idea for MusIQ? Let us know.
Please read our Contributing Guidelines to get started.
MusIQ is released under the MIT License.
- Discussions: Use GitHub Discussions to ask questions and share ideas.
- Code of Conduct: We expect all participants to follow our Code of Conduct.