https://github.com/sourish-kanna/next-bus
An App to store bus timing and to show when next bus will come
https://github.com/sourish-kanna/next-bus
dart flutter flutter-apps
Last synced: 6 months ago
JSON representation
An App to store bus timing and to show when next bus will come
- Host: GitHub
- URL: https://github.com/sourish-kanna/next-bus
- Owner: Sourish-Kanna
- License: mit
- Created: 2024-12-10T11:46:37.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-30T17:01:36.000Z (6 months ago)
- Last Synced: 2025-03-30T17:35:16.499Z (6 months ago)
- Topics: dart, flutter, flutter-apps
- Language: Dart
- Homepage: https://next-bus-app.netlify.app/
- Size: 376 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Next Bus 🚍
**Next Bus** is a dynamic Flutter application designed to provide real-time bus timings and manage routes effectively. It integrates Firebase for database operations and uses Provider for state management. This app offers a clean, responsive UI and ensures ease of use with features like dynamic theming and admin operations.
[](https://app.netlify.com/sites/next-bus-app/deploys)
## Features ✨
### User Features
- View upcoming and past bus timings.
- Dynamic UI with support for light and dark themes (Material Design 3).
- Portrait mode for seamless usability.
### Admin Features
- **Add Bus Routes**: Add new bus routes with associated details.
- **Remove Bus Routes**: Delete existing bus routes.
- **Add Timings**: Add new timings for specific bus routes.
- **Retrieve Timings**: View all timings for specific routes.
### Firebase Integration
- **Firestore Database**: Store and manage bus routes, timings, and related data.
- CRUD operations (Create, Read, Update, Delete) implemented for seamless data handling.
---
## Technologies Used 🛠️
### Frameworks and Libraries
- **Flutter**: For building a cross-platform application.
- **Firebase**: Backend as a Service (BaaS) for authentication and Firestore database.
- **Provider**: For efficient state management.
- **Dynamic Color**: To enable dynamic light and dark themes.
### UI Design
- **Material Design 3**: Modern and responsive UI.
- **Dialogs and Animations**: Improved user interaction and feedback.
---
## Installation and Setup 🚀
### Prerequisites
- Flutter SDK (latest stable version).
- Dart SDK.
- Firebase Project (set up in the [Firebase Console](https://console.firebase.google.com/)).
### Steps to Set Up
1. Clone the repository:
```bash
git clone https://github.com/Sourish-Kanna/Next-Bus.git
cd next-bus
```
2. Install dependencies:
```bash
flutter pub get
```
3. Configure Firebase:
- Add the `google-services.json` file to the `android/app` directory.
4. Run the app:
```bash
flutter run
```
---
## Project Structure 📁
``` text
next-bus/
├── lib/
│ ├── main.dart # App entry point
│ ├── build_widgets.dart # Custom UI components
│ ├── bus_timing_provider.dart # State management
│ ├── firebase_operations.dart # Firebase service operations
├── android/ # Android-specific files
├── pubspec.yaml # Dependencies and assets
└── README.md # Project documentation
```
---
## Future Enhancements 🛠️
- Add notifications for upcoming bus timings.
- Implement user authentication (Admin/User roles).
- Support multiple languages for wider accessibility.
- Expand to support additional public transport modes.
---
## Contributing 🤝
1. Fork the repository.
2. Create your feature branch: `git checkout -b feature/YourFeature`.
3. Commit your changes: `git commit -m 'Add some feature'`.
4. Push to the branch: `git push origin feature/YourFeature`.
5. Open a pull request.
---
## License 📄
This project is licensed under the [MIT License](LICENSE).
---
## Screenshots 📸
---
## Acknowledgements 🙏
- Firebase Documentation:
- Flutter Documentation: