BusBuddy

One platform, three apps — live school-bus tracking for administrators, parents, and drivers.

---

🚀 Overview

BusBuddy is a Flutter app that turns a single sign-in into the right experience for each person who touches the school run. One login resolves the user's role and routes them to one of three purpose-built apps — an Admin fleet console, a Parent tracker, and a Driver companion — all sharing one Firebase backend, one typed data layer, and a polished light/dark design system.

Role	App	Accent	What they do
🛡️ Administrator	Admin	Indigo	Manage buses, drivers, students, routes & assignments; watch the whole fleet live; read attendance/occupancy reports
👨‍👩‍👧 Parent / Student	Parent	Mint	Track their bus live with ETA & next stop, see the driver & route, get notifications
🧑‍✈️ Driver	Driver	Amber	Follow the route & stops, broadcast live location, mark attendance with a QR scan

How it works: a user's Firestore level (1 = Admin, 2 = Parent, 3 = Driver) drives appForRole(...) after login, so each role only ever sees its own app.

At a glance: 3 role-based apps · ~39 screens · one shared Firebase backend & typed data layer · 204 tests · full light & dark.

---

✨ Features

• 📍 Live GPS tracking — real-time bus positions on an OpenStreetMap map (flutter_map), with theme-aware tiles, route polylines, stop markers and staleness indicators.
• 🧭 Route & stop progress — per-stop reached / next / upcoming status with a visual timeline and progress bar.
• 📷 QR attendance — drivers mark students present by scanning a code.
• 🔔 Push notifications — broadcast and per-role messages (Firebase Messaging + OneSignal).
• 📊 Reports & analytics — fleet occupancy, attendance rate and per-route breakdowns with charts (fl_chart).
• 🌓 Light & dark mode — every screen, in all three apps, via ThemeExtension palettes + a shared ThemeController.
• 🔐 Role-based access — one branded login, three role-gated apps.
• 📥 Data export — admins can download fleet/attendance data.
• ⚡ Offline-aware — Firestore persistence and streams hoisted out of build() for smooth performance.

---

🔑 Login

A single branded login (brand blue #2563EB, light & dark) is the entry point for all three roles.

  

---

📱 The apps

🛡️ Admin — fleet console (indigo)

Manage the entire operation: buses, drivers, students, routes, contacts and assignments; watch every bus live on one map; and read attendance & occupancy reports.

Home — light	Home — dark	Live tracking	Reports

All Admin screens (light & dark)

Screen	Light	Dark
Home
Driver management
Add driver
Students management
Add students
Bus management
Add bus
Assign bus
Route management
Add route
Stop picker
Contacts management
Add contacts
Live tracking
Reports (1)
Reports (2)
Notification management
Add notification
Feedback
Settings
Download data

👨‍👩‍👧 Parent — live tracker (mint)

A calm, focused experience for families: where is my child's bus, which stop is next, and how far away is it.

Home — light	Home — dark	Live location	Bus details

All Parent screens (light & dark)

Screen	Light	Dark
Home
Bus
Live location
Tracking
Account
Contacts
Feedback
Notifications
Settings

🧑‍✈️ Driver — route companion (amber)

Everything a driver needs at a glance: the live map and route, the next stop, and one-tap QR attendance.

Home — light	Home — dark	Attendance	QR scan

All Driver screens (light & dark)

Screen	Light	Dark
Home
Attendance
QR / barcode scan
Account
Contacts
Feedback
Notifications
Settings

---

🧱 Architecture

BusBuddy is one Flutter project containing three role apps over a shared, typed data layer:

lib/
├── main.dart            # boot → Firebase → auth gate → appForRole(role)
├── login_pages/         # branded login + LoginBloc
├── routing/             # appForRole router
├── theme/               # shared brand theme + ThemeController (light/dark)
├── data/
│   ├── models/          # typed models (Driver, Student, Bus, Route, AssignedBus, StopsStatus, …)
│   └── repositories/    # abstract repo + Firebase impl per collection (mockable, injectable)
├── app1/                # 🛡️ Admin  (AdminPalette · indigo)
├── app2/                # 👨‍👩‍👧 Parent (ParentPalette · mint)
└── app3/                # 🧑‍✈️ Driver (DriverPalette · amber)

• State management — BLoC for flows (login, navigation) plus a repository pattern: every Firestore collection has an abstract repository and a Firebase implementation, so pages depend on interfaces and are unit-testable with fakes.
• Theming — each app defines a ThemeExtension palette (light + dark) read via context.palette; a shared ThemeController (backed by shared_preferences) toggles Light / Dark / System.
• Maps — flutter_map + latlong2, with theme-aware tiles (OSM light / Carto dark).
• Tested — 204 widget/repository tests; UI screens are guarded by render tests that fail on layout overflow.

---

👨‍💻 Tech stack

• Flutter & Dart
• Firebase — Authentication, Cloud Firestore, Cloud Functions, Storage, Messaging, Realtime Database
• BLoC + repository pattern for state & data
• flutter_map + latlong2 for live maps · fl_chart for reports
• mobile_scanner / NFC for attendance · geolocator for driver location

---

🛠️ Getting started

1. Clone & install

git clone https://github.com/Adith-Senthil-kumar/Bus_management_app.git
cd Bus_management_app
flutter pub get

2. Configure Firebase

Firebase config files are intentionally not committed — point the app at your own Firebase project:

# easiest: generates lib/firebase_options.dart for every platform
dart pub global activate flutterfire_cli
flutterfire configure

Or add the platform files manually:

• android/app/google-services.json
• ios/Runner/GoogleService-Info.plist
• macos/Runner/GoogleService-Info.plist

In the Firebase console, enable Authentication (Email/Password), Cloud Firestore, and Storage.

3. Run

flutter run                 # pick a device
flutter run -d chrome       # web (great for a quick demo)
flutter run --release       # noticeably smoother than debug

4. Test

flutter test
flutter analyze

---

🎨 App icon

The launcher icon is generated reproducibly from Flutter's canvas (no external image tools needed):

flutter test test/tools/generate_app_icon.dart   # paint the 1024² masters → assets/
dart run flutter_launcher_icons                   # fan out to every platform

---

🙌 Contributors

• Adith Senthil Kumar — Lead Developer

📄 License

Released under the MIT License.