3.20 -> 3.21

This page lists the highlights for upgrading a project from Front-Commerce 3.20 to 3.21

Update dependencies

Update all your @front-commerce/* dependencies to this version:

pnpm update "@front-commerce/*@3.21.0"

Automated Migration

We provide a codemod to automatically update your codebase to the latest version of Front-Commerce. This tool will update your code when possible.

pnpm run front-commerce migrate --transform 3.21.0

Manual Migration

Node.js 20 is no longer supported

Node.js 20 reached its End of Life on April 30, 2026. Front-Commerce 3.21 drops support for it entirely.

Supported versions: ^22.22.0 || ^24.14.0

1. Update your Node.js version

Ensure your local environment, CI pipelines, and production servers run Node.js 22.22.0+ or Node.js 24.14.0+.

node -v
# Must output v22.22.x or v24.14.x (or higher)

2. Update your package.json

Update the engines field in your project's package.json:

package.json

  "engines": {
-   "node": "^20.19.0 || ^22.13.0 || ^24.11.0"
+   "node": "^22.22.0 || ^24.14.0"
  }

3. Update your Docker images (if applicable)

If you use Docker for CI or deployment, update your Node.js base images:

Dockerfile

- FROM node:20-bookworm-slim
+ FROM node:22-bookworm-slim

4. Update @types/node (if applicable)

If your project has a direct dependency on @types/node, update it to match the new minimum version:

package.json

  "devDependencies": {
-   "@types/node": "20.19.39",
+   "@types/node": "22.19.17",
  }