{"id":27854860,"url":"https://github.com/genaker/adobe-store","last_synced_at":"2025-05-04T09:59:27.081Z","repository":{"id":286415918,"uuid":"960125369","full_name":"Genaker/adobe-store","owner":"Genaker","description":"Storefront","archived":false,"fork":false,"pushed_at":"2025-04-03T22:43:13.000Z","size":2861,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-04T09:59:23.390Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Genaker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2025-04-03T22:43:09.000Z","updated_at":"2025-04-03T22:43:18.000Z","dependencies_parsed_at":"2025-04-06T11:23:26.752Z","dependency_job_id":null,"html_url":"https://github.com/Genaker/adobe-store","commit_stats":null,"previous_names":["genaker/adobe-store"],"tags_count":0,"template":false,"template_full_name":"hlxsites/aem-boilerplate-commerce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genaker%2Fadobe-store","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genaker%2Fadobe-store/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genaker%2Fadobe-store/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Genaker%2Fadobe-store/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Genaker","download_url":"https://codeload.github.com/Genaker/adobe-store/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252317081,"owners_count":21728526,"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":[],"created_at":"2025-05-04T09:59:26.589Z","updated_at":"2025-05-04T09:59:27.067Z","avatar_url":"https://github.com/Genaker.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Edge Delivery Services + Adobe Commerce Boilerplate\nThis project boilerplate is for Edge Delivery Services projects that integrate with Adobe Commerce.\n\n## Documentation\nhttps://experienceleague.adobe.com/developer/commerce/storefront/\n\n## Environments\n- Preview: https://main--{repo}--{owner}.aem.page/\n- Live: https://main--{repo}--{owner}.aem.live/\n\n## Pre-requisites\n\nOut of the box, this project template uses a pre-configured Adobe Commerce environment. If you want to use your own Adobe Commerce environment, you'll need to update the `configs.xlsx` file in your content repository to have values that match your environment.\n\nAdditionally, you need to have the following modules and customizations installed on your environment:\n\n1. adobe-commerce/storefront-compatibility: Contains changes to the Adobe Commerce GraphQL API that enable drop-ins functionality.\n1. magento/module-data-services-graphql: Commerce module with the functionality necessary for adding context to events.\n1. magento/module-page-builder-product-recommendations: Commerce module required for PRex Widget\n1. magento/module-visual-product-recommendations: Commerce module required for PRex Widget\n\u003c!-- 1. TODO: Add further prereqs.  --\u003e\n\n## Documentation\n\nBefore using the boilerplate, we recommend you to go through the documentation on https://www.aem.live/docs/ and more specifically:\n1. [Developer Tutorial](https://www.aem.live/developer/tutorial)\n2. [The Anatomy of a Project](https://www.aem.live/developer/anatomy-of-a-project)\n3. [Web Performance](https://www.aem.live/developer/keeping-it-100)\n4. [Markup, Sections, Blocks, and Auto Blocking](https://www.aem.live/developer/markup-sections-blocks)\n\n## Initial Setup\n\nThe boilerplate assumes you already have an `aem.live` org and will onboard a new site via config service. If you do not have an `aem.live` org, you will need to [contact Adobe](https://discord.gg/aem-live) to have one created, or you can do the following:\n\n1. Upload the [starter content](https://github.com/hlxsites/aem-boilerplate-commerce/releases/tag/starter-content) somewhere (https://da.live, sharepoint, google drive, etc).\n1. Update the mountpoint in the `default-fstab.yaml` to point to your content.\n1. Rename the file to `fstab.yaml` and commit/push the change.\n1. Install the [AEM Code Sync Bot](https://github.com/apps/aem-code-sync)\n1. Verify the site is working at https://main--{site}--{org}.aem.page\n1. Add a `/.helix/config.xlsx` to your content, and add a `admin.role.admin` row with your email address.\n1. Preview/save this file. This should update the site config with the permissions.\n1. Delete the `/.helix/config.xlsx` and the `fstab.yaml` again and use the site config from here on.\n\n### Config Service\n\nBefore running the command, replace the following variables to match your project values:\n\n* `{ORG}` - Name of your organistation in GitHub.\n* `{SITE}` - Name of your site in the org. For the first site in your org, it must be equal to the GitHub repository name.\n* `{REPO}` - Name of your GitHub repository.\n* `{ADMIN_USER_EMAIL}` - Email address of your config admin user.\n* `{ADMIN_USER_ID}` - User ID of your authoring admin (click user icon in top right, then click \"share\" icon in da.live to copy).\n* `{DOMAIN}` - Public facing domain of your site (e.g. `www.your-shop.com`).\n* `{YOUR_TOKEN}` - Your personal access token. You can retrieve one from login via one of the methods from https://admin.hlx.page/login and copy the token from the `auth_token` cookie in the response.\n\nPlease use HTTP [PUT](https://www.aem.live/docs/admin.html#tag/siteConfig/operation/createSiteSite) for the initial creation of the configuration and [POST](https://www.aem.live/docs/admin.html#tag/siteConfig/operation/updateConfigSite) for subsequent updates.\n\n```bash\ncurl -X PUT 'https://admin.hlx.page/config/{org}/sites/{site}.json' \\\n  -H 'content-type: application/json' \\\n  -H 'x-auth-token: {YOUR_TOKEN}' \\\n  --data-binary '@default-config.json'\n```\n\n### Apply Index Configuration\n```bash\ncurl -X POST 'https://admin.hlx.page/config/{org}/sites/{site}/content/query.yaml' \\\n  -H 'content-type: text/yaml' \\\n  -H 'x-auth-token: {YOUR_TOKEN}' \\\n  --data-binary '@default-query.yaml'\n```\n\n### Apply Sitemap Configuration\n```bash\ncurl -X POST 'https://admin.hlx.page/config/{org}/sites/{site}/content/sitemap.yaml' \\\n  -H 'content-type: text/yaml' \\\n  -H 'x-auth-token: {YOUR_TOKEN}' \\\n  --data-binary '@default-sitemap.yaml'\n```\n\nAfter you onboard to config service you can delete fstab.yaml and [other files](https://www.aem.live/docs/config-service-setup#remove-unused-configuration-files) that are no longer necessary.\n\n## Installation\n\n```sh\nnpm i\n```\n\n## Updating Drop-in dependencies\n\nYou may need to update one of the drop-in components, or `@adobe/magento-storefront-event-collector` or `@adobe/magento-storefront-events-sdk` to a new version. Besides checking the release notes for any breaking changes, ensure you also execute the `postinstall` script so that the dependenices in your `scripts/__dropins__` directory are updated to the latest build. This should be run immediately after you update the component, for example:\n\n```\nnpm install @dropins/storefront-cart@2.0. # Updates the storefront-cart dependency in node_modules/\nnpm run postinstall # Copies scripts from node_modules into scripts/__dropins__\n```\n\nThis is a custom script which copies files out of `node_modules` and into a local directory which EDS can serve. You must manually run `postinstall` due to a design choice in `npm` which does not execute `postinstall` after you install a _specific_ package.\n\n## Linting\n\n```sh\nnpm run lint\n```\n\n## Local development\n\n1. Create a new repository based on the `aem-boilerplate-commerce` template, rename `default-fstab.yaml` to `fstab.yaml` and add a mountpoint for your site content.\n1. Add the [AEM Code Sync GitHub App](https://github.com/apps/aem-code-sync) to the repository\n1. Add your Adobe Commerce configuration in the `configs-dev.xlsx` sheet in your content repository.\n1. Install all dependencies using `npm i`.\n1. Start AEM Proxy: `npm run start` (opens your browser at `http://localhost:3000`)\n1. Open the `{repo}` directory in your favourite IDE and start coding :)\n\n## Changelog\n\nMajor changes are described and documented as part of pull requests and tracked via the `changelog` tag. To keep your project up to date, please follow this list:\n\nhttps://github.com/hlxsites/aem-boilerplate-commerce/issues?q=label%3Achangelog+is%3Aclosed\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenaker%2Fadobe-store","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenaker%2Fadobe-store","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenaker%2Fadobe-store/lists"}