Storefront App
The Storefront App is the open-source React Native client your customers use to browse stores and place orders against your Fleetbase Storefront backend.
Storefront App
The Storefront App is the open-source customer-facing client for the Storefront extension. It is a single React Native codebase that targets iOS, Android, and the web, paired with the Storefront backend running on your Fleetbase instance.
github.com/fleetbase/storefront-app
What It Includes
| Capability | Notes |
|---|---|
| iOS, Android & web | Single codebase. Native via React Native + Hermes (New Architecture); web via react-native-web + Webpack |
| Storefront browsing | Home, search, map view, product detail, cart, checkout, receipt — wired to the Storefront API |
| Cart & checkout | Multi-product cart with options/variants/addons, address book, location picker, real-time service quote |
| Payments | Stripe (PaymentSheet or CardField, with Apple Pay & Google Pay), QPay, PayPal scaffolding |
| Customer auth | Phone + 2FA SMS, email/password, plus optional Apple, Google, and Facebook social sign-in |
| Real-time order tracking | SocketCluster client for live order and driver updates |
| Push notifications | APNs (iOS) and FCM (Android) via Storefront notification channels |
| Theming | Tamagui-based; 5 hue choices × light/dark, plus custom brand themes |
| Localization | English and Mongolian bundled; per-locale tab labels; runtime locale switch |
| Food-truck mode | Alternate single-vendor navigator for mobile stores |
The Storefront App is the customer-facing companion to the Storefront extension. The backend is configured in the Storefront Console — the app is the storefront your customers download.
How It Connects to Your Fleetbase Instance
The app is a thin React Native client. All catalog, cart, checkout, customer, and order traffic is made against your Fleetbase API host using a public Storefront key (store_* for a single store or network_* for a marketplace) plus your Fleetbase API secret key.
Storefront App ──HTTPS──▶ Fleetbase API ──▶ Storefront extension ──▶ Fleet-Ops
──WSS───▶ SocketCluster ──▶ Real-time order updatesYou point the app at a backend by setting three environment variables in .env:
FLEETBASE_HOST=https://your-fleetbase.example.com
FLEETBASE_KEY=flb_live_...
STOREFRONT_KEY=$store.your_store_keySee Quickstart for the full setup.
Project Status
Single-store mode is production-ready and runs in real deployments today. The multi-vendor / network navigator is scaffolded in the codebase but not feature-complete — most teams currently use the app in single-store mode.
Next Steps
.env, and launch in iOS, Android, or web.