PD BCN 2026 — AI-Assisted Commerce Extension Lab

This lab walks you through building Adobe Commerce as a Cloud Service extensions using AI-assisted development tools. Each use case covers an App Builder extension (backend) and a storefront integration (frontend) using Claude Code CLI as the coding agent.

Prerequisites

• This repository — Clone it locally so you have the setup scripts, workbooks, and API contracts (for example: git clone https://github.com/adobe-commerce/commerce-pd-bcn-2026.git).
• Node.js 22 — Required by the Adobe I/O CLI tooling. Use n or nvm to switch versions if needed.
• npm 9+ and Git
• Claude Code CLI — Install Claude Code before starting the lab. It is not installed by the setup script or app-setup.

Provided resources

Each participant is assigned a seat number (01–35). Use it to identify your resources:

Resource	Naming convention	Example (seat 99)
Dev Console project	PD 26 BCN XX	PD 26 BCN 99
ACCS instance	PDBCNXX	PDBCN99
Adobe I/O email	pd-bcn-XX@adobeeventlab.com	pd-bcn-99@adobeeventlab.com

The password and Claude Code API key are provided during the lab.

Getting started

1. Run the setup script

The setup script validates prerequisites and installs the Adobe I/O CLI with its required plugins.

macOS/Linux:

bash pd-bcn-setup.sh

Windows (PowerShell):

.\pd-bcn-setup.ps1

To skip prerequisite checks:

# macOS/Linux
bash pd-bcn-setup.sh --skip-prereqs

# Windows
.\pd-bcn-setup.ps1 -SkipPrereqs

2. Log in to Adobe I/O

aio auth login --force

Follow the browser prompts: enter your assigned email and lab password, skip optional mobile/email recovery prompts, and select the Adobe Commerce Labs profile. Then open the Adobe Developer Console to verify login and accept terms and conditions if prompted.

3. Follow your assigned workbook

Open the workbook for your assigned use case and follow the steps from Step 3 onward (the setup script and login steps above cover Steps 1–2).

#	Use case	Workbook
1	Product Reviews & Q&A	Product Reviews
2	In-Stock Notifications	In Stock Notifications
3	Delivery Estimates	Delivery Estimates

Repository structure

Directory	Contents
Workbooks/	Step-by-step lab workbooks for each use case.
Solutions/	Reference implementations for each use case (App Builder extensions).
API_Contracts/	External API contracts used by the extensions.

Troubleshooting

Issue	Resolution
Setup script fails on Node.js version	Install Node.js 22 using n 22 or nvm install 22 && nvm use 22.
aio auth login does not open a browser	Ensure you have a default browser configured. Copy the URL from the terminal output and open it manually.
Developer Console shows no projects	Verify you selected the Adobe Commerce Labs profile during login. Run aio auth login --force to re-authenticate.
app-setup fails with authentication errors	Run aio auth login --force before retrying.
Permission denied running the setup script	Make the script executable: chmod +x pd-bcn-setup.sh