Bebewa Logistics App

Welcome to the Bebewa Logistics App! 🚚
This is a logistics management application built with Flutter. The app streamlines package delivery, tracking, and logistics operations for both customers and service providers.

Features

• User Authentication: Secure login and registration for users and logistics providers.
• Real-Time Package Tracking: Track packages with live location updates.
• Order Management: Create, view, and update delivery requests.
• Notifications: Push notifications for order status updates.
• Integrated Payments: Seamless payment processing.
• Admin Dashboard: Manage users, orders, and logistics providers.

Tech Stack

• Frontend: Flutter (Dart)
• Backend: [Specify if applicable, e.g., Firebase, Node.js, etc.]
• Database: [Specify if applicable, e.g., Firestore, MySQL, etc.]
• APIs: RESTful APIs for data exchange

Installation

1. Clone the repository:

   git clone https://github.com/nullchemy/bebewa-mobile.git

2. Navigate to the project directory:

   cd bebewa-mobile

3. Install dependencies:

   flutter pub get

4. Run the app:

   flutter run

Project Structure

lib/
├── models/        # Data models
├── screens/       # UI screens
├── widgets/       # Reusable widgets
├── services/      # API and backend integrations
├── utils/         # Utility functions and helpers
└── main.dart      # Entry point of the app

Collaboration Guidelines

Workflow

1. Feature Branching: Create a new branch for every feature or bug fix.

   git checkout -b feature/your-feature-name

2. Pull Requests: Submit pull requests for review before merging to the main branch.
3. Code Reviews: All team members must review and approve pull requests.

Coding Standards

• Follow Dart's style guide.
• Write descriptive commit messages:

  [Feature] Add live tracking to the delivery screen
  [Fix] Resolve issue with payment integration
  

• Add comments to complex or non-obvious code.

Communication

• Use GitHub Issues to track tasks and bugs.
• Coordinate using [Slack/Teams/Discord/etc.] for daily updates.

Contributors

• Dennis Kibet - Project Lead
• Peter Kigo
• John Kariuki

License

This project is licensed under the APache 2.0 License.

Acknowledgements

• Built with ❤️ using Flutter.
• Inspired by the need for efficient logistics management.