docs: replace deprecated bin/build-*/watch-* scripts with shopware-cli commands#2287
Open
Soner (shyim) wants to merge 1 commit into
Open
docs: replace deprecated bin/build-*/watch-* scripts with shopware-cli commands#2287Soner (shyim) wants to merge 1 commit into
Soner (shyim) wants to merge 1 commit into
Conversation
…i commands The ./bin/build-administration.sh, ./bin/build-storefront.sh, ./bin/watch-administration.sh, and ./bin/watch-storefront.sh scripts have been deprecated in favor of shopware-cli equivalents: - shopware-cli project admin-build - shopware-cli project storefront-build - shopware-cli project admin-watch - shopware-cli project storefront-watch
Soner (shyim)
requested review from
Micha Hobert (Isengo1989) and
somethings (lasomethingsomething)
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates documentation across 13 files to replace deprecated ./bin/build-*.sh and ./bin/watch-*.sh shell scripts with the equivalent shopware-cli project ... commands, aligning the docs with the production template's new tooling.
Changes:
- Replace
./bin/build-{administration,storefront}.shreferences withshopware-cli project {admin,storefront}-build. - Replace
./bin/watch-{administration,storefront}.shreferences withshopware-cli project {admin,storefront}-watch. - Rework the "Alternative" section in
start-developing.mdto point readers to the Shopware CLI.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| guides/development/start-developing.md | Rewords alternative-tooling section and switches commands to shopware-cli. |
| guides/development/tooling/using-watchers.md | Updates build/watch tab examples to shopware-cli commands. |
| guides/hosting/installation-updates/deployments/build-w-o-db.md | Updates partial storefront build example to shopware-cli. |
| guides/plugins/plugins/administration/module-component-management/add-custom-field.md | Replaces admin build command. |
| guides/plugins/plugins/administration/module-component-management/add-custom-module.md | Replaces admin build command. |
| guides/plugins/plugins/administration/routing-navigation/add-new-tab.md | Replaces admin build command. |
| guides/plugins/plugins/dependencies/using-npm-dependencies.md | Replaces storefront build command. |
| guides/plugins/plugins/storefront/howto/using-a-modal-window.md | Replaces storefront build command. |
| guides/plugins/plugins/storefront/javascript/add-custom-javascript.md | Replaces storefront build command. |
| guides/plugins/plugins/storefront/javascript/override-existing-javascript.md | Replaces storefront build command. |
| guides/plugins/plugins/storefront/styling/add-custom-styling.md | Replaces storefront build/watch commands. |
| guides/plugins/themes/add-css-js-to-theme.md | Replaces storefront build/watch commands. |
| guides/plugins/themes/override-bootstrap-variables-in-a-theme.md | Updates inline mention of watch script. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
somethings (lasomethingsomething)
approved these changes
May 19, 2026
Contributor
somethings (lasomethingsomething)
left a comment
somethings (lasomethingsomething)
left a comment
There was a problem hiding this comment.
lgtm
Michael Telgmann (mitelg)
approved these changes
May 20, 2026
Joshua Behrens (JoshuaBehrens)
suggested changes
May 20, 2026
Contributor
Joshua Behrens (JoshuaBehrens)
left a comment
Joshua Behrens (JoshuaBehrens)
left a comment
There was a problem hiding this comment.
Also check the other files where necessary
|
|
||
| ## Prerequisites | ||
|
|
||
| All you need for this guide is a running Shopware 6 instance and full access to both the files, as well as the command line. You also need to have an installed and activated theme which is assigned to a sales channel. Checkout the [Create a first theme](create-a-theme) guide if you have not yet a working theme setup. |
Contributor
There was a problem hiding this comment.
Add "installed shopware-cli" as prequisite. You shipped the other scripts right away, shopware-cli is not shipped with the template
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
see also shopware/recipes@690adcf
The
./bin/build-administration.sh,./bin/build-storefront.sh,./bin/watch-administration.sh, and./bin/watch-storefront.shscripts have been deprecated in favor of the Shopware CLI equivalents:./bin/build-administration.shshopware-cli project admin-build./bin/build-storefront.shshopware-cli project storefront-build./bin/watch-administration.shshopware-cli project admin-watch./bin/watch-storefront.shshopware-cli project storefront-watchChanges
Updated all documentation references across 13 files to point to
shopware-clicommands instead of the deprecated./bin/*.shscripts.