🚀 Overview

The app connects delivery agents with the restaurant or marketplace backend, enabling real-time communication between customers,
restaurants, and riders. Couriers can accept/decline orders, navigate using map directions, view restaurant & customer information,
chat with support (if enabled), and manage their daily earnings.

Experience-driven architecture: The workflow reflects real food delivery systems such as Uber Eats, DoorDash, Deliveroo, and Zomato —
focusing on speed, accuracy, optimized routing, and seamless update cycles for order statuses.

✨ Key Features

• Order Management — accept, decline, pick-up, en-route, delivered.
• Live Order Tracking — customer & restaurant map locations, polyline route navigation.
• Turn-by-Turn Navigation via Google Maps / Apple Maps (iOS).
• Push Notifications — order assignment, cancellations, new messages.
• Earnings Dashboard — daily/weekly summaries, payouts, incentives.
• Availability Status — go online/offline with one tap.
• Profile & Documents — upload ID, photo, license, and vehicle info.
• Chat Module — optional agent–customer/support messaging (depends on build).
• Order History — completed, cancelled, and ongoing jobs.
• Localization & RTL Support
• Dark/Light Theme

⚙️ Technical Stack

• Frontend: Flutter (Dart) — supports Android & iOS.
• Backend/API: Laravel (PHP) or Node.js REST API (varies by version/package).
• Database: MySQL / MariaDB.
• Maps: Google Maps SDK, Geocoding API, Places API.
• Notifications: Firebase Cloud Messaging (FCM).
• Authentication: JWT / OAuth / Token-based login.
• Minimum Requirements: Android 5.0+ (API 21), iOS 12+.
• Tools: Flutter SDK, Android Studio, Xcode, Dart DevTools.

🧩 Installation Guide

1. Backend Setup: upload admin panel/API → configure .env → run migrations → create delivery roles → set map/FCM keys.
2. App Setup: open Flutter project → run flutter pub get → update API_BASE_URL, package name, app name, branding.
3. Maps Integration: add Google Maps keys for Android & iOS; enable Directions & Geocoding APIs.
4. Firebase Setup: add google-services.json and GoogleService-Info.plist; configure notification channels.
5. Testing Workflow: simulate order assignment → verify pickup → delivery completion → check earnings dashboard.
6. Build & Release: flutter build apk/aab for Android; flutter build ipa for iOS.

📦 Deliverables

• Flutter source code (Android + iOS app).
• Delivery agent UI screens (orders, map, earnings, profile).
• REST API integration layer.
• Firebase push notification setup.
• Map/navigation module.
• Branding assets (icons, splash screens).
• SQL schema + environment examples.
• Installation & configuration documentation.

📱 Supported Platforms

• Android: Phones & tablets.
• iOS: iPhone & iPad.
• Admin Panel: Chrome, Firefox, Safari, Edge (web-based).
• Backend: Linux VPS or shared hosting with PHP (if Laravel) or Node.js server.

🧠 Notes

• License: This package is redistributed under the GPL license.
• Customization Tips:
  • Add surge-based payouts or incentive bonuses for peak hours.
  • Integrate live chat support via Firebase, SendBird, or custom sockets.
  • Implement multi-country support with currency and distance settings.
  • Enable route optimization using external APIs (e.g., Mapbox, Here Maps).
  • Add biometric login for riders.
• Operational Note: App requires coordinated backend + restaurant/customer app ecosystem for full functioning.
• SEO Optimization: Includes structured metadata and keywords: “Flutter delivery boy app,” “food courier mobile app,”
  “multi-restaurant delivery solution,” and “Flutter logistics app v2.4.”

👨‍💻 Original Developer Credit

Full credit belongs to the original developer of the Flutter Restaurant Delivery Boy App.
For official updates, support, and commercial licenses, please refer to the original listing on
CodeCanyon or the author’s website.

🔒 Disclaimer

This is a GPL redistribution intended for educational and archival purposes. We are not associated with the original author and do not
provide commercial support, FCM billing, or Google Maps quota allocations. All trademarks remain the property of their respective owners.
For production-level deployments, purchase the official license and ensure compliance with delivery, privacy, and location-tracking regulations.