Storefront App
The Storefront App is the source-accessible React Native client your customers use to browse stores and place orders against your LogisBase Storefront backend.
Storefront App
The Storefront App is the source-accessible 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 LogisBase instance.
github.com/logisbase/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 LogisBase Instance
The app is a thin React Native client. All catalog, cart, checkout, customer, and order traffic is made against your LogisBase API host using a public Storefront key (store_* for a single store or network_* for a marketplace) plus your LogisBase API secret key.
Storefront App ──HTTPS──▶ LogisBase 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-logisbase.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
Get the app running
Clone, install, configure .env, and launch in iOS, Android, or web.
Customize behavior
Every config field, env var, and runtime option the app exposes.
Themes, colors, logo, app icon, splash, and display names.