Any Commerce Layer account comes with the hosted version of a full set of Dashboard applications, automatically enabled for admin users. An admin can then enable one or more apps for other organization members giving each member full or read-only access. For an updated list of the available applications, check the ./apps folder of this repository or read more here.
It's possible to clone this repository and add one or more apps to your Dashboard, in order to customize every part of the code and start using your own self-hosted version. For more information on how to do it, read more here.
You need a local Node.js (version 20+) environment and some React knowledge to customize the app code.
-
Create a new repository from this template (if you want to contribute you can start from a fork instead).
-
Clone the newly created repository like so:
git clone https://github.com/<your username>/dashboard-apps.git && cd dashboard-apps- Install dependencies and run the development server:
pnpm install
pnpm dev
-
The "router" app will run in development mode at http://localhost:5173. The "router" app is the orchestrator for all other applications, and it is available only for local development as an alternative to the Dashboard.
In order to authenticate the app, you need to add an integration access token as URL query param. Example:http://localhost:5173/?accessToken=<integration-token-for-local-dev>. That access token is only required (and will work only) for development mode. In production mode, the Commerce Layer Dashboard will generate a valid access token, based on the current user. -
Modify any application you need to satisfy your requirements. Applications are stored inside the
./appsfolder. All our Dashboard apps are built using a shared component library @commercelayer/app-elements. You can browse the official documentation to discover more about this topic. -
Build all applications into the
./distfolder:
pnpm build:apps
- Deploy the forked repository to your preferred hosting service. You can deploy with one click below:
- Create a custom app in the Commerce Layer Dashboard.
- Join Commerce Layer's Discord community.
- Ping us on Bluesky, X (formerly Twitter), or LinkedIn.
- Is there a bug? Create an issue on this repository.
This repository is published under the MIT license