Skip to content

beradeep/CollegeSearch

Repository files navigation

JoSAA Made Easy - College Search

API Kotlin Jetpack Compose

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

You just enter your JEE SCORE/RANK and boom, you get all the recommended colleges you can get into.

Installation ⬇️

Get it on GitHub

Features ✨

  • 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.

Building 🏗️

  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
  1. Build and run

Tech Stack 🛠

Architecture 👷‍♂️

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

Contributing 🤝

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!