Flowery Tracking App 🌹🏍️

Overview

The Flowery Tracking App is a modern Flutter-based delivery management solution designed for drivers within the Flowery ecosystem.
It empowers drivers to receive, navigate, and complete delivery tasks seamlessly — building a reliable connection between stores and customers.

Developed with scalability, speed, and real-time synchronization in mind, the app integrates Firebase Firestore to keep driver and customer data perfectly aligned throughout the delivery process.

The project also includes robust localization support, dependency injection, and automated testing and CI/CD pipelines for continuous quality assurance.
Its architecture follows a feature-driven, layered structure — organizing logic into presentation, domain, and data layers — while connecting with both REST APIs and Firebase Firestore for smooth, live data flow.

---

Tech Stack

• Flutter (UI)
• Dart (language)
• State management: flutter_bloc (Bloc/Cubit patterns)
• Dependency injection: get_it + injectable (generated di.config.dart)
• Networking: dio + retrofit (API clients & JSON serialization)
• Serialization / Codegen: json_serializable, build_runner + code generation
• Local storage / security: shared_preferences, flutter_secure_storage
• Other libraries: cached_network_image, flutter_svg, lottie, location, pin_code_fields, logger, pretty_dio_logger, equatable, etc.
• Testing: flutter_test, bloc_test, mockito for unit & widget tests
• CI / Quality: GitHub Actions workflows for linting, SonarCloud, PR title checks, unit tests, and Fastlane for distribution
• Firebase Firestore: Real-time synchronization between driver and user apps.

---

Architecture

The project follows a modern, layered and feature-driven architecture:

• Feature-first layout (e.g., lib/features/<feature>/...) — each feature contains its data, domain, and presentation layers.
• Domain layer: Entities and use-cases (pure Dart models & business rules).
• Data layer: DTOs, remote/local data sources, repositories, and mappers to domain entities.
• Presentation layer: Flutter UI using Bloc/Cubit for state management (views, pages, widgets).
• Dependency injection: get_it configured and code-generated via injectable (di.config.dart).
• Internationalization: ARB-based localization with l10n.yaml configuration (generated app_localizations.dart).

---

Features 🌻🌼💐

Onboarding & Authentication 🚀

• Onboarding Flow: Introduction screens guiding drivers about the app purpose.
• Login / Apply:
  • Registered drivers can log in with email and password.
  • New drivers can apply for registration through a dedicated flow.
• Forgot Password: Reset password easily using email verification and OTP flow.

---

Order Management 📦

• Home Screen (Pending Orders):

  • Displays a real-time list of available delivery orders.
  • Drivers can accept an order directly from the list.
  • Once accepted, the order is locked until delivered.

• Order Details Screen:

  • View detailed information including:
    • User Details
    • Store Details
    • Order Details
  • Direct navigation to map views:
    • Store Map: Displays the route from the driver’s current location to the store.
    • User Map: Displays the route from the store to the customer’s location.

• Accepted Orders:

  • Real-time updates from Firestore.
  • The driver cannot accept new orders until the current one is delivered.

---

Completed & Canceled Orders 📜

• Orders History Screen:
  • Displays all Completed and Canceled orders.
  • Each order includes detailed information such as user details, store details, and delivery time.
  • Drivers can open any previous order to view its Order Details Screen.

---

Profile & Settings 👤

• Profile Screen:
  • View and edit personal information (name, phone number, etc.).
  • Change the app language between English and Arabic.
  • Log out securely anytime.

---

Testing

• Run unit & widget tests:

  flutter test

• Mocks are generated using mockito (see generated *.mocks.dart files).

• CI runs tests via GitHub Actions and also runs flutter analyze for static analysis.

---

Folder Structure

lib/
├── config/                         # Global app configurations
│   ├── routing/                    # Navigation & route management
│   └── theme/                      # Light/Dark themes setup

├── core/                           # Shared base layer used by all features
│   ├── components/                 # Reusable custom widgets
│   ├── di/                         # Dependency Injection (Injectable setup)
│   ├── errors/                     # Failure models + Safe API call handler
│   ├── helpers/                    # Toasts, dialogs, spacing helpers, validators
│   ├── l10n/                       # Localization (EN/AR) files and setup
│   ├── network/                    # Networking base (Dio interceptors, client setup)
│   ├── providers/                  # Theme & locale providers
│   ├── services/                   # App level services (Token, Firebase, etc.)
│   └── utils/                      # App constants, keys, assets utilities

├── features/                       # Modular features (Fully independent)
│   ├── auth/
│   │   ├── data/
│   │   │   ├── data_source/        # Remote/Local data sources
│   │   │   ├── models/             # DTOs with json_serializable
│   │   │   └── repositories_impl/  # Repository implementations
│   │   ├── domain/
│   │   │   ├── entities/           # Business entities
│   │   │   ├── repositories/       # Repository contracts
│   │   │   └── usecases/           # Auth use cases
│   │   └── presentation/
│   │       ├── view_models/        # BLoC / Cubit state management
│   │       ├── screens/            # UI pages
│   │       └── widgets/            # Feature-specific widgets
│   │
│   ├── home/                       # Same structure for each feature
│   ├── product/
│   └── cart/

├── firebase_options.dart           # Firebase configuration file
└── main.dart                       # Application entry point

---

How to Run the Project

1. Install Flutter (stable channel recommended)
2. Get dependencies:

flutter pub get

3. Generate code:

flutter pub run build_runner build --delete-conflicting-outputs

4. Run the app:

flutter run

5. Build an APK:

flutter build apk --release

---

CI / CD

• GitHub Actions for linting, pull request title, branch name, unit testing, soner qube, building & distribution
• Fastlane workflow for Firebase App Distribution

---

📱 Screenshots

Onboarding

Login

Apply Driver

Forgot Password

Home Tab

Order Details

Orders Tab

Profile

---

👨‍💻 Contributors

• Ahmed Fayed
• Yahya Eltayeeb
• Ahmed Rajeh
• Mostafa Amer
• Ahmed Yehia

---

👥 GitHub Avatars

---

License

Choose a license (MIT recommended)