Edge Delivery Services with AEM Authoring Boilerplate for Commerce , Version 0.6

This project boilerplate is for AEM Authoring with Edge Delivery Services (aka Crosswalk) projects that integrate with Adobe Commerce.

Documentation

Before using the boilerplate, we recommend you to go through the documentation on https://experienceleague.adobe.com/developer/commerce/storefront/ and more specifically:

1. Storefront Developer Tutorial
2. AEM Docs
3. AEM Developer Tutorial
4. The Anatomy of an AEM Project
5. Web Performance
6. Markup, Sections, Blocks, and Auto Blocking
7. Product Page Prerendering

Getting Started

Alternatively, you can follow our Guide for a more detailed walkthrough.

Updating Drop-in dependencies

You 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:

npm install @dropins/storefront-cart@2.0. # Updates the storefront-cart dependency in node_modules/
npm run postinstall # Copies scripts from node_modules into scripts/__dropins__

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

Changelog

Major 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:

https://github.com/hlxsites/aem-boilerplate-commerce/issues?q=label%3Achangelog+is%3Aclosed

Product Detail Pages (PDPs)

Since Ocotober 2025, folder mapping is no longer configured by default as its deprecated. To keep it easy to start, static product pages have been created as part ot the site template for all products listed on the homepage.

It is highly recommended to create physical product detail pages in Edge Delivery Services. Use the AEM Commerce Prerenderer to implement a byom overaly that creates and publishes product detail pages from the product data available in Catalog Service.