Upgrading#

Upgrade with command#

Modern.js provides the upgrade command to support upgrading the project to the latest version of Modern.js.

Run the upgrade script in the project:

npm run upgrade

> modern upgrade

[INFO] [Project Type]: Web App
[INFO] [Modern.js Latest Version]: x.y.z
[INFO] Upgrade Modern.js package version success!

You can see that the dependencies in the project's package.json have been updated to the latest version.

Upgrade to a specified version#

All packages of Modern.js are currently released with a uniform version number.

According to the Release Note on the official website, developers can also manually upgrade the project to the desired version.

Version Management Strategy#

In Modern.js projects, we recommend that all officially provided dependencies use fixed version, and avoid using ^ or ~ for range declarations. For example:

{
  "dependencies": {
    "@modern-js/app-tools": "x.y.z"
  }
}

This ensures that the versions of dependencies are fully determined, thereby guaranteeing build consistency and predictability.

Lock nested dependency#

When a nested dependency of the project has a problem and Modern.js cannot be updated immediately, you can use the package manager to lock the version of the nested dependency.

pnpm#

For projects using pnpm, add the following configuration to the package.json in the root directory of the project, and then run pnpm install again:

{
  "pnpm": {
    "overrides": {
      "package-name": "^1.0.0"
    }
  }
}

Yarn#

For projects using Yarn, add the following configuration to the package.json in the root directory of the project, and then run yarn install again:

{
  "resolutions": {
    "package-name": "^1.0.0"
  }
}

Npm#

For projects using Npm, add the following configuration to the package.json in the root directory of the project, and then run npm install again:

{
  "overrides": {
    "package-name": "^1.0.0"
  }
}