Storefront App
The customer app for ordering, booking and delivery on Fleetbase. One store, a marketplace of many, or a fleet of mobile trucks, on iOS, Android and the web.
Storefront App
The Storefront App is the app your customers use. They browse and search, order products, book services, pay, chat with the store and their driver, and follow the delivery live. You run the stores, orders, drivers and promotions from the Fleetbase Console; the app is a React Native client of the Storefront API, built once for iOS, Android and the web.
github.com/fleetbase/storefront-app
The same app on Android, here in the light appearance:
Three kinds of app from one codebase
The key you build with, and a few settings in the brand file, decide what the app is:
| Build with | The app becomes |
|---|---|
A store key (store_…) | One business's own branded app. Home is the store page. |
A network key (network_…) | A marketplace of member stores, with discovery, search across stores, a stores map and carts that span stores. A Network built around one main store can open on the shop home instead. |
| Either key, with the trucks home | A mobile commerce app: home is a live map and list of the trucks serving the customer's zone, alongside fixed store locations. |
See Home Screens & Tabs for every home screen and how to choose it.
Features
| Area | What customers get |
|---|---|
| Shopping | Store and marketplace homes, categories with subcategories, search with recent searches, product variants and add-ons, sale prices and live stock levels |
| Service bookings | Book a time from the free slots a store has open, with deposits — see Bookings |
| Marketplace | Many independent stores in one app, discovery by category, tag and distance, a stores map, one cart and one checkout across stores — see Networks |
| Trucks | Mobile stores on a live map, each with its own catalog and service zone — see Food Trucks |
| Offers | Promotions and promo codes, an Offers tab, and offer badges on the categories and products they apply to — see Promotions |
| Checkout | Delivery or pickup, scheduled orders, tips, saved addresses (with a map pin where address search is weak), a note for the store, and Stripe or QPay |
| After the order | Live tracking with the driver on the map, chat with the store and the driver, store edits shown live, wrong-address reports, receipts, order history and reviews — see Order Messages |
| Accounts | Phone number and texted code, or Apple and Google; profile, saved cards and addresses; account deletion in the app |
| Notifications | Push notifications for order updates, chat messages and offers, and an in-app inbox |
| Your brand | Colors for light and dark, fonts, buttons, tabs and home screen from one brand file; icon and launch screen from your artwork; any screen replaceable without forking |
| Everyone | Light and dark appearance, text that follows the system size, screen reader labels; English, Mongolian and Ukrainian included |
How it connects
The app talks to your Fleetbase API with your Storefront key and a Fleetbase API key, and to the realtime server for live order, driver and chat updates:
Storefront App ──HTTPS──▶ Fleetbase API ──▶ Storefront extension ──▶ Fleet-Ops
──WSS────▶ SocketCluster ──▶ live orders, drivers and chatOn Fleetbase Cloud that is https://api.fleetbase.io and the hosted realtime server; nothing else to run. Self-hosted, point the app at your own API and socket server.