From be965a7f925cf58deab9ee73b59605c6ae705572 Mon Sep 17 00:00:00 2001 From: Soner Sayakci Date: Wed, 11 Feb 2026 05:03:24 +0100 Subject: [PATCH 1/3] feat: add compatibility-date --- products/cli/extension-commands/configuration.md | 16 ++++++++++++++++ products/cli/project-commands/build.md | 16 ++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/products/cli/extension-commands/configuration.md b/products/cli/extension-commands/configuration.md index 886ec833bb..0aa6d0b614 100644 --- a/products/cli/extension-commands/configuration.md +++ b/products/cli/extension-commands/configuration.md @@ -12,6 +12,8 @@ Many configurations can be changed using a `.shopware-extension.yml` file in the Here is an example of a `.shopware-extension.yml` file: ```yaml +compatibility_date: '2026-02-11' + build: extraBundles: - path: src/Foo @@ -42,6 +44,20 @@ validation: When you edit that file in an editor, you will get autocompletion and hints for the available options. +## compatibility_date + +You can define a `compatibility_date` in `.shopware-extension.yml`: + +```yaml +compatibility_date: '2026-02-11' +``` + +The `compatibility_date` lets Shopware CLI introduce behavior changes without breaking existing projects by default. New or potentially breaking changes are activated only for configurations that opt in with a date at or after the feature's rollout date. + +- Format: `YYYY-MM-DD` +- If the field is missing, Shopware CLI uses `2026-02-11` as fallback +- When missing, Shopware CLI logs a warning during config loading + ## Environment variables Additionally, you can set environment variables to change the behavior of the CLI. The following environment variables are available: diff --git a/products/cli/project-commands/build.md b/products/cli/project-commands/build.md index f7e5058bfe..2030915804 100644 --- a/products/cli/project-commands/build.md +++ b/products/cli/project-commands/build.md @@ -105,6 +105,8 @@ MJML compilation requires the `mjml` package to be installed via NPM in your bui You can configure the build process with a `.shopware-project.yml` file. The following options are available: ```yaml +compatibility_date: '2026-02-11' + build: # Browserlist configuration for Storefront browserslist: 'defaults' @@ -134,6 +136,20 @@ build: - custom/static-plugins ``` +## compatibility_date + +You can define a `compatibility_date` in `.shopware-project.yml`: + +```yaml +compatibility_date: '2026-02-11' +``` + +The `compatibility_date` lets Shopware CLI introduce behavior changes without breaking existing projects by default. New or potentially breaking changes are activated only for configurations that opt in with a date at or after the feature's rollout date. + +- Format: `YYYY-MM-DD` +- If the field is missing, Shopware CLI uses `2026-02-11` as fallback +- When missing, Shopware CLI logs a warning during config loading + ## Supporting bundles Shopware CLI automatically detects plugins and Apps. Custom bundles (classes that extend bundle class from Shopware) cannot be automatically detected as Shopware CLI does not execute any PHP code. From 10ded283de09b74bf4a61935e6399f20f50cb66f Mon Sep 17 00:00:00 2001 From: Su <112690947+sushmangupta@users.noreply.github.com> Date: Wed, 4 Mar 2026 07:41:35 +0100 Subject: [PATCH 2/3] Update products/cli/project-commands/build.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/cli/project-commands/build.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/cli/project-commands/build.md b/products/cli/project-commands/build.md index b8ef1478e0..aba6f3fcb1 100644 --- a/products/cli/project-commands/build.md +++ b/products/cli/project-commands/build.md @@ -192,7 +192,7 @@ build: post-assets: [] ``` -## compatibility_date +## Compatibility date You can define a `compatibility_date` in `.shopware-project.yml`: From 118e0fe64bfe7d12c7840b53c44be9ffcfbbf372 Mon Sep 17 00:00:00 2001 From: Su <112690947+sushmangupta@users.noreply.github.com> Date: Wed, 4 Mar 2026 07:41:41 +0100 Subject: [PATCH 3/3] Update products/cli/extension-commands/configuration.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/cli/extension-commands/configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/cli/extension-commands/configuration.md b/products/cli/extension-commands/configuration.md index 0aa6d0b614..030e394823 100644 --- a/products/cli/extension-commands/configuration.md +++ b/products/cli/extension-commands/configuration.md @@ -44,7 +44,7 @@ validation: When you edit that file in an editor, you will get autocompletion and hints for the available options. -## compatibility_date +## Compatibility date You can define a `compatibility_date` in `.shopware-extension.yml`: