#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"
  }
}