Delivery Boy for Groceries, Foods, Pharmacies, Stores Flutter App

✨ Key Features

• Job lifecycle: New → Accepted → Picked → En-route → Delivered/Failed with timers & SLA hints.
• Smart dispatch: Auto-assignment or manual claim, distance/ETA & batching support (multi-drop).
• Live tracking: Background location updates, route polyline, and real-time status for customers/ops.
• Navigation: Integrated Google Maps directions; deep links to Maps/Waze/Apple Maps.
• Verification: Pickup barcode/QR scan, customer OTP, and proof-of-delivery photos/notes.
• Earnings & payouts: Per-order pay, tips, incentives, shift bonuses, and weekly payout summary.
• In-app comms: Secure chat/call shortcuts to customer, store, and dispatcher.
• Work availability: Go-Online/Offline, shift scheduling, break mode, and geofencing boundaries.
• Notifications: FCM/OneSignal push for new jobs, reassignment, cancellations, and payout status.
• Offline mode: Queue updates and retry on reconnect; resilient to flaky networks.
• Security: JWT/OAuth, domain allowlist, OS-level permissions gating, and minimal data scope.
• Localization & RTL: Multi-language strings, currency/units, and RTL layouts.
• Theming: Light/Dark mode, brand colors/typography, scalable component library.

⚙️ Technical Stack

• Framework: Flutter 3.x (stable), Dart (null-safety)
• State mgmt: Riverpod / BLoC / Provider (modular and interchangeable)
• Networking: dio/http, web_socket_channel or Socket.IO adapter
• Maps & Geo: Google Maps SDK, geolocator, background geolocation service
• Push: Firebase Cloud Messaging (FCM) or OneSignal
• Storage/Cache: shared_preferences, hive/sqflite (optional)
• Auth: JWT/OAuth 2.0; refresh token flow
• Build tools: Flutter SDK, Android Studio/Xcode, Gradle, CocoaPods
• Backend (expected): REST + WebSockets (Laravel 10+/Node.js/NestJS/Django), MySQL 8+/PostgreSQL, HTTPS
• Minimum OS: Android 6.0 (API 23)+, iOS 13+

🧩 Installation Guide

1. Clone & bootstrap: Open project → flutter pub get (Flutter 3.x stable).
2. Configure endpoints: Set BASE_URL, WebSocket URL, and auth headers in lib/config/.
3. Maps & push: Add Google Maps keys (Android/iOS) and FCM/OneSignal credentials.
4. Permissions: Enable foreground service + background location (Android), location/background modes + Push/APNs (iOS). Add privacy strings.
5. Branding: App name, icon, splash, color scheme, and typography.
6. Test flows: Simulate assignment → pickup scan/OTP → delivery → earnings. Verify offline/retry.
7. Release: Create signing configs, generate AAB/IPA, and prepare store listings with safety disclosures.

📦 Deliverables

• Full Flutter source code (feature-modular, well-commented)
• Models/services for orders, dispatch, chat, and earnings
• Config templates (env.sample, config.dart)
• UI themes, icons/splash placeholders, and localization (ARB) samples
• Push, maps, and background-task setup notes
• Postman/Thunder collection for key API endpoints
• GPL license file & redistribution notice

📱 Supported Platforms

• Android: Phones & rugged devices (API 23+), tablet-friendly layouts
• iOS: iPhone & iPad (iOS 13+), split-view optimized
• Form factors: Portrait/landscape; efficient for battery-sensitive background tracking

🧠 Notes

• License: Distributed under the GPL for learning, audits, and derivative works.
• Customization tips (Expertise): Centralize API routes and socket channels; expose dispatch algorithms via feature flags; log geolocation at sane intervals to balance ETA accuracy and battery life.
• Performance: Use background isolates for periodic updates; throttle location to road-speed thresholds; prefetch map tiles around hot zones.
• Compliance & safety: Add in-app safety checklist (helmet/lights), local labor/tax guidance links, and visible emergency contacts.
• Store listing SEO: Include “delivery rider,” “grocery courier,” “pharmacy delivery,” and local city/zone keywords; localize screenshots/captions.

👨‍💻 Original Developer Credit

This work acknowledges the original Delivery Boy Flutter app authors published on marketplaces such as
CodeCanyon. Please support the
original developer if you rely on their commercial edition or require extended licensing.

🔒 Disclaimer

Provided for educational and evaluation purposes under the GPL. Third-party SDKs (Maps, FCM/OneSignal, barcode/QR, analytics) require your own keys and accounts. Trademarks and sample assets belong to their owners. You are responsible for legal compliance (data privacy, rider safety, labor laws) and for honoring any original developer terms, including purchasing commercial licenses where required. No demo links are included.