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

14.0.0

major2 Jun 2022Where it was published

14.2.13 is the newest release of 14.x.

In short

5 breaking

  • breaking

    browser and karma builders script and styles options input files extensions are now validated.

  • breaking

    We now issue a build time error since importing a CSS file as an ECMA module is non standard Webpack specific feature, which is not supported by the Angular CLI.

  • breaking

    Reflect metadata polyfill is no longer automatically provided in JIT mode

  • breaking

    NG_BUILD_CACHE environment variable has been removed. cli.cache in the workspace configuration should be used instead.

  • breaking

    The deprecated showCircularDependencies browser and server builder option has been removed. The recommended method to detect circular dependencies in project code is to use either a lint rule or other external tools.

Release note

The section about @angular-devkit/build-angular of a note shared by several packages.

Breaking Changes

@angular-devkit/build-angular

  • breaking

    browser and karma builders script and styles options input files extensions are now validated.

    Valid extensions for scripts are:

    • .js

    • .cjs

    • .mjs

    • .jsx

    • .cjsx

    • .mjsx

    Valid extensions for styles are:

    • .css

    • .less

    • .sass

    • .scss

    • .styl

  • breaking

    We now issue a build time error since importing a CSS file as an ECMA module is non standard Webpack specific feature, which is not supported by the Angular CLI.

    This feature was never truly supported by the Angular CLI, but has as such for visibility.

  • breaking

    Reflect metadata polyfill is no longer automatically provided in JIT mode
    Reflect metadata support is not required by Angular in JIT applications compiled by the CLI.
    Applications built in AOT mode did not and will continue to not provide the polyfill.
    For the majority of applications, the reflect metadata polyfill removal should have no effect.
    However, if an application uses JIT mode and also uses the previously polyfilled reflect metadata JavaScript APIs, the polyfill will need to be manually added to the application after updating.
    To replicate the previous behavior, the core-js package should be manually installed and the import 'core-js/proposals/reflect-metadata'; statement should be added to the application's polyfills.ts file.

  • breaking

    NG_BUILD_CACHE environment variable has been removed. cli.cache in the workspace configuration should be used instead.

  • breaking

    The deprecated showCircularDependencies browser and server builder option has been removed. The recommended method to detect circular dependencies in project code is to use either a lint rule or other external tools.

Deprecations

@angular-devkit/build-angular

CommitDescription
feat - 00186fb93add initial experimental esbuild-based application browser builder
feat - d23a168b8validate file extensions for scripts and styles options
fix - 2adf252dcadd es2015 exports package condition to browser-esbuild
fix - 72e820e7bbetter handle Windows paths in esbuild experimental builder
fix - 587082fb0close compiler on Karma exit
fix - c52d10d1fclose dev-server on error
fix - 48630ccfddetect tailwind.config.cjs as valid tailwindcss configuration
fix - 4d5f6c659downlevel libraries based on the browserslist configurations
fix - 1a160dac0ensure karma sourcemap support on Windows
fix - 07e776ea3fail build when importing CSS files as an ECMA modules
fix - ac1383f9eproperly handle locally-built APF v14 libraries
fix - 966d25b55remove unneeded JIT reflect metadata polyfill
refactor - b8564a638remove deprecated NG_BUILD_CACHE environment variable
refactor - 0a1cd584dremove deprecated showCircularDependencies browser and server builder option