---

🌱 Open Source & Community Driven

Songify is an open-source project built by developers for music enthusiasts. Whether you are an experienced Flutter developer or making your very first open-source pull request, your contributions, ideas, and feedback are warmly welcomed!

We welcome help across all areas:

• 🐛 Bug Fixes — Squashing bugs and fixing edge cases
• 🎨 UI/UX Improvements — Refining layouts, themes, and micro-interactions
• ✨ New Features — Building useful player tools and controls
• 📝 Documentation — Improving guides, setup steps, and code comments
• 🧪 Testing — Testing across different Android devices and screen resolutions
• ⚡ Performance — Optimizing memory usage, speed, and audio streaming
• 💡 Ideas & Feedback — Suggesting new ideas and reporting problems

New to open source? That's completely okay. We love supporting first-time contributors! Look for issues tagged with good first issue and help wanted to get started with confidence.

---

📖 About

Songify is a music streaming application built with Flutter, created to explore how a modern music player can be designed and developed without the interruptions of traditional ad-supported streaming.

The project focuses on delivering a clean, simple, and personalized listening experience while providing hands-on experience with mobile development, external APIs, UI/UX design, and scalable application architecture.

💡 Why I Built It

I started Songify because I wanted a music experience without constant interruptions from ads.

Instead of simply complaining about it, I decided to build my own solution and use the project as an opportunity to learn, experiment, and improve my development skills.

---

✨ Features

• 🎵 Ad-free music listening experience — Enjoy uninterrupted playback
• 🔎 Search — Search for songs, artists, and albums
• 🎧 Music playback and controls — Seamless audio streaming and playback controls
• ❤️ Personalized music experience — Tailored recommendations and quick access
• 📱 Built with Flutter — Cross-platform mobile foundation
• 🎨 Clean and simple UI — Intuitive, minimalist user interface
• ⚡ Fast and responsive — Smooth navigation and quick loading

Features may change as the project continues to evolve.

---

📸 Screenshots

---

🤝 Contributing

Songify is open source, and contributions are welcome! 🚀

Whether you want to add new capabilities, resolve a bug, refine the interface, or improve documentation, every contribution helps make Songify better for everyone.

Contributors can help with:

• 🚀 Features — New player functionality and tools
• 🐛 Bug Fixes — Squashing bugs and fixing edge cases
• 🎨 UI/UX — Visual polish and responsive design
• 📝 Documentation — Clearer guides and code documentation
• 🧪 Testing — Device testing and test cases
• ⚡ Performance — Speed, memory, and audio streaming optimizations
• 💡 Ideas — Feature proposals and architectural suggestions

🌱 Contributing for Beginners

New to open source or Flutter? Songify is a beginner-friendly project where you can learn the open-source workflow step by step.

Check out our beginner-friendly issues on GitHub:

• good first issue
• help wanted

Quick Contribution Workflow

1. ⭐ Star the repository to support the project and follow updates
2. 🍴 Fork the repository to your personal GitHub account
3. 📥 Clone your fork locally:

   git clone https://github.com/YOUR-USERNAME/Songify.git
   cd Songify
   

4. 🌿 Create a new branch for your work:

   git checkout -b feature/your-feature-name
   

5. 🛠️ Make your changes cleanly and follow project structure
6. 🧪 Test your changes:

   flutter analyze
   flutter run
   

7. 📤 Push your branch to your fork:

   git push origin feature/your-feature-name
   

8. 🔄 Open a Pull Request against the main branch with a clear description of your work

👉 Read the Full Contribution Guide (CONTRIBUTING.md)

🐛 Looking for something to work on?

Start with our beginner-friendly issues:

👉 Good First Issues

If you're unsure where to start, feel free to open an issue or ask in the discussion.

---

🚀 Getting Started

Follow these steps to get Songify running on your local development machine.

Prerequisites

Before running Songify locally, make sure you have:

• Flutter (SDK) installed
• Dart installed
• Git installed
• An Android device (with USB debugging enabled) or an Android emulator

Installation

1. Clone the repository:

   git clone https://github.com/Alisonpinto/Songify.git
   cd Songify
   

2. Install dependencies:

   flutter pub get
   

3. Run the application:

   flutter run
   

---

🛠️ Tech Stack

• Flutter — Mobile application development framework
• Dart — Core application programming language
• JioSaavn unofficial endpoints — Music data and audio streaming endpoints
• Vercel — Project website hosting

---

📌 Project Status

Songify is an independent learning and portfolio project that is actively being maintained and improved.

• It is completely open source and community-driven.
• The project may contain experimental features, unofficial integrations, and ongoing architectural changes.
• Breaking changes may occur as development continues.

---

👥 Contributors

Songify is built and improved by people who contribute code, ideas, design, testing, documentation, and feedback.

A heartfelt thanks to everyone who helps make Songify better!

👉 View Contributors

---

⚠️ Disclaimer

Songify is strictly an educational and portfolio project. It is not intended for commercial use, monetization, or public distribution.

• Songify does not host or own any music content made available through the application.
• All music, audio streams, artwork, metadata, lyrics, and artist information remain the intellectual property of their respective copyright holders.
• The application uses unofficial endpoints for educational purposes and is not affiliated with, endorsed by, or sponsored by JioSaavn.
• Please respect applicable copyright laws and terms of service in your region.

---

📄 License

This project is intended for educational and portfolio purposes.

See the repository's LICENSE file for the applicable terms.

---

📬 Contact

• Project Owner: Alison Pinto — alisonpinto955@gmail.com
• Co-Creator: Praful Mohite — prafulmohite2006@gmail.com

---