🚚 Active eCommerce Delivery Boy Flutter App – Official Delivery Companion for Active eCommerce CMS (GPL-Ready Source Description)

Active eCommerce Delivery Boy Flutter App is a mobile application (Android & iOS) built with Flutter that connects directly to your Active eCommerce CMS backend to help delivery staff manage orders in real time. Couriers can log in, view assigned orders, track customer locations, update delivery status (Picked → On the way → Delivered), and notify the customer — all from their phone. This description is prepared for GPL / source-code / script repositories and follows E-E-A-T standards.

🚀 Overview

The app is designed to close the last-mile gap in multi-vendor or single-vendor eCommerce stores running on Active eCommerce. Instead of managing deliveries manually (calls, WhatsApp, spreadsheets), admins can assign orders to delivery boys and let the app handle status updates, delivery notes, and map navigation.

• 📦 Real-time order fetching from Active eCommerce API
• 👷 Delivery-boy login with role-based access
• 📍 Customer address & map directions
• ✅ Delivery status update with proof

Experience (E): modeled on actual delivery workflows used by grocery, fashion, and food eCommerce stores — minimal taps, large buttons, online/offline-safe screens.

✨ Key Features

• 🔐 Secure Auth: delivery staff sign in with credentials created in the web admin.
• 📋 Order List: see new, ongoing, and completed deliveries in one screen.
• 📍 Address & Map Link: view customer location and open in Google Maps / Apple Maps.
• 🔄 Status Update Flow: update order to “accepted”, “picked-up”, “on the way”, or “delivered”.
• 🧾 Order Details: see items, total amount, payment method (COD / paid).
• 💰 COD Awareness: delivery boy can see if payment is still due at the door.
• 🔔 Push Notifications: for new assigned orders (via Firebase Cloud Messaging).
• 🌐 API-driven: pulls data from Active eCommerce REST/JSON endpoints.
• 🎨 Flutter UI: modern, responsive, and easy to rebrand.

⚙️ Technical Stack

• App: Flutter (Dart)
• Backend: Active eCommerce CMS (Laravel/PHP) with API enabled
• Network: REST/JSON over HTTPS
• Push: Firebase Cloud Messaging (FCM)
• State: Provider / GetX / Bloc (depends on the original build)

Requirements:

• Flutter SDK 3.x+
• Active eCommerce CMS (latest compatible version)
• Laravel API / addon for delivery integration enabled
• Android Studio or Xcode for platform builds
• HTTPS (recommended) for secure API calls

Expertise (E): demonstrates a real-world mobile → Laravel integration pattern for logistics and last-mile delivery.

🧩 Installation Guide

1. 1. Prepare backend: make sure your Active eCommerce CMS is installed and the API is reachable from the device.
2. 2. Download & extract the Flutter delivery app source.
3. 3. Run flutter pub get to install dependencies.
4. 4. Configure API URL & keys in the app’s config.dart / environment.dart file.
5. 5. Add Firebase (optional but recommended) for push notifications.
6. 6. Run on device: flutter run and log in with a delivery-boy account created in the web admin.
7. 7. Build for release: flutter build apk / flutter build appbundle / flutter build ipa.

Tip: test with one order assigned to this delivery boy in the admin to verify the whole flow.

📦 Deliverables

• ✅ Full Flutter source code (delivery app)
• ✅ API integration with Active eCommerce CMS
• ✅ Ready-made screens (login, order list, order detail, delivery status)
• ✅ Firebase/notification setup files (where applicable)
• ✅ Basic setup / README instructions
• ✅ GPL redistribution statement (for educational/archive listings)

📱 Supported Platforms

• Android: 5.0+ (API 21+)
• iOS: iOS 12+ (requires macOS + Xcode)
• Backend OS: Linux / VPS / shared hosting running Active eCommerce CMS
• Form factor: smartphones (portrait UI, driver-friendly buttons)

🧠 Notes

• License: distributed here under GPL for transparency and educational use; the original marketplace item may be commercial.
• Branding: replace app name, splash, and primary color to match the main store app.
• Security: always use token-based auth and HTTPS to prevent data leakage.
• Extensions: can be extended with driver earnings, delivery history, and live-location tracking.
• SEO Assurance: keywords → “Active eCommerce delivery app”, “Flutter delivery boy”, “multi-vendor delivery mobile”.

👨‍💻 Original Developer Credit

This delivery boy app was originally created by the Active eCommerce CMS development team and/or its official add-on authors on marketplaces such as CodeCanyon. All original commercial rights, naming, and trademarks belong to them. This is an E-E-A-T-aligned GPL restatement for documenting and showcasing the source.

Authoritativeness (A): for bug fixes, version updates, or compatibility with newer CMS releases, always refer to the original vendor.

🔒 Disclaimer

Important:

• This is a source-code documentation entry, not the official vendor page.
• No original support or license keys are included unless purchased from the official author.
• GPL redistribution must keep author credit and must not claim exclusive rights.
• Test on a staging Active eCommerce instance before letting real drivers use it.

Trustworthiness (T): all origin, licensing, and usage conditions are disclosed to keep redistribution ethical and transparent.