@nx/angular - Migrations
The @nx/angular plugin provides various migrations to help you migrate to newer versions of angular projects within your Nx workspace. Below is a complete reference for all available migrations.
21.5.x
set-tsconfig-option
Set the ‘tsConfig’ option to build and test targets to help with Angular migration issues.
21.4.x
Package Updates for 21.4.0-ngrx
The following packages will be updated:
| Package | Version |
|---|---|
@ngrx/store | ^20.0.0 |
21.3.x
update-angular-cli-version-20-1-0
Update the @angular/cli package version to ~20.1.0.
Package Updates for 21.3.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~20.1.0 |
@angular-devkit/core | ~20.1.0 |
@angular-devkit/schematics | ~20.1.0 |
@angular/build | ~20.1.0 |
@angular/pwa | ~20.1.0 |
@angular/ssr | ~20.1.0 |
@schematics/angular | ~20.1.0 |
@angular-devkit/architect | ~0.2001.0 |
@angular-devkit/build-webpack | ~0.2001.0 |
@angular/core | ~20.1.0 |
@angular/material | ~20.1.0 |
@angular/cdk | ~20.1.0 |
@angular/google-maps | ~20.1.0 |
ng-packagr | ~20.1.0 |
Package Updates for 21.3.5-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~15.0.0 |
21.2.x
update-angular-cli-version-20-0-0
Update the @angular/cli package version to ~20.0.0.
migrate-provide-server-rendering-import
Migrate imports of provideServerRendering from @angular/platform-server to @angular/ssr.
replace-provide-server-routing
Replace provideServerRouting and provideServerRoutesConfig with provideServerRendering using withRoutes.
set-generator-defaults-for-previous-style-guide
Update the generator defaults to maintain the previous style guide behavior.
update-module-resolution
Update ‘moduleResolution’ to ‘bundler’ in TypeScript configurations. You can read more about this here: https://www.typescriptlang.org/tsconfig/#moduleResolution.
Package Updates for 21.2.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~20.0.0 |
@angular-devkit/core | ~20.0.0 |
@angular-devkit/schematics | ~20.0.0 |
@angular/build | ~20.0.0 |
@angular/pwa | ~20.0.0 |
@angular/ssr | ~20.0.0 |
@schematics/angular | ~20.0.0 |
@angular-devkit/architect | ~0.2000.0 |
@angular-devkit/build-webpack | ~0.2000.0 |
@angular/core | ~20.0.0 |
@angular/material | ~20.0.0 |
@angular/cdk | ~20.0.0 |
@angular/google-maps | ~20.0.0 |
ng-packagr | ~20.0.0 |
Package Updates for 21.2.0-angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
angular-eslint | ^20.0.0 |
Package Updates for 21.2.0-@angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
@angular-eslint/eslint-plugin | ^20.0.0 |
@angular-eslint/eslint-plugin-template | ^20.0.0 |
@angular-eslint/template-parser | ^20.0.0 |
@angular-eslint/utils | ^20.0.0 |
@angular-eslint/schematics | ^20.0.0 |
@angular-eslint/test-utils | ^20.0.0 |
@angular-eslint/builder | ^20.0.0 |
@angular-eslint/bundled-angular-compiler | ^20.0.0 |
Package Updates for 21.2.0-angular-rspack
The following packages will be updated:
| Package | Version |
|---|---|
@nx/angular-rspack | ^21.1.0 |
Package Updates for 21.2.0-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~14.6.0 |
21.1.x
Package Updates for 21.1.0
The following packages will be updated:
| Package | Version |
|---|---|
@nx/angular-rspack | ^21.0.1 |
21.0.x
set-continuous-option
Set the continuous option to true for continuous tasks.
change-data-persistence-operators-imports-to-ngrx-router-store-data-persistence
Change the data persistence operator imports to ‘@ngrx/router-store/data-persistence’.
20.8.x
Package Updates for 20.8.1
The following packages will be updated:
| Package | Version |
|---|---|
@nx/angular-rspack | ^20.7.0 |
20.5.x
update-angular-cli-version-19-2-0
Update the @angular/cli package version to ~19.2.0.
Package Updates for 20.5.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~19.2.0 |
@angular-devkit/core | ~19.2.0 |
@angular-devkit/schematics | ~19.2.0 |
@angular/build | ~19.2.0 |
@angular/pwa | ~19.2.0 |
@angular/ssr | ~19.2.0 |
@schematics/angular | ~19.2.0 |
@angular-devkit/architect | ~0.1902.0 |
@angular-devkit/build-webpack | ~0.1902.0 |
@angular/core | ~19.2.0 |
@angular/material | ~19.2.1 |
@angular/cdk | ~19.2.1 |
@angular/google-maps | ~19.2.1 |
ng-packagr | ~19.2.0 |
Package Updates for 20.5.0-angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
angular-eslint | ^19.2.0 |
@angular-eslint/eslint-plugin | ^19.2.0 |
@angular-eslint/eslint-plugin-template | ^19.2.0 |
@angular-eslint/template-parser | ^19.2.0 |
@angular-eslint/utils | ^19.2.0 |
@angular-eslint/schematics | ^19.2.0 |
@angular-eslint/test-utils | ^19.2.0 |
@angular-eslint/builder | ^19.2.0 |
@angular-eslint/bundled-angular-compiler | ^19.2.0 |
20.4.x
update-angular-cli-version-19-1-0
Update the @angular/cli package version to ~19.1.0.
Package Updates for 20.4.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~19.1.0 |
@angular-devkit/core | ~19.1.0 |
@angular-devkit/schematics | ~19.1.0 |
@angular/build | ~19.1.0 |
@angular/pwa | ~19.1.0 |
@angular/ssr | ~19.1.0 |
@schematics/angular | ~19.1.0 |
@angular-devkit/architect | ~0.1901.0 |
@angular-devkit/build-webpack | ~0.1901.0 |
@angular/core | ~19.1.0 |
@angular/material | ~19.1.0 |
@angular/cdk | ~19.1.0 |
@angular/google-maps | ~19.1.0 |
ng-packagr | ~19.1.0 |
20.3.x
ensure-nx-module-federation-package
If workspace includes Module Federation projects, ensure the new @nx/module-federation package is installed.
Package Updates for 20.2.3-ngrx
The following packages will be updated:
| Package | Version |
|---|---|
@ngrx/store | ^19.0.0 |
20.2.x
update-20-2-0-update-module-federation-config-import
Update the ModuleFederationConfig import use @nx/module-federation.
update-20-2-0-update-with-module-federation-import
Update the withModuleFederation import use @nx/module-federation/angular.
update-angular-cli-version-19-0-0
Update the @angular/cli package version to ~19.0.0.
add-localize-polyfill-to-targets
Add the ‘@angular/localize/init’ polyfill to the ‘polyfills’ option of targets using esbuild-based executors.
update-angular-ssr-imports-to-use-node-entry-point
Update ‘@angular/ssr’ import paths to use the new ‘/node’ entry point when ‘CommonEngine’ is detected.
disable-angular-eslint-prefer-standalone
Disable the Angular ESLint prefer-standalone rule if not set.
remove-angular-eslint-rules
Remove Angular ESLint rules that were removed in v19.0.0.
remove-tailwind-config-from-ng-packagr-executors
Remove the deprecated ‘tailwindConfig’ option from ng-packagr executors. Tailwind CSS configurations located at the project or workspace root will be picked up automatically.
Package Updates for 20.2.0-module-federation
The following packages will be updated:
| Package | Version |
|---|---|
@module-federation/enhanced | 0.7.6 |
@module-federation/runtime | 0.7.6 |
@module-federation/sdk | 0.7.6 |
@module-federation/node | 2.6.11 |
Package Updates for 20.2.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~19.0.0 |
@angular-devkit/core | ~19.0.0 |
@angular-devkit/schematics | ~19.0.0 |
@angular/build | ~19.0.0 |
@angular/pwa | ~19.0.0 |
@angular/ssr | ~19.0.0 |
@schematics/angular | ~19.0.0 |
@angular-devkit/architect | ~0.1900.0 |
@angular-devkit/build-webpack | ~0.1900.0 |
@angular/core | ~19.0.0 |
@angular/material | ~19.0.0 |
@angular/cdk | ~19.0.0 |
@angular/google-maps | ~19.0.0 |
ng-packagr | ~19.0.0 |
zone.js | ~0.15.0 |
Package Updates for 20.2.0-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~14.4.0 |
Package Updates for 20.2.0-angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
angular-eslint | ^19.0.0 |
@angular-eslint/eslint-plugin | ^19.0.0 |
@angular-eslint/eslint-plugin-template | ^19.0.0 |
@angular-eslint/template-parser | ^19.0.0 |
@angular-eslint/utils | ^19.0.0 |
@angular-eslint/schematics | ^19.0.0 |
@angular-eslint/test-utils | ^19.0.0 |
@angular-eslint/builder | ^19.0.0 |
@angular-eslint/bundled-angular-compiler | ^19.0.0 |
Package Updates for 20.2.0-analog
The following packages will be updated:
| Package | Version |
|---|---|
@analogjs/vitest-angular | ~1.10.0 |
@analogjs/vite-plugin-angular | ~1.10.0 |
Package Updates for 20.2.2-angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
angular-eslint | ^19.0.2 |
@angular-eslint/eslint-plugin | ^19.0.2 |
@angular-eslint/eslint-plugin-template | ^19.0.2 |
@angular-eslint/template-parser | ^19.0.2 |
@angular-eslint/utils | ^19.0.2 |
@angular-eslint/schematics | ^19.0.2 |
@angular-eslint/test-utils | ^19.0.2 |
@angular-eslint/builder | ^19.0.2 |
@angular-eslint/bundled-angular-compiler | ^19.0.2 |
19.7.x
Package Updates for 19.7.0
The following packages will be updated:
| Package | Version |
|---|---|
@module-federation/enhanced | ~0.6.0 |
@module-federation/node | ~2.5.0 |
19.6.x
update-19-6-0
Ensure Module Federation DTS is turned off by default.
update-angular-cli-version-18-2-0
Update the @angular/cli package version to ~18.2.0.
update-19-6-1-ensure-module-federation-target-defaults
Ensure Target Defaults are set correctly for Module Federation.
Package Updates for 19.6.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~18.2.0 |
@angular-devkit/core | ~18.2.0 |
@angular-devkit/schematics | ~18.2.0 |
@angular/build | ~18.2.0 |
@angular/pwa | ~18.2.0 |
@angular/ssr | ~18.2.0 |
@schematics/angular | ~18.2.0 |
@angular-devkit/architect | ~0.1802.0 |
@angular-devkit/build-webpack | ~0.1802.0 |
@angular/core | ~18.2.0 |
@angular/material | ~18.2.0 |
@angular/cdk | ~18.2.0 |
ng-packagr | ~18.2.0 |
zone.js | ~0.14.10 |
Package Updates for 19.6.1-ngrx
The following packages will be updated:
| Package | Version |
|---|---|
@ngrx/store | ^18.0.2 |
19.5.x
update-angular-cli-version-18-1-0
Update the @angular/cli package version to ~18.1.0.
Package Updates for 19.5.0-module-federation
The following packages will be updated:
| Package | Version |
|---|---|
@module-federation/node | ^2.3.0 |
Package Updates for 19.5.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~18.1.0 |
@angular-devkit/core | ~18.1.0 |
@angular-devkit/schematics | ~18.1.0 |
@angular/build | ~18.1.0 |
@angular/pwa | ~18.1.0 |
@angular/ssr | ~18.1.0 |
@schematics/angular | ~18.1.0 |
@angular-devkit/architect | ~0.1801.0 |
@angular-devkit/build-webpack | ~0.1801.0 |
@angular/core | ~18.1.0 |
@angular/material | ~18.1.0 |
@angular/cdk | ~18.1.0 |
ng-packagr | ~18.1.0 |
Package Updates for 19.5.4-ngrx
The following packages will be updated:
| Package | Version |
|---|---|
@ngrx/store | ^18.0.1 |
@ngrx/operators | ^18.0.1 |
19.4.x
Package Updates for 19.4.0-ngrx
The following packages will be updated:
| Package | Version |
|---|---|
@ngrx/store | ^18.0.0 |
19.2.x
add-typescript-eslint-utils
Installs the ‘@typescript-eslint/utils’ package when having installed ‘@angular-eslint/eslint-plugin’ or ‘@angular-eslint/eslint-plugin-template’ with version >=18.0.0.
19.1.x
update-angular-cli-version-18-0-0
Update the @angular/cli package version to ~18.0.0.
Package Updates for 19.1.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~18.0.0 |
@angular-devkit/core | ~18.0.0 |
@angular-devkit/schematics | ~18.0.0 |
@angular/pwa | ~18.0.0 |
@angular/ssr | ~18.0.0 |
@schematics/angular | ~18.0.0 |
@angular-devkit/architect | ~0.1800.0 |
@angular-devkit/build-webpack | ~0.1800.0 |
@angular/core | ~18.0.0 |
@angular/material | ~18.0.0 |
@angular/cdk | ~18.0.0 |
ng-packagr | ~18.0.0 |
Package Updates for 19.1.0-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~14.1.0 |
Package Updates for 19.1.2
The following packages will be updated:
| Package | Version |
|---|---|
@angular-eslint/eslint-plugin | ^18.0.1 |
@angular-eslint/eslint-plugin-template | ^18.0.1 |
@angular-eslint/template-parser | ^18.0.1 |
@angular-eslint/utils | ^18.0.1 |
@angular-eslint/schematics | ^18.0.1 |
@angular-eslint/test-utils | ^18.0.1 |
@angular-eslint/builder | ^18.0.1 |
@angular-eslint/bundled-angular-compiler | ^18.0.1 |
18.2.x
update-angular-cli-version-17-3-0
Update the @angular/cli package version to ~17.3.0.
Package Updates for 18.2.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~17.3.0 |
@angular-devkit/core | ~17.3.0 |
@angular-devkit/schematics | ~17.3.0 |
@angular/pwa | ~17.3.0 |
@angular/ssr | ~17.3.0 |
@schematics/angular | ~17.3.0 |
@angular-devkit/architect | ~0.1703.0 |
@angular-devkit/build-webpack | ~0.1703.0 |
@angular/core | ~17.3.0 |
@angular/material | ~17.3.0 |
@angular/cdk | ~17.3.0 |
ng-packagr | ~17.3.0 |
Package Updates for 18.2.0-angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
@angular-eslint/eslint-plugin | ~17.3.0 |
@angular-eslint/eslint-plugin-template | ~17.3.0 |
@angular-eslint/template-parser | ~17.3.0 |
18.1.x
update-angular-cli-version-17-2-0
Update the @angular/cli package version to ~17.2.0.
fix-target-defaults-for-webpack-browser
Ensure targetDefaults inputs for task hashing when ‘@nx/angular:webpack-browser’ is used are correct for Module Federation.
Package Updates for 18.1.0-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~14.0.3 |
Package Updates for 18.1.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~17.2.0 |
@angular-devkit/core | ~17.2.0 |
@angular-devkit/schematics | ~17.2.0 |
@angular/pwa | ~17.2.0 |
@angular/ssr | ~17.2.0 |
@schematics/angular | ~17.2.0 |
@angular-devkit/architect | ~0.1702.0 |
@angular-devkit/build-webpack | ~0.1702.0 |
@angular/core | ~17.2.0 |
@angular/material | ~17.2.0 |
@angular/cdk | ~17.2.0 |
ng-packagr | ~17.2.0 |
18.0.x
add-module-federation-env-var-to-target-defaults
Add NX_MF_DEV_SERVER_STATIC_REMOTES to inputs for task hashing when ‘@nx/angular:webpack-browser’ is used for Module Federation.
17.3.x
update-angular-cli-version-17-1-0
Update the @angular/cli package version to ~17.1.0.
add-browser-sync-dependency
Add ‘browser-sync’ as dev dependency when ‘@angular-devkit/build-angular:ssr-dev-server’ or ‘@nx/angular:module-federation-dev-ssr’ is used.
add-autoprefixer-dependency
Add ‘autoprefixer’ as dev dependency when ‘@nx/angular:ng-packagr-lite’ or ‘@nx/angular:package` is used.
Package Updates for 17.3.0-types-node
The following packages will be updated:
| Package | Version |
|---|---|
@types/node | ^18.16.9 |
Package Updates for 17.3.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/build-angular | ~17.1.0 |
@angular-devkit/core | ~17.1.0 |
@angular-devkit/schematics | ~17.1.0 |
@angular/pwa | ~17.1.0 |
@angular/ssr | ~17.1.0 |
@schematics/angular | ~17.1.0 |
@angular-devkit/architect | ~0.1701.0 |
@angular-devkit/build-webpack | ~0.1701.0 |
@angular/core | ~17.1.0 |
@angular/material | ~17.1.0 |
@angular/cdk | ~17.1.0 |
ng-packagr | ~17.1.0 |
zone.js | ~0.14.3 |
17.2.x
rename-webpack-dev-server-executor
Rename ‘@nx/angular:webpack-dev-server’ executor to ‘@nx/angular:dev-server’
Package Updates for 17.2.0-ngrx
The following packages will be updated:
| Package | Version |
|---|---|
@ngrx/store | ~17.0.0 |
17.1.x
update-angular-cli-version-17-0-0
Update the @angular/cli package version to ~17.0.0.
rename-browser-target-to-build-target
Rename ‘browserTarget’ to ‘buildTarget’.
replace-nguniversal-builders
Replace usages of ‘@nguniversal/builders’ with ‘@angular-devkit/build-angular’.
replace-nguniversal-engines
Replace usages of ‘@nguniversal/’ packages with ‘@angular/ssr’.
update-zone-js-deep-import
Replace the deep imports from ‘zone.js/dist/zone’ and ‘zone.js/dist/zone-testing’ with ‘zone.js’ and ‘zone.js/testing’.
Package Updates for 17.1.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/architect | ~0.1700.0 |
@angular-devkit/build-angular | ~17.0.0 |
@angular-devkit/build-webpack | ~0.1700.0 |
@angular-devkit/core | ~17.0.0 |
@angular-devkit/schematics | ~17.0.0 |
@angular/pwa | ~17.0.0 |
@angular/core | ~17.0.0 |
@angular/material | ~17.0.0 |
@angular/cdk | ~17.0.0 |
@schematics/angular | ~17.0.0 |
ng-packagr | ~17.0.0 |
zone.js | ~0.14.0 |
Package Updates for 17.1.0-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~13.1.3 |
Package Updates for 17.1.0-angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
@angular-eslint/eslint-plugin | ~17.0.0 |
@angular-eslint/eslint-plugin-template | ~17.0.0 |
@angular-eslint/template-parser | ~17.0.0 |
Package Updates for 17.1.3-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~13.1.4 |
16.8.x
Package Updates for 16.8.0
The following packages will be updated:
| Package | Version |
|---|---|
esbuild | ^0.19.2 |
16.7.x
update-angular-cli-version-16-2-0
Update the @angular/cli package version to ~16.2.0.
Package Updates for 16.7.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/architect | ~0.1602.0 |
@angular-devkit/build-angular | ~16.2.0 |
@angular-devkit/build-webpack | ~0.1602.0 |
@angular-devkit/core | ~16.2.0 |
@angular-devkit/schematics | ~16.2.0 |
@angular/pwa | ~16.2.0 |
@angular/core | ~16.2.0 |
@angular/material | ~16.2.0 |
@angular/cdk | ~16.2.0 |
@nguniversal/builders | ~16.2.0 |
@nguniversal/common | ~16.2.0 |
@nguniversal/express-engine | ~16.2.0 |
@schematics/angular | ~16.2.0 |
ng-packagr | ~16.2.0 |
16.6.x
explicitly-set-projects-to-update-buildable-deps
Explicitly set ‘updateBuildableProjectDepsInPackageJson’ to ‘true’ in targets that rely on that value as the default.
16.4.x
rename-angular-eslint-accesibility-rules
Remove the ‘accessibility-’ prefix from ‘@angular-eslint/eslint-plugin-template’ rules.
update-angular-cli-version-16-1-0
Update the @angular/cli package version to ~16.1.0.
Package Updates for 16.4.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular-devkit/architect | ~0.1601.0 |
@angular-devkit/build-angular | ~16.1.0 |
@angular-devkit/build-webpack | ~0.1601.0 |
@angular-devkit/core | ~16.1.0 |
@angular-devkit/schematics | ~16.1.0 |
@angular/pwa | ~16.1.0 |
@angular/core | ~16.1.0 |
@angular/material | ~16.1.0 |
@angular/cdk | ~16.1.0 |
@nguniversal/builders | ~16.1.0 |
@nguniversal/common | ~16.1.0 |
@nguniversal/express-engine | ~16.1.0 |
@schematics/angular | ~16.1.0 |
ng-packagr | ~16.1.0 |
16.2.x
switch-data-persistence-operators-imports-to-ngrx-router-store
Switch the data persistence operator imports to ‘@ngrx/router-store/data-persistence’.
Package Updates for 16.2.0-ngrx
The following packages will be updated:
| Package | Version |
|---|---|
@ngrx/store | ~16.0.0 |
16.1.x
Package Updates for 16.1.0
The following packages will be updated:
| Package | Version |
|---|---|
@angular/core | ~16.0.0 |
zone.js | ~0.13.0 |
@angular-devkit/architect | ~0.1600.0 |
@angular-devkit/build-angular | ~16.0.0 |
@angular-devkit/build-webpack | ~0.1600.0 |
@angular-devkit/core | ~16.0.0 |
@angular-devkit/schematics | ~16.0.0 |
@angular/pwa | ~16.0.0 |
@schematics/angular | ~16.0.0 |
ng-packagr | ~16.0.0 |
@nguniversal/build-angular | ~16.0.0 |
@nguniversal/builders | ~16.0.0 |
@nguniversal/common | ~16.0.0 |
@nguniversal/express-engine | ~16.0.0 |
@angular/material | ~16.0.0 |
@angular/cdk | ~16.0.0 |
Package Updates for 16.1.0-angular-eslint
The following packages will be updated:
| Package | Version |
|---|---|
@angular-eslint/eslint-plugin | ~16.0.0 |
@angular-eslint/eslint-plugin-template | ~16.0.0 |
@angular-eslint/template-parser | ~16.0.0 |
Package Updates for 16.1.3-jest
The following packages will be updated:
| Package | Version |
|---|---|
jest-preset-angular | ~13.1.0 |