@angular-devkit/build-angular
22.2.5 · 28 Oct 2026MIT2.8M / weekRepositorynpmAtom feed
15.2.11 is the newest release of 15.x.
In short
8 breaking
- breaking
TypeScript versions older than 4.8.2 are no longer supported.
- breaking
The server builder
bundleDependenciesoption has been removed. This option was used pre Ivy. Currently, using this option is unlikely to produce working server bundles. - breaking
Deprecated support for tilde import has been removed. Please update the imports by removing the
~. - breaking
Internally the Angular CLI now always set the TypeScript
targettoES2022anduseDefineForClassFieldstofalseunless the target is set toES2022or later in the TypeScript configuration. To control ECMA version and features use the Browerslist configuration. - breaking
require.contextare no longer parsed. Webpack specific features are not supported nor guaranteed to work in the future. - breaking
Producing ES5 output is no longer possible. This was needed for Internet Explorer which is no longer supported. All browsers that Angular supports work with ES2015+
- breaking
Server builder
bundleDependenciesoption now only accept a boolean value. - breaking
Deprecated support for Stylus has been removed. The Stylus package has never reached a stable version and its usage in the Angular CLI is minimal. It's recommended to migrate to another CSS preprocessor that the Angular CLI supports.
Release note
The section about @angular-devkit/build-angular of a note shared by several packages.
Breaking Changes
@angular-devkit/build-angular
- breaking
TypeScript versions older than 4.8.2 are no longer supported.
- breaking
The server builder
bundleDependenciesoption has been removed. This option was used pre Ivy. Currently, using this option is unlikely to produce working server bundles.The
externalDependenciesoption can be used instead to exclude specific node_module packages from the final bundle. - breaking
Deprecated support for tilde import has been removed. Please update the imports by removing the
~.Before
@import "~font-awesome/scss/font-awesome";
After
@import "font-awesome/scss/font-awesome";
By default the CLI will use Sass modern API, While not recommended, users can still opt to use legacy API by setting
NG_BUILD_LEGACY_SASS=1.
- breaking
Internally the Angular CLI now always set the TypeScript
targettoES2022anduseDefineForClassFieldstofalseunless the target is set toES2022or later in the TypeScript configuration. To control ECMA version and features use the Browerslist configuration. - breaking
require.contextare no longer parsed. Webpack specific features are not supported nor guaranteed to work in the future. - breaking
Producing ES5 output is no longer possible. This was needed for Internet Explorer which is no longer supported. All browsers that Angular supports work with ES2015+
- breaking
Server builder
bundleDependenciesoption now only accept a boolean value. - breaking
Deprecated support for Stylus has been removed. The Stylus package has never reached a stable version and its usage in the Angular CLI is minimal. It's recommended to migrate to another CSS preprocessor that the Angular CLI supports.
@angular-devkit/build-angular
| Commit | Description |
|---|---|
| feat - 4ead45cab | add ng-server-context when using app-shell builder |
| feat - 1c527a9da | add esbuild-based builder initial support for fileReplacements |
| feat - 67324b3e5 | add initial incremental code rebuilding to esbuild builder |
| feat - 3d94ca21b | add initial watch support to esbuild-based builder |
| feat - c592ec584 | amend polyfills option in all builders to support an array of module specifiers |
| feat - a95d130ef | auto include @angular/localize/init when found in types |
| feat - 979bce45e | auto include @angular/platform-server/init during server builds |
| feat - fd4175357 | drop support for TypeScript 4.6 and 4.7 |
| feat - 15d3fc6dc | export @angular/platform-server symbols in server bundle |
| feat - 05a98c029 | karma builder main option is now optional |
| feat - 2b6029245 | providing a karma config is now optional |
| feat - 9c13fce16 | remove bundleDependencies from server builder |
| feat - 308e3a017 | switch to use Sass modern API |
| feat - 1e5d4a750 | use Browserslist to determine ECMA output |
| fix - 3ff391738 | account for package.json exports fields with CSS import statements |
| fix - 001445982 | account for package.json exports with Sass in esbuild builder |
| fix - 6280741ce | add @angular/platform-server as an optional peer dependency |
| fix - f9a2c3a12 | allow both script and module sourceTypes to be localized |
| fix - 4cb27b803 | avoid attempted resolve of external CSS URLs with esbuild builder |
| fix - 192e0e6d7 | correct escaping of target warning text in esbuild builder |
| fix - 4fcb0a82b | correctly resolve Sass partial files in node packages |
| fix - fb5a66ae6 | fix crash when Sass error occurs |
| fix - b6df9c136 | handle conditional exports in scripts and styles option |
| fix - 0ee7625d6 | ignore cache path when watching with esbuild builder |
| fix - e34bfe5eb | ignore specs in node_modules when finding specs |
| fix - f143171fd | only add @angular/platform-server/init when package is installed. |
| fix - 3a1970b76 | only import karma when running karma builder |
| fix - 8b84c18ed | provide workaround for V8 object spread performance defect |
| fix - 7dd122ad5 | rebase Sass url() values when using esbuild-based builder |
| fix - 2105964af | resolve transitive dependencies in Sass when using Yarn PNP |
| fix - 54e1c01d8 | show file replacement in TS missing file error in esbuild builder |
| fix - 6c3f281d9 | show warning when using TypeScript target older then ES2022 in esbuild builder |
| fix - 8f8e02c32 | support Yarn PNP resolution in modern SASS API |
| fix - fc82e3bec | update browerslist package |
| fix - 0d62157a3 | update sourcemaps when rebasing Sass url() functions in esbuild builder |
| fix - 1518133db | use relative sourcemap source paths for Sass in esbuild builder |
| fix - fb4ead2ce | wait during file watching to improve multi-save rebuilds for esbuild builder |
| fix - b059fc735 | warn when components styles sourcemaps are not generated when styles optimization is enabled |
| perf - 9d0872fb5 | add initial global styles incremental rebuilds with esbuild builder |
| perf - 0fe6b3b75 | add vendor chunking to server builder |
| perf - 8c915d414 | avoid extra babel file reads in esbuild builder rebuilds |
| perf - 919fe2148 | avoid extra TypeScript emits with esbuild rebuilds |
| perf - 92145c4a7 | avoid template diagnostics for declaration files in esbuild builder |
| perf - 52db3c000 | minimize Angular diagnostics incremental analysis in esbuild-based builder |
| perf - feb06753d | use esbuild-based builder to directly downlevel for await...of |
| perf - 9d83fb91b | use Sass worker pool for Sass support in esbuild builder |
| perf - 45a94228f | use Uint8Arrays for incremental caching with esbuild-based builder |
| refactor - f393b0928 | disable requireContext parsing |
| refactor - 12931ba8c | remove deprecated ES5 support |
| refactor - 7f1017e60 | remove old bundleDependencies enum logic |
| refactor - 2ba44a433 | remove support for Stylus |