Real-time library seat availability for NIT Jalandhar
Never walk to the library to find it full again.
spotNITJ gives you live seat availability across the NIT Jalandhar library - from your phone, your home screen widget, or a notification. Built with a minimal, dark-first design.
| Low Availability | Med Availability | High Availability |
|---|---|---|
 |
 |
 |
- Live tracking - seat counts refresh in real time via the OpensourceNITJ/api
- Seat categories - view availability by section or floor
- Home screen widgets - glanceable Android widgets in multiple sizes
- Smart notifications - get alerted when seats open up in your preferred section
- Minimal UI - clean dark interface, nothing you don't need
- Lightweight - fast refresh, low battery impact
- Flutter SDK (3.x or later)
- Android Studio or VS Code with Flutter extension
- A device or emulator running Android 8.0+
# Clone the repo
git clone https://github.com/opensource-nitj/spotNITJ.git
cd spotNITJ
# Install dependencies
flutter pub get
# Run the app
flutter run| Layer | Technology |
|---|---|
| Framework | Flutter / Dart |
| Widgets | Android App Widgets (via home_widget) |
| Notifications | Flutter Local Notifications |
| Data | REST API (api.opensourcenitj.com) |
Contributions are welcome - bug fixes, new features, UI improvements, or documentation.
- Fork the repo
- Create a branch:
git checkout -b feature/your-feature - Commit your changes:
git commit -m 'Add some feature' - Push and open a Pull Request
For larger changes, please open an issue first to discuss the approach.
MIT License - see LICENSE for details.
Built with 💙 by students at NIT Jalandhar · OpenSource@NITJ