Nx comes with dedicated documentation for each framework:

migrate

Creates a migrations file or runs migrations from the migrations file.

  • Migrate packages and create migrations.json (e.g., nx migrate @nrwl/workspace@latest)
  • Run migrations (e.g., nx migrate --run-migrations=migrations.json)

Usage

nx migrate

Install nx globally to invoke the command directly using nx, or use npx nx, yarn nx, or pnpx nx.

Examples

Update @nrwl/workspace to "next". This will update other packages and will generate migrations.json:

nx migrate next

Update @nrwl/workspace to "9.0.0". This will update other packages and will generate migrations.json:

nx migrate 9.0.0

Update @nrwl/workspace and generate the list of migrations starting with version 8.0.0 of @nrwl/workspace and @nrwl/node, regardless of what installed locally:

nx migrate @nrwl/workspace@9.0.0 --from="@nrwl/workspace@8.0.0,@nrwl/node@8.0.0"

Update @nrwl/workspace to "9.0.0". If it tries to update @nrwl/react or @nrwl/angular, use version "9.0.1":

nx migrate @nrwl/workspace@9.0.0 --to="@nrwl/react@9.0.1,@nrwl/angular@9.0.1"

Update another-package to "12.0.0". This will update other packages and will generate migrations.json file:

nx migrate another-package@12.0.0

Run migrations from the migrations.json file. You can modify migrations.json and run this command many times:

nx migrate --run-migrations=migrations.json

Options

help

Show help

version

Show version number