FleetFork - Flutter Food and Grocery Delivery UI

FleetFork is a Flutter UI kit for a food and grocery delivery platform, for iOS and Android. It has three apps: a customer app, a merchant app for store owners, managers and store helpers, and a driver app. They share one design system and one order model, and run on mock data, so every screen works before you connect a backend.

An order placed in the customer app moves through the store (accept, prepare or pick, pack, hand over) and the driver (job offer, pickup code, bag check, proof of delivery) with the same statuses in every app. Grocery orders support substitutions end to end: a store helper proposes a replacement, the customer accepts or declines within five minutes, and the customer's saved preference applies otherwise. A demo panel in each app moves orders through every status, sends driver job offers and switches markets, so you can show the whole flow on one device.

The merchant app is role-based. Owners run orders, menu and stock, opening hours, promotions, reviews, reports, payouts and staff. Managers can do everything except payouts and staff. Store helpers only see picking, packing and hand-over, and the router enforces it. On tablets the order queue and the order detail sit side by side.

Screens read data through eight repository interfaces with Riverpod providers. Mock implementations with realistic, clearly fictional data are bound in each app's main.dart; replace them with your own API classes and no screen needs to change. The documentation walks through it, including live order updates over a WebSocket. Money is stored in integer minor units. Currency, tax included or added, tips, cash on delivery, km or miles, kg or lb, address format and 12 or 24-hour time are settings.

The design system has light and dark themes, an accent per app, its own icon set and food illustrations drawn for the kit, so there are no stock photos to license. English and Arabic are included with a full right-to-left layout. Every data screen has loading, empty, error and offline states.

Not included: a backend, real payments, push notifications, a maps SDK (maps are an illustrated placeholder behind an interface you can point at Google Maps, Mapbox or OpenStreetMap), real chat or calling, or an admin web panel. Earnings, payouts and ratings are sample data.

Features

- 122 screens in three apps: customer (50), merchant (41: owner and manager 28, store helper 13), driver (31) - One order lifecycle shared by all apps, from placed to delivered, with rejected, cancelled, failed and driver-reassigned paths - Grocery substitutions end to end: helper proposes, customer accepts or declines within five minutes, saved preference applies otherwise - Role-based merchant app: owner, manager and store helper, enforced in navigation - Tablet layout for the merchant order queue and detail - Driver job offers with a countdown, pickup code, bag check, proof of delivery by photo or code, cash on delivery - Live tracking, checkout with tips, ratings, issue reports and refunds in the customer app - Light and dark themes with an accent per app; English and Arabic with full right-to-left layout - Market settings: currency, tax included or added, tips, cash on delivery, km or miles, kg or lb, 12 or 24-hour time - Money in integer minor units, never floating point - Eight repository interfaces with a mock backend; swap in your API without changing screens - Order simulator and demo panel to show every status on one device - Loading, empty, error and offline states on every data screen - Icons and food illustrations drawn for the kit: no stock photos to license - Android release signing set up, launcher icons and splash screens per app - 58 unit and widget tests, HTML documentation with Android and iOS release steps

Requirements

Flutter 3.44 or later (Dart 3.12). Xcode 16 or later for iOS (deployment target iOS 13). Android Studio with an Android SDK for Android. Packages: flutter_riverpod, go_router, flutter_svg, intl. No API keys or accounts are needed to run the apps.

Instructions

1. Unzip the download and open a terminal in FleetForkUIKit/FleetForkUI. 2. Run "flutter pub get" once (it resolves all three apps), then "cd apps/customer_app" (or merchant_app, driver_app) and "flutter run" with an iOS simulator or Android emulator selected. 3. Customer: tap Skip on onboarding to browse. Merchant: tap Sign in (the demo email and password are filled in), or Staff sign-in with any 6-digit code for the store helper view. Driver: "I already have an account", Send code, then any 6-digit code. 4. Tap the DEMO tab on the screen edge to move orders through every status, send a driver job offer, or switch theme, language and market. 5. To connect your backend, implement the interfaces in packages/data/lib/src/repositories.dart and override the providers in each app's main.dart. No screen changes are needed. 6. To rebrand, set the name, accent colours and font in packages/common/lib/src/brand.dart; app names, IDs, icons and splash screens are listed in the documentation. 7. Documentation/index.html covers setup, release steps for Android and iOS, architecture, connecting an API, rebranding, localization and testing.