diff --git a/guides/development/start-developing.md b/guides/development/start-developing.md index bf8c895a5..793936fbb 100644 --- a/guides/development/start-developing.md +++ b/guides/development/start-developing.md @@ -78,15 +78,15 @@ make watch-admin make watch-storefront ``` -### Alternative: run build and watch scripts directly +### Alternative: use Shopware CLI -If you prefer not to use `make`, your project also provides bash scripts in the `bin/` directory to build and watch the Administration and Storefront. Run the following commands: +If you prefer not to use `make`, you can use the [Shopware CLI](https://developer.shopware.com/docs/products/cli/) to build and watch the Administration and Storefront. Run the following commands: ```bash -./bin/build-administration.sh -./bin/build-storefront.sh -./bin/watch-administration.sh -./bin/watch-storefront.sh +shopware-cli project admin-build +shopware-cli project storefront-build +shopware-cli project admin-watch +shopware-cli project storefront-watch ``` The `watch` commands monitor changes to the Administration and Storefront and automatically rebuild them. diff --git a/guides/development/tooling/using-watchers.md b/guides/development/tooling/using-watchers.md index 724bd76f5..7588b3add 100644 --- a/guides/development/tooling/using-watchers.md +++ b/guides/development/tooling/using-watchers.md @@ -23,7 +23,7 @@ composer run build:js:admin ```bash -./bin/build-administration.sh +shopware-cli project admin-build ``` @@ -39,7 +39,7 @@ composer run build:js:storefront ```bash -./bin/build-storefront.sh +shopware-cli project storefront-build ``` @@ -83,7 +83,7 @@ To enable Hot Module Reloading, use the following shell scripts in the Shopware ```bash -./bin/watch-administration.sh +shopware-cli project admin-watch ``` @@ -91,7 +91,7 @@ To enable Hot Module Reloading, use the following shell scripts in the Shopware ```bash -./bin/watch-storefront.sh +shopware-cli project storefront-watch ``` diff --git a/guides/hosting/installation-updates/deployments/build-w-o-db.md b/guides/hosting/installation-updates/deployments/build-w-o-db.md index 63ec62001..9ab90b3d9 100644 --- a/guides/hosting/installation-updates/deployments/build-w-o-db.md +++ b/guides/hosting/installation-updates/deployments/build-w-o-db.md @@ -1375,7 +1375,7 @@ index.json ### Partially compiling the Storefront -You can also build just the JavaScript bundle using `CI=1 SHOPWARE_SKIP_THEME_COMPILE=true PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true bin/build-storefront.sh` (without the need for the above loader) in your CI. After that, run `bin/console theme:dump` on your production system when the database is available. This will happen automatically if theme variables are changed via the admin panel. +You can also build just the JavaScript bundle using `CI=1 SHOPWARE_SKIP_THEME_COMPILE=true PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true shopware-cli project storefront-build` (without the need for the above loader) in your CI. After that, run `bin/console theme:dump` on your production system when the database is available. This will happen automatically if theme variables are changed via the admin panel. ## Cache directory and hash implications diff --git a/guides/plugins/plugins/administration/module-component-management/add-custom-field.md b/guides/plugins/plugins/administration/module-component-management/add-custom-field.md index 36222eadd..4c2b4047c 100644 --- a/guides/plugins/plugins/administration/module-component-management/add-custom-field.md +++ b/guides/plugins/plugins/administration/module-component-management/add-custom-field.md @@ -73,7 +73,7 @@ As mentioned above, Shopware 6 is looking for a `main.js` file in your plugin. I ```bash -./bin/build-administration.sh +shopware-cli project admin-build ``` diff --git a/guides/plugins/plugins/administration/module-component-management/add-custom-module.md b/guides/plugins/plugins/administration/module-component-management/add-custom-module.md index 7e1e082b2..e84321ac0 100644 --- a/guides/plugins/plugins/administration/module-component-management/add-custom-module.md +++ b/guides/plugins/plugins/administration/module-component-management/add-custom-module.md @@ -181,7 +181,7 @@ Given this plugin would be named "AdministrationNewModule", the bundled and mini ```bash -./bin/build-administration.sh +shopware-cli project admin-build ``` diff --git a/guides/plugins/plugins/administration/routing-navigation/add-new-tab.md b/guides/plugins/plugins/administration/routing-navigation/add-new-tab.md index 8c6b5b73e..d67a25bd0 100644 --- a/guides/plugins/plugins/administration/routing-navigation/add-new-tab.md +++ b/guides/plugins/plugins/administration/routing-navigation/add-new-tab.md @@ -144,7 +144,7 @@ Don't forget to rebuild the Administration after applying changes to your `main. ```bash -./bin/build-administration.sh +shopware-cli project admin-build ``` diff --git a/guides/plugins/plugins/dependencies/using-npm-dependencies.md b/guides/plugins/plugins/dependencies/using-npm-dependencies.md index 2be15e03c..6f811c90b 100644 --- a/guides/plugins/plugins/dependencies/using-npm-dependencies.md +++ b/guides/plugins/plugins/dependencies/using-npm-dependencies.md @@ -123,7 +123,7 @@ PluginManager.register( Build the Storefront using: ```bash -./bin/build-storefront.sh +shopware-cli project storefront-build ``` ## Next steps diff --git a/guides/plugins/plugins/storefront/howto/using-a-modal-window.md b/guides/plugins/plugins/storefront/howto/using-a-modal-window.md index b68ca553a..77bdd6ba2 100644 --- a/guides/plugins/plugins/storefront/howto/using-a-modal-window.md +++ b/guides/plugins/plugins/storefront/howto/using-a-modal-window.md @@ -150,7 +150,7 @@ To see your changes you have to build the storefront. Use the following command ```bash -./bin/build-storefront.sh +shopware-cli project storefront-build ``` diff --git a/guides/plugins/plugins/storefront/javascript/add-custom-javascript.md b/guides/plugins/plugins/storefront/javascript/add-custom-javascript.md index f7e422923..4f3c2be65 100644 --- a/guides/plugins/plugins/storefront/javascript/add-custom-javascript.md +++ b/guides/plugins/plugins/storefront/javascript/add-custom-javascript.md @@ -249,7 +249,7 @@ To see your changes you have to build the Storefront. Use the following command ```bash -./bin/build-storefront.sh +shopware-cli project storefront-build ``` diff --git a/guides/plugins/plugins/storefront/javascript/override-existing-javascript.md b/guides/plugins/plugins/storefront/javascript/override-existing-javascript.md index 792487598..b96ee201d 100644 --- a/guides/plugins/plugins/storefront/javascript/override-existing-javascript.md +++ b/guides/plugins/plugins/storefront/javascript/override-existing-javascript.md @@ -129,7 +129,7 @@ To see your changes you have to build the Storefront. Use the following command ```bash -./bin/build-storefront.sh +shopware-cli project storefront-build ``` diff --git a/guides/plugins/plugins/storefront/styling/add-custom-styling.md b/guides/plugins/plugins/storefront/styling/add-custom-styling.md index f4e14368c..c282ff69c 100644 --- a/guides/plugins/plugins/storefront/styling/add-custom-styling.md +++ b/guides/plugins/plugins/storefront/styling/add-custom-styling.md @@ -67,7 +67,7 @@ Now you want to test if your custom styles actually apply to the Storefront. For ```bash -./bin/build-storefront.sh +shopware-cli project storefront-build ``` @@ -86,7 +86,7 @@ If you want to see all style changes made by you live, you can also use our Stor ```bash -./bin/watch-storefront.sh +shopware-cli project storefront-watch ``` diff --git a/guides/plugins/themes/add-css-js-to-theme.md b/guides/plugins/themes/add-css-js-to-theme.md index a4f67d480..43b4e8d9a 100644 --- a/guides/plugins/themes/add-css-js-to-theme.md +++ b/guides/plugins/themes/add-css-js-to-theme.md @@ -91,7 +91,7 @@ Add some test code in order to see if it works out: console.log('SwagBasicExampleTheme JS loaded'); ``` -In the end, by running the command `bin/build-storefront.sh` your custom JS plugin is loaded. By default, the compiled JavaScript file is saved as `/src/resources/app/storefront/dist/storefront/js/swag-basic-example-theme/swag-basic-example-theme.js`. It is detected by Shopware automatically and included in the Storefront. So you do not need to embed the JavaScript file yourself. +In the end, by running the command `shopware-cli project storefront-build` your custom JS plugin is loaded. By default, the compiled JavaScript file is saved as `/src/resources/app/storefront/dist/storefront/js/swag-basic-example-theme/swag-basic-example-theme.js`. It is detected by Shopware automatically and included in the Storefront. So you do not need to embed the JavaScript file yourself. ## Using the hot-proxy \(live reload\) @@ -104,7 +104,7 @@ To activate the hot-proxy, run the following command in your terminal. ```bash -./bin/watch-storefront.sh +shopware-cli project storefront-watch ``` diff --git a/guides/plugins/themes/override-bootstrap-variables-in-a-theme.md b/guides/plugins/themes/override-bootstrap-variables-in-a-theme.md index 1c7c2ab42..1f3f2d9c6 100644 --- a/guides/plugins/themes/override-bootstrap-variables-in-a-theme.md +++ b/guides/plugins/themes/override-bootstrap-variables-in-a-theme.md @@ -84,7 +84,7 @@ Please only add variable overrides in this file. You should not write CSS code l ::: ::: info -When running `composer run watch:storefront` in platform only setups or `./bin/watch-storefront.sh` in the production template, SCSS variables will be injected dynamically by webpack. When writing selectors and properties in the `overrides.scss` the code can appear multiple times in your built CSS. +When running `composer run watch:storefront` in platform only setups or `shopware-cli project storefront-watch` in the production template, SCSS variables will be injected dynamically by webpack. When writing selectors and properties in the `overrides.scss` the code can appear multiple times in your built CSS. ::: ## Next steps