Magento mode upgrade

Upgrade ScandiPWA in Magento theme mode to the newer version

The following steps must be completed to update to the newer ScandiPWA version:

1. Update the version of @scandipwa/scandipwa

2. Update the composer.json dependencies

3. Update the Magento 2 dependencies

1. Update the version of @scandipwa/scandipwa

Go to your ScandiPWA theme root directory and run the following:

Yarn

yarn add @scandipwa/scandipwa@latest

NPM

npm install @scandipwa/scandipwa@latest

2. Update the composer.json dependencies

To update the Composer dependencies of your ScandiPWA theme, first, build or start the application:

Heads up!

When upgrading, the build or start of the application might throw an error asking you to upgrade the composer.json! This is expected.

Yarn

yarn start

NPM

npm run start

Complete the instructions indicated in error, for example following error:

Must indicate, that you must bump the scandipwa/customer-graph-ql to a newer version (^3). You can do it in composer.json.

Another way to quickly resolve this is to copy the require field of your theme's parent theme. This is, however, not safe as it might omit some extension's dependencies.

3. Update the Magento 2 dependencies

Heads up!

It might be required to delete composer.lock file andvendor directory to ensure the changes in ScandiPWA's theme composer will be respected.

Go to your Magento 2 root directory and run the following:

composer update

Upgrade the CSA and CMA

To make sure all the features of the new ScandiPWA are working correctly, make sure to stay on the latest toolchains. Follow the guides below to upgrade them:

CSA upgrade

CMA upgrade