Packages

@angular-devkit/build-angular

22.2.5 · 28 Oct 2026MIT2.8M / weekRepositorynpmAtom feed

Deprecated by its maintainers: Angular's Webpack support is deprecated. Use the esbuild and Vite-based "@angular/build" package instead.What to use instead
Your version

15.0.0

major16 Nov 2022Where it was published

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 bundleDependencies option 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 target to ES2022 and useDefineForClassFields to false unless the target is set to ES2022 or later in the TypeScript configuration. To control ECMA version and features use the Browerslist configuration.

  • breaking

    require.context are 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 bundleDependencies option 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 bundleDependencies option has been removed. This option was used pre Ivy. Currently, using this option is unlikely to produce working server bundles.

    The externalDependencies option 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 target to ES2022 and useDefineForClassFields to false unless the target is set to ES2022 or later in the TypeScript configuration. To control ECMA version and features use the Browerslist configuration.

  • breaking

    require.context are 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 bundleDependencies option 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

CommitDescription
feat - 4ead45cabadd ng-server-context when using app-shell builder
feat - 1c527a9daadd esbuild-based builder initial support for fileReplacements
feat - 67324b3e5add initial incremental code rebuilding to esbuild builder
feat - 3d94ca21badd initial watch support to esbuild-based builder
feat - c592ec584amend polyfills option in all builders to support an array of module specifiers
feat - a95d130efauto include @angular/localize/init when found in types
feat - 979bce45eauto include @angular/platform-server/init during server builds
feat - fd4175357drop support for TypeScript 4.6 and 4.7
feat - 15d3fc6dcexport @angular/platform-server symbols in server bundle
feat - 05a98c029karma builder main option is now optional
feat - 2b6029245providing a karma config is now optional
feat - 9c13fce16remove bundleDependencies from server builder
feat - 308e3a017switch to use Sass modern API
feat - 1e5d4a750use Browserslist to determine ECMA output
fix - 3ff391738account for package.json exports fields with CSS import statements
fix - 001445982account for package.json exports with Sass in esbuild builder
fix - 6280741ceadd @angular/platform-server as an optional peer dependency
fix - f9a2c3a12allow both script and module sourceTypes to be localized
fix - 4cb27b803avoid attempted resolve of external CSS URLs with esbuild builder
fix - 192e0e6d7correct escaping of target warning text in esbuild builder
fix - 4fcb0a82bcorrectly resolve Sass partial files in node packages
fix - fb5a66ae6fix crash when Sass error occurs
fix - b6df9c136handle conditional exports in scripts and styles option
fix - 0ee7625d6ignore cache path when watching with esbuild builder
fix - e34bfe5ebignore specs in node_modules when finding specs
fix - f143171fdonly add @angular/platform-server/init when package is installed.
fix - 3a1970b76only import karma when running karma builder
fix - 8b84c18edprovide workaround for V8 object spread performance defect
fix - 7dd122ad5rebase Sass url() values when using esbuild-based builder
fix - 2105964afresolve transitive dependencies in Sass when using Yarn PNP
fix - 54e1c01d8show file replacement in TS missing file error in esbuild builder
fix - 6c3f281d9show warning when using TypeScript target older then ES2022 in esbuild builder
fix - 8f8e02c32support Yarn PNP resolution in modern SASS API
fix - fc82e3becupdate browerslist package
fix - 0d62157a3update sourcemaps when rebasing Sass url() functions in esbuild builder
fix - 1518133dbuse relative sourcemap source paths for Sass in esbuild builder
fix - fb4ead2cewait during file watching to improve multi-save rebuilds for esbuild builder
fix - b059fc735warn when components styles sourcemaps are not generated when styles optimization is enabled
perf - 9d0872fb5add initial global styles incremental rebuilds with esbuild builder
perf - 0fe6b3b75add vendor chunking to server builder
perf - 8c915d414avoid extra babel file reads in esbuild builder rebuilds
perf - 919fe2148avoid extra TypeScript emits with esbuild rebuilds
perf - 92145c4a7avoid template diagnostics for declaration files in esbuild builder
perf - 52db3c000minimize Angular diagnostics incremental analysis in esbuild-based builder
perf - feb06753duse esbuild-based builder to directly downlevel for await...of
perf - 9d83fb91buse Sass worker pool for Sass support in esbuild builder
perf - 45a94228fuse Uint8Arrays for incremental caching with esbuild-based builder
refactor - f393b0928disable requireContext parsing
refactor - 12931ba8cremove deprecated ES5 support
refactor - 7f1017e60remove old bundleDependencies enum logic
refactor - 2ba44a433remove support for Stylus