AEM Experimentation Boilerplate

This is a boilerplate for AEM experimentation. It builds upon the AEM Boilerplate with these configurations:

• Integration of the updated Experimentation Engine (V2) - see adobe/aem-experimentation#28
• Sidekick configuration with the latest experimentation UI rail

Environments

• Preview: https://main--aem-experimentation-boilerplate--adobe.aem.page/
• Live: https://main--aem-experimentation-boilerplate--adobe.aem.live/

Documentation

Before using the aem-boilerplate, we recommand you to go through the documentation on https://www.aem.live/docs/ and more specifically:

1. Developer Tutorial
2. The Anatomy of a Project
3. Web Performance
4. Markup, Sections, Blocks, and Auto Blocking

AI-Assisted Setup

This project includes assistant skills — prompt files that instruct AI coding assistants (Claude Code, Cursor, Copilot, Codex, etc.) how to perform common setup tasks.

Experimentation Engine

Check, update, or repair the AEM Experimentation plugin setup for this project:

• Claude Code: /check-experimentation-engine [check|install|update]
• Other AI tools: Ask your assistant to check/install/update the experimentation engine and reference .claude/commands/check-experimentation-engine.md for instructions.

The skill audits the plugin, integration files, and head.html configuration — and can fix any issues it finds.

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. Install the AEM CLI: npm install -g @adobe/aem-cli
4. Start AEM Proxy: aem up (opens your browser at http://localhost:3000)
5. Open the {repo} directory in your favorite IDE and start coding :)