🚚 SuperDriver — Delivery Hero

A real-time delivery platform built with Flutter — live on the App Store 🚀

---

📖 Overview

SuperDriver is a production-grade, real-time delivery ecosystem currently serving customers in Syria. The system was developed and launched by Tech Titans Digital as a complete logistics platform — covering the full journey from order placement to delivery completion.

This repository hosts the Customer App — one component of a 4-app ecosystem that includes Customer, Driver, and Operations Control Center applications, all powered by the same backend infrastructure.

---

✨ Key Features

• 🛍️ Browse & Order — Intuitive product browsing with category filters and promotions
• 📍 Real-Time Tracking — Live driver location updates using Google Maps & Geolocator
• 💬 In-App Chat — Direct customer-to-driver communication
• 🔔 Push Notifications — Order status updates via Firebase Cloud Messaging
• 🌐 Multilingual — Full Arabic & English support with flutter_localizations
• 🔐 Secure Authentication — OTP-based phone verification with secure token storage
• 💳 Order Management — Complete order history, tracking, and re-order functionality
• 🎨 Modern UI/UX — Clean Material Design with custom branding

---

📸 Screenshots

Splash	Browse	Orders

Order Tracking	Chat	Promotions

---

🏗️ Architecture

The project follows Clean Architecture principles with a clear separation of concerns across three layers:

lib/
├── data/             # Data sources, models, repositories implementations
├── domain/           # Entities, use cases, repository contracts (business logic)
├── presentation/     # UI, screens, widgets, Bloc/Cubit state management
├── l10n/             # Localization (Arabic & English)
└── main.dart         # Application entry point

Why Clean Architecture?

• ✅ Testability — Business logic isolated from UI and data sources
• ✅ Maintainability — Changes in one layer don't propagate elsewhere
• ✅ Scalability — Easy to add new features without breaking existing code
• ✅ Team-Friendly — Clear boundaries make collaboration smoother

---

🛠️ Tech Stack

Frontend

• Flutter 3.10+ — Cross-platform mobile framework
• Dart 3.10+ — Modern, type-safe language
• flutter_bloc — Predictable state management
• equatable — Value equality for state classes

Backend & Cloud

• Firebase Core — App initialization & configuration
• Cloud Firestore — Real-time NoSQL database
• Firebase Storage — Image and media uploads
• Firebase Cloud Messaging — Push notifications
• Firebase Analytics — User behavior insights
• Firebase In-App Messaging — Targeted user engagement

Maps & Location

• google_maps_flutter — Interactive maps
• geolocator — GPS positioning
• geocoding — Address ↔ coordinates conversion

Authentication & Security

• flutter_secure_storage — Encrypted local storage
• pinput — OTP input UI
• intl_phone_field — International phone number validation

Networking & Media

• http — REST API communication
• cached_network_image — Performant image caching
• image_picker — Camera & gallery integration

Notifications

• flutter_local_notifications — Local notification scheduling

---

🚀 Getting Started

Prerequisites

• Flutter SDK 3.10.0 or higher
• Dart SDK 3.10.0 or higher
• Android Studio / Xcode for platform-specific builds
• A Firebase project (see setup below)

Installation

1. Clone the repository

   git clone https://github.com/abdulkafibrejawi/superdriver.git
   cd superdriver

2. Install dependencies

   flutter pub get

3. Configure Firebase

   This repository excludes Firebase configuration files for security. To run the app, you'll need to set up your own Firebase project:

   # Install FlutterFire CLI
   dart pub global activate flutterfire_cli
   
   # Configure Firebase for the project
   flutterfire configure

   This will generate:

   • android/app/google-services.json
   • ios/Runner/GoogleService-Info.plist
   • lib/firebase_options.dart (with your real keys)

4. Run the app

   flutter run

---

🌍 The Bigger Picture

SuperDriver is part of a 4-app delivery ecosystem built by Tech Titans Digital:

1. 🛍️ Customer App — (this repository)
2. 🚗 Driver App — Order acceptance, navigation, and delivery tracking
3. 🎛️ Operations Control Center — Dispatch, monitoring, and analytics
4. 🏪 Vendor App — Order management for partner businesses

Together they form a complete real-time logistics platform serving real customers in Syria.

---

👨‍💻 Author

Abdulkafi Albrejawi Co-Founder & Founding Mobile Developer @ Tech Titans Digital

• 🌐 Portfolio: abdulkafibrejawi.github.io
• 💼 LinkedIn: @abdulkafibr
• 📧 Email: kafi.brejawi@gmail.com
• 📱 WhatsApp: +971 58 923 1134

---

📄 License

This project's source code is published for portfolio and educational purposes. The SuperDriver brand, logo, and production deployment are proprietary to Tech Titans Digital.

For commercial licensing or partnership inquiries, please contact Tech Titans Digital.

---

Built with ❤️ in Dubai 🇦🇪 by Tech Titans Digital