{"id":22542174,"url":"https://github.com/commercelayer/app-returns","last_synced_at":"2026-05-11T05:51:47.146Z","repository":{"id":207580051,"uuid":"682927560","full_name":"commercelayer/app-returns","owner":"commercelayer","description":"Commerce Layer application for managing returns.","archived":false,"fork":false,"pushed_at":"2024-04-12T08:04:15.000Z","size":241,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-04-12T23:39:55.172Z","etag":null,"topics":["admin-apps","commercelayer","composable-commerce","dashboard-apps","ecommerce","oms","react"],"latest_commit_sha":null,"homepage":"","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}},"created_at":"2023-08-25T07:30:25.000Z","updated_at":"2024-05-10T09:40:20.360Z","dependencies_parsed_at":"2024-04-15T09:36:46.323Z","dependency_job_id":null,"html_url":"https://github.com/commercelayer/app-returns","commit_stats":null,"previous_names":["commercelayer/app-returns"],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fapp-returns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fapp-returns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fapp-returns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercelayer%2Fapp-returns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commercelayer","download_url":"https://codeload.github.com/commercelayer/app-returns/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245991559,"owners_count":20706125,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","oms","react"],"created_at":"2024-12-07T13:08:50.554Z","updated_at":"2026-05-11T05:51:47.110Z","avatar_url":"https://github.com/commercelayer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!WARNING]\n\u003e This repository is no longer maitained. We moved all our Dashboard applications to a brand new [dashboard-apps](https://github.com/commercelayer/dashboard-apps) monorepo. This allows you to run them all locally effortlessly.\n\n# App returns\n\nCommerce Layer application for managing returns. \n\nAny Commerce Layer account comes with a hosted version of this application, as part of the Dashboard hub, and it is automatically enabled for admin users.\nAn admin can then enable the app for other organization members giving each member full or read-only access.\n\nIt's possible to fork this app and add it to your Dashboard hub, in order to customize every part of the code and start using your own and self-hosted version.\n\n## Table of contents\n\n- [Getting started](#getting-started)\n- [Running on Windows](#running-on-windows)\n- [Help and support](#need-help)\n- [License](#license)\n\n\n## Getting started\nYou need a local Node.JS (version 18+) environment and some React.JS knowledge to customize the app code.\n\n1. Fork [this repository](https://github.com/commercelayer/app-returns) (you can learn how to do this [here](https://help.github.com/articles/fork-a-repo)).\n\n2. Clone the forked repository like so:\n\n```bash\ngit clone https://github.com/\u003cyour username\u003e/app-returns.git \u0026\u0026 cd app-returns\n```\n\n3. Set your environment by creating a new `/src/app/.env.local` file starting from `/src/app/.env` (not required for local development).\n\n4. Install dependencies and run the development server:\n\n```\npnpm install\npnpm dev\n```\n\n5. The app will run in development mode at the following address `http://localhost:5173/`. \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`.\nIntegration access token is only required (and will work only) for development mode. In production mode the Commerce Layer Dashboard hub will generate a valid access token, based on the current user.\n\n6. Modify the app to satisfy your requirements. \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://github.com/commercelayer/app-elements) to discover more about this topic.\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/app-returns#PUBLIC_SELF_HOSTED_SLUG) [\u003cimg src=\"https://vercel.com/button\" alt=\"Deploy to Vercel\" height=\"35\"\u003e](https://vercel.com/new/clone?repository-url=https://github.com/commercelayer/app-returns\u0026build-command=pnpm%20build\u0026output-directory=packages%2Fapp%2Fdist\u0026env=PUBLIC_SELF_HOSTED_SLUG\u0026envDescription=your%20organization%20slug) \n\n8. Complete the configuration in the Dashboard hub by setting your app URL.\n\n## Running on Windows\n[Read more](https://github.com/commercelayer/.github/blob/main/PNPM_ON_WINDOWS.md)\n\n## Need help?\n\n1. Join [Commerce Layer's Slack community](https://slack.commercelayer.app).\n\n2. Create an [issue](https://github.com/commercelayer/app-returns/issues) in this repository.\n\n3. Ping us [on Twitter](https://twitter.com/commercelayer).\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%2Fapp-returns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommercelayer%2Fapp-returns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercelayer%2Fapp-returns/lists"}