Configure NPM to be able to use PWA Studio

Last update: December 14, 2022

Progressive Web Apps (PWA) Studio is a new project available for Adobe Commerce on cloud infrastructure 2.3.x or later. To be able to use and install PWA Studio, you need to set the NPM package manager version to 5.x or later to get support for Node.js 8.x. This is done in the hooks:build section of the .magento.app.yaml configuration file.

Environment and technologies

Adobe Commerce on cloud infrastructure 2.3.X
PWA for Adobe Commerce

Set NPM version: steps

To set the needed NPM version, specify it in the .magento.app.yaml configuration file. Follow these steps:

On your local development environment, locate the .magento.app.yaml configuration file.
Open the file for editing using your plain text editor or IDE.

Set the required version in the hooks:build section. In the following example, the configuration is set to install NPM v9.5.0, the highest available at the moment (February 4, 2019):

hooks:
    build: |
        unset NPM_CONFIG_PREFIX
        curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash
        export NVM_DIR="$HOME/.nvm"
        [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
        nvm install 9.5.0

NOTE

If you want to run Node.JS in your application and not just in your build, please add the following commands to change your build hook:



echo ‘unset NPM_CONFIG_PREFIX’ >> .environment

echo ‘export NO_UPDATE_NOTIFIER=1’ >> .environment

echo ‘export NVM_DIR=“$MAGENTO_CLOUD_DIR/.nvm”’ >> .environment

echo ‘[ -s “$NVM_DIR/nvm.sh” ] && . “$NVM_DIR/nvm.sh”’ >> .environment

Save changes in the file.
Git push the edited file to your integration environment.

The changes come into effect after you Git push the updated YAML file to the environment.

Application configuration: hooks in our Adobe Commerce on Cloud Infrastructure Guide.

recommendation-more-help

Configure NPM to be able to use PWA Studio

Environment and technologies

Set NPM version: steps

Related documentation