PHPackages fleetbase/storefront-api - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. fleetbase/storefront-api ActiveLibrary[API Development](/categories/api) fleetbase/storefront-api ======================== Headless Commerce & Marketplace Extension for Fleetbase 0.4.16(3w ago)625.4k↑638.1%30[2 issues](https://github.com/fleetbase/storefront/issues)AGPL-3.0-or-laterPHPPHP ^8.0CI passing Since Oct 10Pushed 3w ago3 watchersCompare [ Source](https://github.com/fleetbase/storefront)[ Packagist](https://packagist.org/packages/fleetbase/storefront-api)[ RSS](/packages/fleetbase-storefront-api/feed)WikiDiscussions main Synced 2d ago READMEChangelog (10)Dependencies (48)Versions (76)Used By (0) [![Fleetbase Storefront](https://camo.githubusercontent.com/5c2c70ad630e359e0dde8e3f5ffcc33fbf31e1c6c80cfcd0516c24279446883a/68747470733a2f2f666c622d6173736574732e73332e61702d736f757468656173742d312e616d617a6f6e6177732e636f6d2f7374617469632f73746f726566726f6e742d6c6f676f2e737667)](https://camo.githubusercontent.com/5c2c70ad630e359e0dde8e3f5ffcc33fbf31e1c6c80cfcd0516c24279446883a/68747470733a2f2f666c622d6173736574732e73332e61702d736f757468656173742d312e616d617a6f6e6177732e636f6d2f7374617469632f73746f726566726f6e742d6c6f676f2e737667) Logistics-first headless commerce and marketplace infrastructure for Fleetbase. [Documentation](https://www.fleetbase.io/docs/storefront) | [GitHub](https://github.com/fleetbase/storefront) | [Platform Overview](https://www.fleetbase.io/platform/storefront) | [Fleetbase](https://www.fleetbase.io) [![License: AGPL-3.0-or-later](https://camo.githubusercontent.com/5d1137208046c32f5816ef2f15afe28fa539465ff10b3d2a501ee822e1ef2f28/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4147504c2d2d332e302d2d6f722d2d6c617465722d626c7565)](https://camo.githubusercontent.com/5d1137208046c32f5816ef2f15afe28fa539465ff10b3d2a501ee822e1ef2f28/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4147504c2d2d332e302d2d6f722d2d6c617465722d626c7565) [![PHP ^8.0](https://camo.githubusercontent.com/2337c6be50286dabc684b39f1235fd114e792bd67fb2b36f39664179c9da7edd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e302d373737626234)](https://camo.githubusercontent.com/2337c6be50286dabc684b39f1235fd114e792bd67fb2b36f39664179c9da7edd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e302d373737626234) [![Node >=18](https://camo.githubusercontent.com/6b6f8082cec9e534c524ed7c5433f2bc047b6e8b5e0f9995983adb34345b67cc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6e6f64652d25334525334431382d333339393333)](https://camo.githubusercontent.com/6b6f8082cec9e534c524ed7c5433f2bc047b6e8b5e0f9995983adb34345b67cc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6e6f64652d25334525334431382d333339393333) [![Ember Engine](https://camo.githubusercontent.com/a4a4074c4e56f7c4715fcd5557cb3b713410ca2f67d6651fa6a6ac78d2fd3c02/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f656d6265722d656e67696e652d653034653339)](https://camo.githubusercontent.com/a4a4074c4e56f7c4715fcd5557cb3b713410ca2f67d6651fa6a6ac78d2fd3c02/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f656d6265722d656e67696e652d653034653339) --- [![Fleetbase Storefront dashboard](https://camo.githubusercontent.com/b24274cf313d7b532d38aa52851e6d8095f136377066b917a20e34af15f94a5c/68747470733a2f2f7777772e666c656574626173652e696f2f696d616765732f73637265656e73686f74732f73746f726566726f6e742f73746f726566726f6e742d64617368626f6172642e77656270)](https://camo.githubusercontent.com/b24274cf313d7b532d38aa52851e6d8095f136377066b917a20e34af15f94a5c/68747470733a2f2f7777772e666c656574626173652e696f2f696d616765732f73637265656e73686f74732f73746f726566726f6e742f73746f726566726f6e742d64617368626f6172642e77656270) Overview -------- [](#overview) Storefront is the commerce extension for Fleetbase. It combines a Laravel API package with an Ember engine for the Fleetbase Console, giving operators the tools to manage stores, products, carts, checkout, customers, marketplace networks, and fulfillment workflows from one logistics-native system. Unlike a generic e-commerce plugin, Storefront is built around the handoff from purchase to delivery. A checkout can create Fleet-Ops orders, attach storefront order metadata, expose customer and commerce details in the Fleetbase Console, and keep operators close to the real delivery lifecycle. Read the official guide at [fleetbase.io/docs/storefront](https://www.fleetbase.io/docs/storefront). Features -------- [](#features) - **Store and marketplace management**: run a single store or organize many stores into Storefront networks. - **Product catalog**: manage products, categories, variants, variant options, addons, addon categories, images, pricing, tags, and availability hours. - **Locations and mobile commerce**: configure store locations, service areas, food trucks, Fleet-Ops vehicle links, and catalogs assigned to mobile stores. - **Carts and checkout**: support persistent carts, line items, variants, addons, scheduled items, service quotes, checkout initialization, and order capture. - **Payments**: configure Stripe, QPay, and cash-on-delivery flows through Storefront gateways. - **Customers**: support customer registration, login, SMS verification, social login hooks, saved customer metadata, device registration, order history, and account closure flows. - **Orders and fulfillment**: manage Storefront orders in the console, advance order activity, assign/unassign drivers, mark preparation states, complete pickups, and inspect commerce details alongside route and tracking data. - **Reviews and votes**: expose API resources for customer reviews and voting. - **Promotions and notifications**: manage notification channels and send broadcast or transactional push notifications through APNs, FCM, and related Storefront notification classes. - **Dashboard analytics**: ship Storefront widgets for revenue, order volume, average order value, active orders, completed orders, customers, cart conversion, cancellation rate, revenue trends, top products, customer insights, order status mix, recent orders, and recent customers. - **Fleet-Ops integration**: register Storefront summaries inside Fleet-Ops order details and add product-as-entity tooling to Fleet-Ops order creation. - **Internationalization**: include translations for multiple locales through the extension translation files. Architecture ------------ [](#architecture) This repository contains both sides of the Storefront extension: AreaPathPurposeEmber engine`addon/`, `app/`, `config/`, `translations/`Fleetbase Console UI, routes, models, components, services, widgets, and translations.Laravel API`server/src/`, `server/config/`, `server/migrations/`Storefront API controllers, models, resources, middleware, providers, observers, notifications, jobs, and database migrations.Tests`tests/`, `server/tests/`Ember integration tests and backend test scaffolding.The Ember package is published as `@fleetbase/storefront-engine`. The Laravel package is published as `fleetbase/storefront-api`. Console Modules --------------- [](#console-modules) Storefront registers a Console entry under the `storefront` route and exposes these primary work areas: - **Dashboard**: Storefront-specific operational and analytics widgets. - **Products**: product catalog, categories, variants, addons, import processing, and product entity creation. - **Orders**: incoming Storefront orders, activity actions, customer details, commerce summary, documents, route/tracking context, and comments. - **Customers**: customer records and order history. - **Networks**: multi-store marketplace networks, store assignment, categories, invitations, and network-level views for stores, customers, and orders. - **Catalogs**: product bundles and catalog categories, including food truck catalog assignment. - **Food Trucks**: Fleet-Ops vehicle-linked mobile stores with service area and zone support. - **Promotions**: push notification campaigns and notification channel workflows. - **Settings**: store profile, API keys, locations, gateways, and notifications. API Surface ----------- [](#api-surface) Storefront exposes two API families. ### Public Storefront API [](#public-storefront-api) The public customer-facing API is mounted under `storefront/v1` and protected by Storefront API middleware. It includes: - Store lookup, store/network information, locations, gateways, search, tags, and network stores. - Categories, products, food trucks, reviews, and customer-facing catalog browsing. - Persistent carts with add, update, remove, empty, and delete operations. - Service quotes from carts. - Checkout initialization, status, capture, Stripe setup intents, Stripe payment intent updates, and QPay capture callbacks. - Customer registration, login, SMS code verification, social login endpoints, device registration, saved places, customer orders, phone verification, Stripe customer helpers, and account closure flows. - Order pickup completion and receipt generation. ### Internal Console API [](#internal-console-api) The protected internal API is mounted under `storefront/int/v1`. It powers the Fleetbase Console and includes: - CRUD resources for orders, customers, stores, store hours, store locations, products, product hours, variants, variant options, addons, addon categories, gateways, notification channels, reviews, votes, food trucks, catalogs, catalog categories, and catalog hours. - Order actions for accept, preparing, ready, completed, cancel, and unassign driver. - Network actions for adding stores, removing stores, categories, invitations, and network lookup. - Analytics endpoints for overview, revenue trends, order status mix, top products, and customer insights. - Metrics and operational action endpoints. Getting Started --------------- [](#getting-started) Storefront is designed to run inside a Fleetbase installation with `fleetbase/core-api` and `fleetbase/fleetops-api` available. ### Requirements [](#requirements) - PHP `^8.0` - Node.js `>=18` - pnpm - Composer - Fleetbase Core API - Fleetbase FleetOps API ### Install Dependencies [](#install-dependencies) ``` pnpm install composer install ``` ### Backend Package [](#backend-package) ``` composer require fleetbase/core-api composer require fleetbase/fleetops-api composer require fleetbase/storefront-api ``` ### Frontend Package [](#frontend-package) ``` pnpm install @fleetbase/storefront-engine ``` Development ----------- [](#development) For the full local Fleetbase workflow, see the [Fleetbase Development Setup guide](https://www.fleetbase.io/docs/platform/quickstart/development-setup). That guide covers cloning the main repository with submodules, mounting live package source, linking extensions, running the Console dev server, and reloading the API after backend changes. ### Use Local Storefront Source in Fleetbase [](#use-local-storefront-source-in-fleetbase) When developing Storefront inside the Fleetbase monorepo, run the package linker from the repository root so the local `packages/storefront` source replaces the published Storefront packages used by Console and API: ``` flb-package-linker enable storefront flb-package-linker install storefront ``` The linker updates the local Console and API manifests for development. To inspect the current link state: ``` flb-package-linker status flb-package-linker doctor ``` If the linker is not installed yet, install it once from the Fleetbase repository root: ``` npm link ``` After linking backend package changes, reload the running API worker so Laravel Octane picks up PHP changes: ``` docker compose exec application php artisan octane:reload ``` For frontend changes, run the Fleetbase Console dev server as described in the development setup guide; linked Ember packages are watched and live-reloaded by the dev server. ### Package Commands [](#package-commands) Run the Ember engine locally: ``` pnpm start ``` Build the Ember engine: ``` pnpm build ``` Run frontend lint and tests: ``` pnpm lint pnpm test pnpm test:ember ``` Run backend checks: ``` composer test:lint composer test:types composer test:unit composer test ``` Configuration ------------- [](#configuration) Storefront configuration is provided through the Laravel package config files and environment variables: - `server/config/storefront.php`: API routing, Storefront app verification settings, database connection, and request throttling. - `server/config/api.php`: Storefront API configuration. - `server/config/database.connections.php`: Storefront database connection defaults. Important environment variables include: VariablePurpose`STOREFRONT_DB_CONNECTION`Database connection name for Storefront models.`STOREFRONT_BYPASS_VERIFICATION_CODE`Development bypass code for Storefront app verification flows.`STOREFRONT_THROTTLE_REQUESTS_PER_MINUTE`Public Storefront API request limit.`STOREFRONT_THROTTLE_DECAY_MINUTES`Public Storefront API throttle decay window.For customer app configuration, see the [Storefront App configuration docs](https://www.fleetbase.io/docs/storefront/app/configuration). Documentation ------------- [](#documentation) - [Storefront documentation](https://www.fleetbase.io/docs/storefront) - [Products and catalog](https://docs.fleetbase.io/guides/storefront/products/) - [Orders and checkout](https://www.fleetbase.io/docs/storefront/orders/overview) - [Checkout flow](https://www.fleetbase.io/docs/storefront/orders/checkout) - [Store locations](https://www.fleetbase.io/docs/storefront/stores/store-locations) - [Storefront App configuration](https://www.fleetbase.io/docs/storefront/app/configuration) Contributing ------------ [](#contributing) Storefront follows the same review expectations as the rest of Fleetbase: - Keep changes small and reviewable. - Preserve existing architecture and naming conventions. - Add or update tests when practical. - Run the relevant frontend or backend validation commands before opening a pull request. - For API behavior changes, check whether the API specification and public documentation also need updates. See [CONTRIBUTING.md](CONTRIBUTING.md) for general contribution guidance. License ------- [](#license) Fleetbase Storefront is open-source software licensed under the [AGPL-3.0-or-later](LICENSE.md). ### Health Score 52 — FairBetter than 96% of packages Maintenance89 Actively maintained with recent releases Popularity38 Limited adoption so far Community18 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 78.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~15 days Recently: every ~36 days Total 63 Last Release 22d ago PHP version history (2 changes)0.1.8PHP ^7.4|^8.0 0.2.10PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/9350b92834554a15fb0fff7c7c73750c86a5edd5038e4f0006f8b888a9379b57?d=identicon)[fleetbase](/maintainers/fleetbase) --- Top Contributors [![roncodes](https://avatars.githubusercontent.com/u/816371?v=4)](https://github.com/roncodes "roncodes (254 commits)")[![tortuvshin](https://avatars.githubusercontent.com/u/9257227?v=4)](https://github.com/tortuvshin "tortuvshin (56 commits)")[![Bayarbold8](https://avatars.githubusercontent.com/u/155505206?v=4)](https://github.com/Bayarbold8 "Bayarbold8 (12 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (2 commits)") --- Tags e-commercemarketplacefleetbase-extensionstorefrontheadless commerce ### Code Quality TestsPest Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/fleetbase-storefront-api/health.svg) ``` [![Health](https://phpackages.com/badges/fleetbase-storefront-api/health.svg)](https://phpackages.com/packages/fleetbase-storefront-api) ``` ### Alternatives [fleetbase/fleetops-api Fleet & Transport Management Extension for Fleetbase 1731.5k7](/packages/fleetbase-fleetops-api)[openai-php/client OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API 5.8k28.0M318](/packages/openai-php-client)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1235.9k20](/packages/fleetbase-core-api)[telnyx/telnyx-php Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network. 35789.4k2](/packages/telnyx-telnyx-php)[aimeos/aimeos-laravel Cloud native, API first Laravel eCommerce package with integrated AI for ultra-fast online shops, marketplaces and complex B2B projects 8.7k225.1k5](/packages/aimeos-aimeos-laravel)[deeplcom/deepl-php Official DeepL API Client Library 2607.3M114](/packages/deeplcom-deepl-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)