Upgrade Node.js to v18 and npm to v9

This document provides instructions for upgrading Node.js to v18 and npm to v9.

According to Node.js schedule, the maintenance of version 16 stops on September 11, 2023. Therefore, we recommend migrating to the 18 LTS version.

Estimated migration time: 1h

1) Update configuration files

1. In the main *.yml files, set up new versions of node/npm, like deploy.yml, deploy.dev.yml, and deploy.ci.yml:

image:
    ...
    node:
        version: 18
        npm: 9

2. In the root directory, create or update the .nvmrc file with the following content:

18.16.0

3. In package.json, update or add dependencies and engines:

{
    ...
    "engines": {
        "node": ">=18.0.0",
        "npm": ">=9.0.0"
    },
    ...
    "devDependencies": {
        ...,
        "@babel/preset-env": "~7.20.2",
        "@spryker/oryx-for-zed": "~3.0.0",
        "autoprefixer": "~10.4.14",
        "postcss": "~8.4.24",
        "postcss-loader": "~7.3.0",
        "sass-resources-loader": "~2.2.5",
        ...
    },
    ...
}

4. In package.json, remove the dependency:

    "@spryker/sass-resources-loader": "x.x.x"

5. In frontend/configs/development.js, update the webpack config:
   1. In postcss-loader, replace options.
   2. Replace @spryker/sass-resources-loader with sass-resources-loader;

    ...
        {
            loader: 'postcss-loader',
            options: {
                postcssOptions: {
                    plugins: [
                        require('autoprefixer')
                    ]
                }
            }
        },
        ...,
        {
            loader: 'sass-resources-loader',
            options: {
                resources: [sharedScss, ...styles],
            },
        },
    ...

2) Build the project

1. Apply the docker changes:

docker/sdk boot deploy.dev.yml
docker/sdk up

2. Regenerate package-lock.json:

docker/sdk cli npm install

rm -rf node_modules && docker/sdk cli rm -rf node_modules && rm -rf package-lock.json
docker/sdk cli npm install

3. Build the project using Node.js v18 and npm v9:

rm -rf node_modules && docker/sdk cli rm -rf node_modules
docker/sdk up --build --assets --data

node -v
npm -v

3) Update GitHub Actions

If the project uses CI, adjust .github/workflows/ci.yml:

1. Update Node.js version:

- uses: actions/setup-node@v3
    with:
      node-version: '18'

2. Remove npm cache:

- name: NPM cache
  uses: actions/cache@v3
  with:
    path: ~/.npm
    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
    restore-keys: |
      ${{ runner.os }}-node-