Important: This documentation covers Yarn 2. For the 1.x doc, check classic.yarnpkg.com.
Yarn
yarn addyarn binyarn cache cleanyarn config getyarn config setyarn configyarn constraints queryyarn constraints sourceyarn constraintsyarn dlxyarn inityarn installyarn linkyarn nodeyarn npm infoyarn npm loginyarn npm publishyarn npm whoamiyarn packyarn patch-commityarn patchyarn plugin importyarn plugin listyarn plugin runtimeyarn rebuildyarn removeyarn runyarn set resolutionyarn set version from sourcesyarn set versionyarn stageyarn unplugyarn upyarn upgrade-interactiveyarn version applyyarn version checkyarn versionyarn whyyarn workspaceyarn workspaces foreachyarn workspaces list

yarn version

Apply a new version to the current package.

Usage

$> yarn version [-d,--deferred] [-i,--immediate] [-f,--force] <strategy>

Examples

Immediatly bump the version to the next major :

yarn version major

Prepare the version to be bumped to the next major :

yarn version major --deferred

Details

This command will bump the version number for the given package, following the specified strategy:

  • If major, the first number from the semver range will be increased (X.0.0).

  • If minor, the second number from the semver range will be increased (0.X.0).

  • If patch, the third number from the semver range will be increased (0.0.X).

  • If prefixed by pre (premajor, ...), a -0 suffix will be set (0.0.0-0).

  • If prerelease, the suffix will be increased (0.0.0-X); the third number from the semver range will also be increased if there was no suffix in the previous version.

  • If decline, the nonce will be increased for yarn version check to pass without version bump.

  • If a valid semver range, it will be used as new version.

  • If unspecified, Yarn will ask you for guidance.

For more information about the --deferred flag, consult our documentation ("Managing Releases").