A powerful android app for searching and deciding the right engineering college for you in India.

• Free to use, no login, no sign up required. 🆓
• All kinds of filters, sorts to play with and decide your ideal college. 🏫
• Takes into consideration, all the criteria & reservations- rank, sex, caste etc. 🚀
• Get cutoffs for any branch in any IIT, NIT or GFTI individually. 📄
• Dark and light modes. 🌓
• Single activity design.

1. Clone the project
2. Open Android Studio IDE
3. Go to File » New » Project from VCS
4. Paste https://github.com/beradeep/CollegeSearch.git
5. Open the project
6. Grab your YOUR_API_KEY from https://api-ninjas.com
7. Now, in your local.properties add the block

   API_KEY_QUOTES = YOUR_API_KEY
   API_KEY_CUTOFF = 1a5d601cf60cda365cf2

8. Build and run

• Kotlin - First class and official programming language for Android development.
• Coroutines - For asynchronous calls and tasks to utilize threads.
• Jetpack Compose UI Toolkit - Modern UI development toolkit.
• Android Architecture Components - Collection of libraries that help you design robust, testable, and maintainable apps.
  • ViewModel - Stores UI-related data that isn't destroyed on UI changes.
  • StateFlow and SharedFlow - StateFlow and SharedFlow are Flow APIs that enable flows to optimally emit state updates and emit values to multiple consumers.
• Dependency Injection -
  • Dagger-Hilt - A standard way to incorporate Koin dependency injection into an Android application.
  • Hilt-ViewModel - DI for injecting ViewModel.
• Material Components for Android - Modular and customizable Material Design UI components for Android.

This app uses MVVM(Model View View-Model) and Clean architecture.

Contributions are always welcome. Feel free to make a pull request. Thanks to all the future contributors!

Highly appreciate leaving a ⭐ if you liked it!