Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [1.0.0] - 2026-03-11

### Removed

- Removed deprecated `commerce init` command and all init-only utilities (`initialization.js`, `github.js`, `content.js`, `preview.js`, `openBrowser.js`, `mesh.js`, `configs.js`, `importer.js`, `mdast/`, `fetchWithRetry.js`, `sleep.js`) ([#40](../../pull/40))
- Removed `commerce dev` command and placeholder `commerce test` command
- Removed unused `selectOrganization` export from `devConsole.js` and unused `readEnvFile`/`writeEnvFile` exports from `envFile.js`
- Removed `jsdom` dependency (only used by init-related utilities)
- Removed `gh` CLI prerequisite from README (only used by dev command)
- Removed all API Mesh references from documentation
- Removed init-specific sections from README: Mesh Prerequisites, init command docs, init-specific troubleshooting, and Templates section

## [0.7.0] - 2026-03-09

### Added
Expand Down Expand Up @@ -130,7 +142,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Support for multiple templates (Adobe Demo Store, CitiSignal)
- Flags for non-interactive setup (`--skipGit`, `--datasource`, `--org`, `--repo`, etc.)

[Unreleased]: https://github.com/adobe-commerce/aio-cli-plugin-commerce/compare/0.7.0...HEAD
[Unreleased]: https://github.com/adobe-commerce/aio-cli-plugin-commerce/compare/1.0.0...HEAD
[1.0.0]: https://github.com/adobe-commerce/aio-cli-plugin-commerce/compare/0.7.0...1.0.0
Comment on lines +145 to +146
Copy link
Contributor

@rojoangel rojoangel Mar 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor: The compare link for 1.0.0 points to .../compare/1.0.0...HEAD. Once this PR is merged, that’s correct. If you version from a tag (e.g. v1.0.0), you might use v1.0.0 in the link for consistency with other entries. Only if your release process uses a v prefix.

[0.7.0]: https://github.com/adobe-commerce/aio-cli-plugin-commerce/compare/v0.5.0-beta.1...0.7.0
[0.5.0-beta.1]: https://github.com/adobe-commerce/aio-cli-plugin-commerce/compare/0.3.0-alpha.1...v0.5.0-beta.1
[0.3.0-alpha.1]: https://github.com/adobe-commerce/aio-cli-plugin-commerce/compare/0.2.0...0.3.0-alpha.1
Expand Down
98 changes: 3 additions & 95 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,27 +22,6 @@ functionality. Follow here: https://github.com/adobe/aio-cli/issues/679

❗ You must have the [aio CLI](https://developer.adobe.com/runtime/docs/guides/tools/cli_install/) installed.

❗ You must have the [gh CLI tool](https://cli.github.com/) installed and authenticated before using this plugin.

```sh
brew install gh
gh auth login
```

❗ The Github account used by the CLI must have permission to create repositories (_write access_) and install Github Applications on that repository.

### Mesh Prerequisites

The prerequisites in this section are only necessary if you are provisioning API Mesh for your storefront.

❗ You must have _developer access_ in [Adobe Developer Console](developer.adobe.com/console) to create Meshes. Please make sure you have the correct entitlements and also accept the terms and conditions of the Developer Console.

❗ You must also have the `api-mesh` plugin installed if you wish to use mesh provisioning.

```sh
aio plugins:install @adobe/aio-cli-plugin-api-mesh
```

❗ You must also log in to the Adobe I/O CLI using your credentials.

```sh
Expand All @@ -56,49 +35,24 @@ aio console org select

## Troubleshooting

### Name Restrictions

Due to AEM restrictions on subdomains the full project url cannot exceed 63 characters. You also cannot use the `_` character.

⚠️ Consider using a short name, and hyphens instead of underscores.

### Mesh Provisioning

If you choose a workspace with a pre-existing mesh, the mesh provisioning will fail. Create or choose an empty workspace, or delete the pre-existing mesh (only if you are sure it is unused).

### Instance Selection

Sometimes your AIO authentication can become invalid. You must first `aio logout` and then `aio login`. Also verify you are using the correct cli environment (`stage` or `prod`).

### Wrong Org

If you are already authenticated to experience.adobe.com with a specific org selected, the aio login command will use that authentication. If this does not match the org you are trying to use for CCM or API Mesh, you will need to log out and log in again.

### 404

If you see a 404 when you navigate to your storefront url, it can be due to a few reasons. Here are some steps you can take to troubleshoot:

1. **Check the URL**: Ensure that the URL you are trying to access is correct and that there are no typos. The format should be `https://{branch}--{site}--{org}.aem.live`
2. **Check AEM Code Sync Bot**: Ensure that the AEM Code Sync Bot is installed to the correct github repository. _you cannot select "all repositories"!
If you are already authenticated to experience.adobe.com with a specific org selected, the aio login command will use that authentication. If this does not match the org you are trying to use, you will need to log out and log in again.

### Further steps

If you are still having problems, please open an issue and confirm that you:

- can consistently reproduce the issue
- are able to obtain the full error output using `AIO_LOG_LEVEL=debug aio commerce init`.
- verify you have tried using the "demo" backends
- verify you have tried with and without API Mesh
- verify you deleted the mesh before using the CLI (`aio api-mesh:delete`)
- verify you have tried using unique destination repo name
- are able to obtain the full error output using `AIO_LOG_LEVEL=debug aio commerce extensibility app-setup`.
- verify you are in the correct IMS environment (`aio config set cli.env <env>`)
- verify you are authorized to the correct IMS org (`aio config get console.org`)
- Sign out of https://experience.adobe.com first before running the CLI, as this may “auto select” the wrong org
- verify you are authorized to the correct gh user gh auth status

Additionally, please:
- provide the storefront url
- provide exact steps/inputs you chose in order to reproduce the issue
Additionally, please provide exact steps/inputs you chose in order to reproduce the issue.

# Usage

Expand All @@ -112,8 +66,6 @@ $ aio plugins:install https://github.com/adobe-commerce/aio-cli-plugin-commerce#
<!-- commands -->
* [`aio commerce extensibility app-setup`](#aio-commerce-extensibility-app-setup)
* [`aio commerce extensibility tools-setup`](#aio-commerce-extensibility-tools-setup)
* [`aio commerce init`](#aio-commerce-init) _(deprecated)_
* [`aio commerce dev`](#aio-commerce-dev)

## `aio commerce extensibility app-setup`

Expand Down Expand Up @@ -154,43 +106,6 @@ This command automates the full project setup workflow for Commerce Extensibilit

All flags are optional. When omitted, the command prompts interactively. When all flags are provided, the command runs non-interactively.

## `aio commerce init`

> **⚠️ Deprecated:** This command is deprecated. Use the [Site Creator Tool](https://da.live/app/adobe-commerce/storefront-tools/tools/site-creator/site-creator) instead.

```
USAGE
$ aio commerce init [-d <value>] [-r <value>] [--skipGit] [--skipMesh] [-t <value>]

FLAGS
-d, --datasource=<value> your datasource, ie "https://my-commerce-api.com/graphql
-r, --repo=<value> your github repo, ie "my-git-user/my-test-storefront"
--skipGit skip creating Git Repo
--skipMesh skip creating API Mesh
-t, --template=<value> the template to use, ie "hlxsites/aem-boilerplate-commerce

DESCRIPTION
Scaffold your own Adobe Commerce on EDS storefront

EXAMPLES
$ aio commerce:init
$ aio commerce:init --template "hlxsites/aem-boilerplate-commerce" --skipMesh --repo "my-git-user/my-site"

```

## `aio commerce dev`

```
USAGE
$ aio commerce dev

DESCRIPTION
one command to clone, install, and run the local development server.

EXAMPLES
$ aio commerce:dev
```

## `aio commerce extensibility tools-setup`

```
Expand Down Expand Up @@ -286,13 +201,6 @@ npm install
aio plugins:link commerce
```

## Templates

The requirements for adding or using a template (source site) are:

* The source site github repo is a "template" repo.
* The source site produces a `full-index.json` (see [this](https://admin.hlx.page/config/adobe-commerce/sites/boilerplate/content/query.yaml) for example).

## Logging

Uses [winston](https://github.com/winstonjs/winston) internally.
Expand Down
5 changes: 2 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@adobe/aio-cli-plugin-commerce",
"version": "0.7.0",
"version": "1.0.0",
"dependencies": {
"@adobe/aio-cli-lib-console": "^5.0.1",
"@adobe/aio-lib-core-config": "^5",
Expand All @@ -9,8 +9,7 @@
"@adobe/aio-lib-ims": "^7.0.2",
"@inquirer/prompts": "^7.3.2",
"@oclif/core": "^4",
"@oclif/plugin-help": "^6",
"jsdom": "^25.0.1"
"@oclif/plugin-help": "^6"
},
"devDependencies": {
"@adobe/eslint-config-aio-lib-config": "^4",
Expand Down
46 changes: 0 additions & 46 deletions src/commands/commerce/dev.js

This file was deleted.

Loading