peterojo / boilerplate-commerce-dropins

A feature fork and testing ground for Commerce Drop-ins. For access, please join https://github.com/orgs/hlxsites/teams/adobe-commerce.

Edge Delivery Services + Adobe Commerce Boilerplate (Experimental)

This project boilerplate is for Edge Delivery Services projects that integrate with Adobe Commerce.

Environments

• Preview: https://main--{repo}--{owner}.hlx.page/
• Live: https://main--{repo}--{owner}.hlx.live/

Pre-requisites

Out 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.

Additionally, you need to have the following modules and customizations installed on your environment:

1. magento/magento-extra-graphql: Commerce module required for Cart and Checkout Drop-Ins.
2. magento/module-data-services-graphql: Commerce module with functionality necessary for adding context to events.
3. magento/module-page-builder-product-recommendations: Commerce module required for PRex Widget
4. magento/module-visual-product-recommendations: Commerce module required for PRex Widget

Installation

npm i

Linting

npm run lint

Local development

1. Create a new repository based on the aem-boilerplate template and add a mountpoint in the fstab.yaml
2. Add the AEM Code Sync GitHub App to the repository
3. Add your Adobe Commerce SaaS configuration in the configs.xlsx sheet in your content repository.
4. Install the AEM CLI: npm install -g @adobe/aem-cli
5. Start AEM Proxy: aem up (opens your browser at http://localhost:3000)
6. Open the {repo} directory in your favorite IDE and start coding :)