{"id":22542149,"url":"https://github.com/commercelayer/dashboard-apps","last_synced_at":"2026-02-10T18:10:54.159Z","repository":{"id":257845541,"uuid":"819939827","full_name":"commercelayer/dashboard-apps","owner":"commercelayer","description":"Commerce Layer's Dashboard applications.","archived":false,"fork":false,"pushed_at":"2026-02-06T10:39:47.000Z","size":4633,"stargazers_count":2,"open_issues_count":13,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-02-06T18:25:27.885Z","etag":null,"topics":["admin-apps","commercelayer","composable-commerce","dashboard-apps","ecommerce","react"],"latest_commit_sha":null,"homepage":"https://dashboard.commercelayer.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/commercelayer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-06-25T13:31:39.000Z","updated_at":"2026-02-06T10:35:48.000Z","dependencies_parsed_at":"2026-01-13T16:05:43.788Z","dependency_job_id":null,"html_url":"https://github.com/commercelayer/dashboard-apps","commit_stats":null,"previous_names":["commercelayer/dashboard-apps"],"tags_count":133,"template":true,"template_full_name":null,"purl":"pkg:github/commercelayer/dashboard-apps","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fdashboard-apps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fdashboard-apps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fdashboard-apps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fdashboard-apps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commercelayer","download_url":"https://codeload.github.com/commercelayer/dashboard-apps/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fdashboard-apps/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29310139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T17:48:59.043Z","status":"ssl_error","status_checked_at":"2026-02-10T17:45:37.240Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin-apps","commercelayer","composable-commerce","dashboard-apps","ecommerce","react"],"created_at":"2024-12-07T13:08:41.748Z","updated_at":"2026-02-10T18:10:54.106Z","avatar_url":"https://github.com/commercelayer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dashboard apps \u003c!-- omit in toc --\u003e\n\nAny 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`](apps) folder of this repository or read more [here](https://commercelayer.github.io/app-elements/?path=/docs/getting-started-applications--docs).\n\nIt'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](https://commercelayer.github.io/app-elements/?path=/docs/getting-started-custom-apps--docs). \n\n## Table of contents \u003c!-- omit in toc --\u003e\n\n- [Getting started](#getting-started)\n- [Docker](#docker)\n- [Running on Windows](#running-on-windows)\n- [Need help?](#need-help)\n- [License](#license)\n\n\n## Getting started\n\nYou need a local Node.js (version 20+) environment and some React knowledge to customize the app code.\n\n1. Create a new repository from [this template](https://github.com/new?template_owner=commercelayer\u0026template_name=dashboard-apps) (if you want to contribute you can start from a fork instead).\n\n2. Clone the newly created repository like so:\n\n```bash\ngit clone https://github.com/\u003cyour username\u003e/dashboard-apps.git \u0026\u0026 cd dashboard-apps\n```\n\n3. Install dependencies and run the development server:\n\n```\npnpm install\npnpm dev\n```\n\n4. 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.\\\nIn order to authenticate the app, you need to add an integration access token as URL query param. Example: `http://localhost:5173/?accessToken=\u003cintegration-token-for-local-dev\u003e`.\nThat 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.\n\n5. Modify any application you need to satisfy your requirements. Applications are stored inside the [`./apps`](apps) folder.\nAll our Dashboard apps are built using a shared component library [@commercelayer/app-elements](https://github.com/commercelayer/app-elements).\nYou can browse the [official documentation](https://commercelayer.github.io/app-elements/?path=/docs/getting-started-welcome--docs) to discover more about this topic.\n\n6. Build all applications into the `./dist` folder:\n\n```\npnpm build:apps\n```\n\n\n7. Deploy the forked repository to your preferred hosting service. You can deploy with one click below:\n\n[\u003cimg src=\"https://www.netlify.com/img/deploy/button.svg\" alt=\"Deploy to Netlify\" height=\"35\"\u003e](https://app.netlify.com/start/deploy?repository=https://github.com/commercelayer/dashboard-apps#PUBLIC_SELF_HOSTED_SLUG)\n[\u003cimg src=\"https://vercel.com/button\" alt=\"Deploy to Vercel\" height=\"35\"\u003e](https://vercel.com/new/clone?repository-url=https://github.com/commercelayer/dashboard-apps\u0026build-command=pnpm%20build%3Aelements%20%26%26%20pnpm%20build%3Aapps\u0026output-directory=dist\u0026env=PUBLIC_SELF_HOSTED_SLUG\u0026envDescription=your%20organization%20slug) \n\n8. Create a [custom app](https://commercelayer.github.io/app-elements/?path=/docs/getting-started-custom-apps--docs) in the Commerce Layer Dashboard.\n\n## Docker\n\nYou can build and run the dashboard apps using Docker for easy deployment and distribution.\n\n```bash\ndocker build -t dashboard-apps:latest .\n```\n\n```bash\ndocker run --rm -p 8080:80 dashboard-apps:latest\n```\n\nThe applications are available at [localhost:8080](http://localhost:8080). Since the router app is not included in the Docker image, you can open a specific app directly, for example [localhost:8080/customers](http://localhost:8080/customers).\n\nIf instead you are running the container in production, you can now create a [custom app](https://commercelayer.github.io/app-elements/?path=/docs/getting-started-custom-apps--docs) in the Commerce Layer Dashboard.\n\n\u003e [!NOTE]\n\u003e This Docker setup is provided as a reference. Customize it as needed for your environment:\n\u003e - Edit `Dockerfile` to tweak the build and image layout\n\u003e - Edit `nginx.conf` to adjust routing, caching, and headers\n\n## Running on Windows\n[Read more](https://github.com/commercelayer/.github/blob/main/PNPM_ON_WINDOWS.md)\n\n## Need help?\n\n- Join [Commerce Layer's Discord community](https://discord.gg/commercelayer).\n- Ping us on [Bluesky](https://bsky.app/profile/commercelayer.io), [X (formerly Twitter)](https://x.com/commercelayer), or [LinkedIn](https://www.linkedin.com/company/commerce-layer).\n- Is there a bug? Create an [issue](https://github.com/commercelayer/dashboard-apps/issues) on this repository.\n\n## License\n\nThis repository is published under the [MIT](LICENSE) license\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercelayer%2Fdashboard-apps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommercelayer%2Fdashboard-apps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercelayer%2Fdashboard-apps/lists"}