{"id":28902708,"url":"https://github.com/adeeteya/ssn-bt","last_synced_at":"2026-05-10T03:06:04.119Z","repository":{"id":298124230,"uuid":"399355329","full_name":"adeeteya/Ssn-bt","owner":"adeeteya","description":"A Bus Tracking Application for SSN college of engineering.","archived":false,"fork":false,"pushed_at":"2025-06-10T22:57:01.000Z","size":4767,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-18T13:11:57.718Z","etag":null,"topics":["bus-tracking","bus-tracking-app","firebase","firebase-realtime-database","flutter","flutter-app","flutter-apps","flutter-examples"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-4-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adeeteya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-08-24T06:12:23.000Z","updated_at":"2025-06-10T22:57:03.000Z","dependencies_parsed_at":"2025-06-09T15:01:38.178Z","dependency_job_id":"fffbb311-058d-43c2-bf90-46f4c9d75dc6","html_url":"https://github.com/adeeteya/Ssn-bt","commit_stats":null,"previous_names":["adeeteya/ssn-bt"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/adeeteya/Ssn-bt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FSsn-bt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FSsn-bt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FSsn-bt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FSsn-bt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adeeteya","download_url":"https://codeload.github.com/adeeteya/Ssn-bt/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adeeteya%2FSsn-bt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261114457,"owners_count":23111762,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bus-tracking","bus-tracking-app","firebase","firebase-realtime-database","flutter","flutter-app","flutter-apps","flutter-examples"],"created_at":"2025-06-21T11:30:37.231Z","updated_at":"2026-05-10T03:06:04.112Z","avatar_url":"https://github.com/adeeteya.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚌 SSN Bus Tracking – User App (Students \u0026 Faculty)\n\nA cross-platform mobile application built using Flutter that enables students and faculty members of SSN College of Engineering to **track college buses in real-time**, receive **breakdown alerts**, and manage **lost \u0026 found** requests.\n\n\u003e Companion application to the [SSN Bus Tracking – Driver App](https://github.com/adeeteya/Ssnbt_Driver).\n\n## 📲 Features\n\n### 🎯 Real-Time Bus Tracking\n- View the **live location** of your assigned college bus.\n- Get **ETA** and **distance** to your selected stop.\n- Automatic route selection based on your SSN credentials.\n\n### 🔀 Change Route\n- Temporarily switch to a different route (for travel with friends or changes in plan).\n\n### 🧭 Lost \u0026 Found\n- Raise a request with **item details**, optional **image upload**, and contact information.\n- Track the status of your request (approved/pending/declined).\n\n### 📞 Emergency Contact\n- Directly call your **assigned driver** or **route supervisor** from the app in one tap.\n\n## 🛠️ Tech Stack\n\n| Layer               | Technology                             |\n|--------------------|-----------------------------------------|\n| UI Development     | Flutter (Dart)                          |\n| Maps Integration   | Google Maps SDK + Directions API        |\n| Authentication     | Google Sign-In (SSN Email Restriction)  |\n| Backend Database   | Firebase Realtime Database              |\n| State Management   | GetX                                    |\n| Design \u0026 Prototyping | Figma                                 |\n| IDE                | Android Studio                          |\n\n## 🔐 Access Control\n\n- 🔒 Only SSN email addresses can log in.\n- 🧭 Location access is required to enable tracking features.\n- 🛡️ All data is securely stored and managed via Firebase Cloud Firestore.\n\n## 🧪 Testing Highlights\n\n- ✅ Login restricted to verified SSN accounts.\n- ✅ GPS \u0026 network checks to ensure location accuracy.\n- ✅ Error handling for invalid inputs (e.g., phone number validation).\n- ✅ Status updates: `IDLE`, `RUNNING`, `BREAKDOWN` reflected in real-time.\n\n## 📸 Screenshots\n\n| Screen | Preview |\n|--------|---------|\n| On Boarding Screen | \u003cimg alt=\"On Boarding Screen\" src=\"screenshots/onboarding_screen.png\" height=\"587px\" width=\"256px\"/\u003e |\n| Home Tracking Screen | \u003cimg alt=\"Home Tracking Screenshot\" src=\"screenshots/home_screen.png\" height=\"587px\" width=\"256px\"/\u003e |\n| Select Route Screen | \u003cimg alt=\"Select Route Screenshot\" src=\"screenshots/select_route.png\" height=\"587px\" width=\"256px\"/\u003e |\n| Report Lost Item Screen | \u003cimg alt=\"Report Lost Item Screenshot\" src=\"screenshots/report_lost_item.png\" height=\"587px\" width=\"256px\"/\u003e |\n| Lost and Found Screen | \u003cimg alt=\"Lost and Found Screenshot\" src=\"screenshots/lost_and_found.png\" height=\"587px\" width=\"256px\"/\u003e |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadeeteya%2Fssn-bt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadeeteya%2Fssn-bt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadeeteya%2Fssn-bt/lists"}