beradeep / CollegeSearch

Android app for college search. Built using Jetpack, MVVM and Hilt.
https://github.com/beradeep/CollegeSearch/releases/download/v3.0/app-release.apk
MIT License
10 stars 2 forks source link
android android-app college jee kotlin kotlin-android university up-for-grabs

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 โœจ

  • [x] Free to use, no login, no sign up required. ๐Ÿ†“
  • [x] All kinds of filters, sorts to play with and decide your ideal college. ๐Ÿซ
  • [x] Takes into consideration, all the criteria & reservations- rank, sex, caste etc. ๐Ÿš€
  • [x] Get cutoffs for any branch in any IIT, NIT or GFTI individually. ๐Ÿ“„
  • [x] Dark and light modes. ๐ŸŒ“
  • [x] 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
  8. 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 :star: if you liked it!