Cheetah - Delivery Driver & Picker App with PHP REST API (Flutter)

Cheetah Driver & Warehouse Picker App — Enterprise Cross-Platform Mobile Suite (Flutter 3.x)

The Cheetah Driver & Warehouse Picker Mobile App is an enterprise-grade, high-performance cross-platform application developed with Flutter 3.x and Dart 3.x. Engineered as the official mobile companion for the Cheetah Courier Management & WMS SaaS, it provides a specialized, role-isolated operational client for both Courier Delivery Drivers / Riders and WMS Warehouse Pickers.

100% SELF-CONTAINED FULL-STACK SOLUTION: Unlike typical client-only mobile apps that require expensive proprietary software, this package includes a complete standalone PHP REST API backend, ready-to-import MySQL database, and official Postman collection. You can host and run this system independently on any standard cPanel, shared hosting, Apache, LiteSpeed, Nginx, or cloud VPS within 5 minutes!

Live Demo & APK Testing

You can test both the mobile companion application and the live dispatch backend before purchasing:

Download Android Demo APK:
Click Here to Download Demo APK (Google Drive)
(Install the APK directly on your Android phone or emulator to test the full mobile experience)

Live Web Dispatcher Backend:
https://cheetah.ayan24.me

Demo Login Accounts (for both App and Web):

• Delivery Driver Demo: rider@cheetah.com / Password: Rider123
  (Features: Real shipments timeline, digital signature pad, photo POD capture, COD wallet ledger, turn-by-turn GPS navigation)
• Warehouse Picker Demo: picker@cheetah.com / Password: Picker123
  (Features: 5-tier spatial bin guidance, SKU barcode/QR camera scanner with flashlight & haptic feedback)

Dual-Role Operational Capabilities

1. Delivery Driver / Courier Rider Portal

• Smart Delivery Pipeline: View assigned shipments categorized by status (Assigned, Out for Delivery, Delivered, Failed / Returned).
• Branded CHT- Tracking Compatibility: Natively parses, detects, and displays branded CHT-{ORIGIN_CODE}-{SERIAL} tracking numbers with instant camera barcode recognition.
• Turn-by-Turn GPS Navigation: One-tap routing integration with Google Maps, Apple Maps, and Waze directly from parcel destination addresses.
• Instant Customer Contact: 1-tap phone calls and direct WhatsApp chat integration to connect with senders and receivers.
• Proof of Delivery (POD) Suite:
  • Smooth touchscreen digital signature pad with PNG export.
  • Drop-off photo capture via device camera or gallery upload with server-side watermarking.
  • Customer delivery OTP (One-Time Password) verification support.
  • Receiver name and handover delivery remarks logging.
• Cash on Delivery (COD) Wallet Ledger: Real-time tracking of collected COD cash, pending branch vault deposits, and driver payout transaction history with idempotency key protection.
• Live Background GPS Telemetry: Transmits real-time coordinates, speed, and heading to the central dispatcher fleet map with anti-tampering hardware detection.

2. Warehouse Picker Portal (WMS Fulfillment)

• Real-Time WMS Pick Queue: Instant synchronization of pending sales order fulfillment batches dispatched by warehouse managers.
• 5-Tier Spatial Navigation: Visual warehouse shelf hierarchy (Warehouse → Zone → Aisle → Shelf → Bin) to minimize picker walking time and eliminate pick errors.
• High-Speed Camera Barcode & QR Scanner: Instant SKU barcode detection powered by mobile_scanner with flashlight toggle and haptic vibration feedback.
• Fulfillment Pipeline: 1-tap status toggling (In Progress, Completed) automatically transitions sales orders to Prepared in Cheetah WMS.

Standalone PHP REST API Backend Included

• Standalone PHP 8.0+ Backend: Pure PHP with mysqli prepared statements — zero framework overhead.
• MySQL Database Dump: Complete driver_app.sql database script with pre-seeded demo drivers, pickers, branches, active parcels, and pick tasks.
• Official Postman Collection (v2.1): Pre-configured Postman Collection & Environment with automated bearer token authentication.
• Universal Hosting Compatibility: Runs effortlessly on any standard cPanel shared hosting, Apache, Nginx, or VPS.

Enterprise Features & Reliability

• ? Firebase Cloud Messaging (FCM) Ready: Real-time background wake-on-lock push notifications alerting drivers to newly assigned parcels and warehouse pickers to fresh sales order fulfillment batches.
• ? AES-256 Encrypted Offline Queue: In underground parking lots, basements, or remote delivery routes with zero cell reception, POD records and status updates are encrypted with AES-256 and stored locally in Hive. Automatically retries and flushes queued uploads upon reconnect.
• ?️ Hardware GPS Anti-Tampering Guard: Active OS hardware listeners detect any attempt to disable location services, notifying dispatchers instantly and prompting to re-enable GPS.
• ? Hardware-Backed Token Storage: Tokens stored securely in Android Keystore / iOS Keychain (AES-256 GCM via flutter_secure_storage).
• ? 23-Language Support with Full RTL: Pre-configured with translations for English, Spanish, Arabic (with native RTL layout mirroring), French, German, Hindi, Urdu, Portuguese, Russian, and Chinese.
• ? Dark & Light Glassmorphic UI: Stunning, high-contrast visual design with system auto-detection and manual toggle.
• ? Universal Device Compatibility: Fully optimized for smartphones, tablets, and rugged industrial handheld Android barcode scanners (Zebra, Honeywell, Newland).
• ☁️ 1-Click Cloud Builds via GitHub Actions (Zero Local Setup Required!): Low-spec computer or don't own a Mac? Includes pre-configured GitHub Actions CI/CD workflows for both Android (android-build.yml — compiles Release APK & Google Play AAB) and iOS (ios-simulator-build.yml — compiles iOS build on cloud macOS runners). Simply push to GitHub and download your compiled builds directly!

What You Will Receive

• Full Flutter 3.x & Dart 3.x Source Code (Clean GetX Architecture).
• Complete Standalone PHP REST API Backend Source Code (backend/).
• Ready-to-Import MySQL Database Dump (backend/database/driver_app.sql).
• Official Postman Collection v2.1 & Environment (postman/).
• Android Project Workspace (Gradle, Android 14/15 Target SDK 34/35, Min SDK 21).
• iOS Xcode Workspace (CocoaPods ready, iOS 15.0 to 18.x compatible).
• Interactive CodeGrape-Compliant Help Guide (Help.html) included in the root.
• Testing & QA Checklist with Verification Credentials (TESTING.md).
• Backend Deployment & Configuration Guide (backend/README.md).
• Dedicated Firebase Cloud Messaging Setup Guide (FIREBASE_SETUP.md).
• Automated Cloud Build CI/CD Workflows (.github/workflows/) — 1-click cloud builds for both Android (APK & AAB) and iOS without installing local SDKs!
• Step-by-step App Store & Google Play publishing instructions.