{"id":30772234,"url":"https://github.com/fuzziecoder/bus-navx-app","last_synced_at":"2026-04-16T04:03:47.500Z","repository":{"id":313034317,"uuid":"1049763968","full_name":"fuzziecoder/Bus-NavX-App","owner":"fuzziecoder","description":"Bus NavX is a Flutter-based mobile application designed for students and commuters to track buses in real time, navigate routes, and manage attendance through QR code scanning. It integrates Firebase for authentication, data storage, and notifications, offering a seamless and interactive user experience.","archived":false,"fork":false,"pushed_at":"2025-10-16T14:02:58.000Z","size":477,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-17T17:06:55.584Z","etag":null,"topics":["bus-tracking-app","firebase","flutter","fuzziecoder","mobile-app","pmc","pmc-college","pmc-tech","qr-code-scanner","real-time-tracking-app","smart-transportation","student-transport"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fuzziecoder.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-03T13:12:40.000Z","updated_at":"2025-10-16T14:03:02.000Z","dependencies_parsed_at":"2025-09-03T15:20:51.783Z","dependency_job_id":"b09e7ec2-6907-4c70-904d-5eb8e3f371ae","html_url":"https://github.com/fuzziecoder/Bus-NavX-App","commit_stats":null,"previous_names":["fuzziecoder/bus-navx-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fuzziecoder/Bus-NavX-App","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuzziecoder%2FBus-NavX-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuzziecoder%2FBus-NavX-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuzziecoder%2FBus-NavX-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuzziecoder%2FBus-NavX-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fuzziecoder","download_url":"https://codeload.github.com/fuzziecoder/Bus-NavX-App/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fuzziecoder%2FBus-NavX-App/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31870520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-app","firebase","flutter","fuzziecoder","mobile-app","pmc","pmc-college","pmc-tech","qr-code-scanner","real-time-tracking-app","smart-transportation","student-transport"],"created_at":"2025-09-05T01:00:59.875Z","updated_at":"2026-04-16T04:03:47.461Z","avatar_url":"https://github.com/fuzziecoder.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bus NavX App\n\nA Flutter mobile application for bus navigation, tracking, and attendance management with QR code scanning functionality.\n\n## Repository\n\n[GitHub Repository](https://github.com/fuzziecoder/Bus-NavX-App)\n\n## Features\n\n- **Authentication**: User login and registration system\n- **Bus Navigation**: Real-time bus tracking and navigation\n- **QR Attendance**: Scan QR codes to mark attendance\n- **Notifications**: Receive important updates and alerts\n- **User Profiles**: Manage user information and preferences\n- **Comments System**: Provide feedback and communicate with others\n\n## Prerequisites\n\nBefore running the application, make sure you have the following installed:\n\n- [Flutter SDK](https://flutter.dev/docs/get-started/install) (\u003e=2.17.0 \u003c3.0.0)\n- [Dart SDK](https://dart.dev/get-dart) (compatible with Flutter version)\n- [Android Studio](https://developer.android.com/studio) or [VS Code](https://code.visualstudio.com/) with Flutter extensions\n- [Git](https://git-scm.com/downloads) for version control\n- A Firebase project (for authentication, database, and storage)\n\n## Setup\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/fuzziecoder/Bus-NavX-App.git\ncd \"Bus NavX\"\n```\n\n### 2. Install dependencies\n\n```bash\nflutter pub get\n```\n\n### 3. Firebase Configuration\n\n1. Create a Firebase project at [Firebase Console](https://console.firebase.google.com/)\n2. Add Android and iOS apps to your Firebase project\n3. Download the configuration files:\n   - For Android: `google-services.json` and place it in `android/app/`\n   - For iOS: `GoogleService-Info.plist` and place it in `ios/Runner/`\n\n### 4. Enable Firebase Services\n\nIn the Firebase Console, enable the following services:\n- Authentication (Email/Password)\n- Cloud Firestore\n- Storage\n- Messaging (for notifications)\n\n## Running the Application\n\n### Debug Mode\n\n```bash\nflutter run\n```\n\n### Release Mode\n\n#### Android\n\n```bash\nflutter build apk --release\n```\n\nThe APK file will be available at `build/app/outputs/flutter-apk/app-release.apk`\n\n#### iOS\n\n```bash\nflutter build ios --release\n```\n\nThen open the Xcode workspace at `ios/Runner.xcworkspace` and archive the application.\n\n## Project Structure\n\n\nlib/\n├── app.dart                 # Main app configuration\n├── config/                  # App configuration\n│   ├── constants.dart       # App constants\n│   ├── routes.dart          # Navigation routes\n│   └── themes.dart          # App themes\n├── main.dart                # Entry point\n├── models/                  # Data models\n├── screens/                 # App screens\n│   ├── auth/                # Authentication screens\n│   ├── bus_nav/             # Bus navigation screens\n│   ├── comments/            # Comments screens\n│   ├── dashboard/           # Main dashboard\n│   ├── home/                # Home screen\n│   ├── profile/             # User profile\n│   ├── qr_attendance/       # QR code scanning\n│   └── splash/              # Splash screen\n├── services/                # Backend services\n└── widgets/                 # Reusable widgets\n\n\n## Dependencies\n\n- **Firebase**: Authentication, database, storage, and messaging\n- **Provider**: State management\n- **Rive \u0026 Lottie**: Animations\n- **Google Maps \u0026 Geolocator**: Maps and location services\n- **QR Code**: QR code scanning and generation\n- **UI Components**: Various UI enhancement libraries\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Firebase Configuration**: Ensure the Firebase configuration files are correctly placed in their respective directories.\n\n2. **Animation Files**: If animations aren't working, check that the required files exist in:\n   - `assets/animations/success.json`\n   - `assets/rive/icons.riv`\n\n3. **Permissions**: Make sure to grant location and camera permissions for the app to function properly.\n\n### Getting Help\n\nIf you encounter any issues, please:\n\n1. Check the [Flutter documentation](https://flutter.dev/docs)\n2. Review the [Firebase documentation](https://firebase.google.com/docs)\n3. Search for similar issues in the project's issue tracker\n4. Open an issue in the [GitHub repository](https://github.com/fuzziecoder/Bus-NavX-App)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuzziecoder%2Fbus-navx-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuzziecoder%2Fbus-navx-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuzziecoder%2Fbus-navx-app/lists"}