# @angular-builders/common

> Common utility functions shared between @angular-builders packages

Latest version **6.0.1** (published 2026-06-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install @angular-builders/common
pnpm add @angular-builders/common
yarn add @angular-builders/common
bun add @angular-builders/common
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 6.0.1 |
| Published | 2026-06-23 |
| First published | 2024-02-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^20.19.0 \|\| ^22.12.0 \|\| >=24.0.0 |
| Dependencies | 5 |
| Unpacked size | 45.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1162 |
| Author | JeB Barabanov |
| Maintainers | justjeb |

## Links

- npm: https://www.npmjs.com/package/@angular-builders/common
- Repository: https://github.com/just-jeb/angular-builders
- Homepage: https://github.com/just-jeb/angular-builders#readme
- Issues: https://github.com/just-jeb/angular-builders/issues
- npm.io page: https://npm.io/package/@angular-builders/common

## Dependencies (5)

- [jiti](https://npm.io/package/jiti.md) ^2.7.0
- [get-tsconfig](https://npm.io/package/get-tsconfig.md) ^4.10.0
- [@schematics/angular](https://npm.io/package/@schematics/angular.md) ^22.0.0
- [@angular-devkit/core](https://npm.io/package/@angular-devkit/core.md) ^22.0.0
- [@angular-devkit/schematics](https://npm.io/package/@angular-devkit/schematics.md) ^22.0.0

## Recent versions

- 6.0.1 (latest) — 2026-06-23
- 6.0.1-beta.0 (next) — 2026-06-22
- 6.0.0 — 2026-06-10
- 6.0.0-beta.1 — 2026-06-09
- 6.0.0-beta.0 — 2026-06-09
- 5.0.4 — 2026-06-08
- 5.0.4-beta.4 — 2026-06-01
- 5.0.4-beta.3 — 2026-04-26
- 5.0.4-beta.2 — 2026-02-23
- 5.0.4-beta.1 — 2026-02-18
- 5.0.4-beta.0 — 2026-02-16
- 5.0.3 — 2026-01-14
- 5.0.3-beta.1 — 2026-01-14
- 5.0.0-beta.1 — 2025-12-17
- 5.0.0-beta.0 — 2025-12-17
- … 16 more at https://npm.io/package/@angular-builders/common/versions

## README

# @angular-builders ![build](https://github.com/just-jeb/angular-builders/workflows/ci/badge.svg) ![Packagist](https://img.shields.io/packagist/l/doctrine/orm.svg) [![All Contributors](https://img.shields.io/badge/all_contributors-8-orange.svg?style=flat-square)](#contributors)

The purpose of this repository is to consolidate all the community builders for Angular build facade.

## The latest version of all the builders requires Angular CLI 22

Builders' and Angular **major** versions **must** match.

## [Migration guide](./MIGRATION.MD)

`custom-esbuild`, `custom-webpack` and `jest` ship Angular schematics, so both the initial setup and the move between majors are automated:

```sh
ng add @angular-builders/<package>     # set the builder up in your workspace
ng update @angular-builders/<package>  # move an existing project to a new major
```

`ng update` applies every migration between the version you have installed and the one you are moving to, so the builder's own migrations all run in one pass. Updating from version 17 or later is supported. Builder majors track Angular majors, so a project moving up several versions upgrades Angular first, and this command then brings the builder in line. Each package README documents what its schematics change for you and which changes they can only warn about. `bazel` and `timestamp` have no schematics, so those two are still configured by hand.

> ⚠️ **Version alignment:** The major version of `@angular-builders/*` packages must match the major version of `@angular/core` in your project. For example, Angular 19 requires `@angular-builders/*@19.x`, Angular 20 requires `@angular-builders/*@20.x`, etc. Using a mismatched version is the most common source of issues.

## Previous versions

<details>
  <summary>Click to expand</summary>

- [Version 21](https://github.com/just-jeb/angular-builders/tree/21.x.x)
- [Version 20](https://github.com/just-jeb/angular-builders/tree/20.x.x)
- [Version 19](https://github.com/just-jeb/angular-builders/tree/19.x.x)
- [Version 18](https://github.com/just-jeb/angular-builders/tree/18.x.x)
- [Version 17](https://github.com/just-jeb/angular-builders/tree/17.x.x)
- [Version 16](https://github.com/just-jeb/angular-builders/tree/16.x.x)
- [Version 15](https://github.com/just-jeb/angular-builders/tree/15.x.x)
- [Version 14](https://github.com/just-jeb/angular-builders/tree/14.x.x)
- [Version 13](https://github.com/just-jeb/angular-builders/tree/13.x.x)
- [Version 12](https://github.com/just-jeb/angular-builders/tree/12.x.x)
- [Version 11](https://github.com/just-jeb/angular-builders/tree/11.x.x)
- [Version 10](https://github.com/just-jeb/angular-builders/tree/10.x.x)
- [Version 9](https://github.com/just-jeb/angular-builders/tree/9.x.x)
- [Version 8](https://github.com/just-jeb/angular-builders/tree/8.x.x)
- [Version 7](https://github.com/just-jeb/angular-builders/tree/7.x.x)

</details>

# Builders

- [Custom esbuild builders](./packages/custom-esbuild) (Allow customizing ESBuild configuration) [![npm version](https://img.shields.io/npm/v/@angular-builders/custom-esbuild.svg) ![npm (tag)](https://img.shields.io/npm/v/@angular-builders/custom-esbuild/next.svg) ![npm](https://img.shields.io/npm/dm/@angular-builders/custom-esbuild.svg)](https://www.npmjs.com/package/@angular-builders/custom-esbuild)
- [Custom webpack builders](./packages/custom-webpack) (Allow customizing Webpack configuration) [![npm version](https://img.shields.io/npm/v/@angular-builders/custom-webpack.svg) ![npm (tag)](https://img.shields.io/npm/v/@angular-builders/custom-webpack/next.svg) ![npm](https://img.shields.io/npm/dm/@angular-builders/custom-webpack.svg)](https://www.npmjs.com/package/@angular-builders/custom-webpack)
- [Jest builder](./packages/jest) (allows running `ng test` with Jest) [![npm version](https://img.shields.io/npm/v/@angular-builders/jest.svg) ![npm (tag)](https://img.shields.io/npm/v/@angular-builders/jest/next.svg) ![npm](https://img.shields.io/npm/dm/@angular-builders/jest.svg)](https://www.npmjs.com/package/@angular-builders/jest)
- [Bazel builder](./packages/bazel) (`ng` wrapper for `Bazel` build) [![npm version](https://img.shields.io/npm/v/@angular-builders/bazel.svg) ![npm (tag)](https://img.shields.io/npm/v/@angular-builders/bazel/next.svg) ![npm](https://img.shields.io/npm/dm/@angular-builders/bazel.svg)](https://www.npmjs.com/package/@angular-builders/bazek)
- [Timestamp builder](./packages/timestamp) (an example builder from [this](https://medium.com/@justjeb/angular-cli-6-under-the-hood-builders-demystified-f0690ebcf01) article) [![npm version](https://img.shields.io/npm/v/@angular-builders/timestamp.svg) ![npm (tag)](https://img.shields.io/npm/v/@angular-builders/timestamp/next.svg) ![npm](https://img.shields.io/npm/dm/@angular-builders/timestamp.svg)](https://www.npmjs.com/package/@angular-builders/timestamp)

# Get in touch

Have any questions? Would like to discuss something?
[Join](https://join.slack.com/t/angular-builders/shared_invite/enQtODM2MjU5MTYyMDk2LTcxODQ3NTExNDZkM2U0NWQ2NmVmZTAwZWNmOThhYjg4ZDlmMGFlNDZmYWQxYzU5ODIzYjdmZGFmNmUxNDBlY2E) @angular-builders on Slack!

# Further reading

[Angular CLI under the hood - builders demystified](https://www.justjeb.com/post/angular-cli-under-the-hood-builders-demystified) — what the Architect layer is and how a builder works, taught by building one from scratch. It explains the mechanism these packages plug into; setup instructions live in the package READMEs above.

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tbody>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://medium.com/@overthesanity"><img src="https://avatars1.githubusercontent.com/u/7337691?v=4?s=100" width="100px;" alt="Artur Androsovych"/><br /><sub><b>Artur Androsovych</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=arturovt" title="Code">💻</a> <a href="#question-arturovt" title="Answering Questions">💬</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jogelin"><img src="https://avatars2.githubusercontent.com/u/954509?v=4?s=100" width="100px;" alt="jogelin"/><br /><sub><b>jogelin</b></sub></a><br /><a href="#example-jogelin" title="Examples">💡</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jusefb"><img src="https://avatars2.githubusercontent.com/u/3741868?v=4?s=100" width="100px;" alt="Jusef Belkasemi"/><br /><sub><b>Jusef Belkasemi</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=jusefb" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://medium.com/@ExplosionPills/"><img src="https://avatars0.githubusercontent.com/u/1308273?v=4?s=100" width="100px;" alt="Andrew Crites"/><br /><sub><b>Andrew Crites</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=ajcrites" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://www.strangeplanet.fr"><img src="https://avatars3.githubusercontent.com/u/41597?v=4?s=100" width="100px;" alt="Damien Sorel"/><br /><sub><b>Damien Sorel</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=mistic100" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://wesleygrimes.com"><img src="https://avatars0.githubusercontent.com/u/324308?v=4?s=100" width="100px;" alt="Wes Grimes"/><br /><sub><b>Wes Grimes</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=wesleygrimes" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/michaeljota"><img src="https://avatars0.githubusercontent.com/u/10507776?v=4?s=100" width="100px;" alt="Michael De Abreu"/><br /><sub><b>Michael De Abreu</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=michaeljota" title="Code">💻</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/a1russell"><img src="https://avatars0.githubusercontent.com/u/241628?v=4?s=100" width="100px;" alt="Adam Russell"/><br /><sub><b>Adam Russell</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/issues?q=author%3Aa1russell" title="Bug reports">🐛</a> <a href="https://github.com/just-jeb/angular-builders/commits?author=a1russell" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://www.facebook.com/onfocus.vi"><img src="https://avatars0.githubusercontent.com/u/19356181?v=4?s=100" width="100px;" alt="Vix Nguyen"/><br /><sub><b>Vix Nguyen</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=vixnguyen" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/jankeesvanandel"><img src="https://avatars1.githubusercontent.com/u/272120?v=4?s=100" width="100px;" alt="Jan-Kees van Andel"/><br /><sub><b>Jan-Kees van Andel</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=jankeesvanandel" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/gdoerr"><img src="https://avatars2.githubusercontent.com/u/6474127?v=4?s=100" width="100px;" alt="Greg Doerr"/><br /><sub><b>Greg Doerr</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=gdoerr" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/arluko"><img src="https://avatars0.githubusercontent.com/u/70697565?v=4?s=100" width="100px;" alt="arluko"/><br /><sub><b>arluko</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=arluko" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/zauni"><img src="https://avatars0.githubusercontent.com/u/663845?v=4?s=100" width="100px;" alt="Matthias Zaunseder"/><br /><sub><b>Matthias Zaunseder</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=zauni" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/sonallux"><img src="https://avatars3.githubusercontent.com/u/13821543?v=4?s=100" width="100px;" alt="Jonas"/><br /><sub><b>Jonas</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=sonallux" title="Code">💻</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/michelherv"><img src="https://avatars1.githubusercontent.com/u/12019057?v=4?s=100" width="100px;" alt="Michel Hervé NGOUNOU"/><br /><sub><b>Michel Hervé NGOUNOU</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=michelherv" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://marvin.digital/"><img src="https://avatars3.githubusercontent.com/u/11534760?v=4?s=100" width="100px;" alt="Marvin Heilemann"/><br /><sub><b>Marvin Heilemann</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=muuvmuuv" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/briananderson1222"><img src="https://avatars2.githubusercontent.com/u/4603907?v=4?s=100" width="100px;" alt="Brian Anderson"/><br /><sub><b>Brian Anderson</b></sub></a><br /><a href="#question-briananderson1222" title="Answering Questions">💬</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/AnthonyJungmann"><img src="https://avatars.githubusercontent.com/u/8911909?v=4?s=100" width="100px;" alt="Anthony Jungmann"/><br /><sub><b>Anthony Jungmann</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=AnthonyJungmann" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://matheo.co"><img src="https://avatars.githubusercontent.com/u/260185?v=4?s=100" width="100px;" alt="Mateo Tibaquirá"/><br /><sub><b>Mateo Tibaquirá</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=matheo" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://juri.dev"><img src="https://avatars.githubusercontent.com/u/542458?v=4?s=100" width="100px;" alt="Juri Strumpflohner"/><br /><sub><b>Juri Strumpflohner</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=juristr" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://www.git-pull.com"><img src="https://avatars.githubusercontent.com/u/26336?v=4?s=100" width="100px;" alt="Tony Narlock"/><br /><sub><b>Tony Narlock</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=tony" title="Documentation">📖</a></td>
    </tr>
    <tr>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/kroeder"><img src="https://avatars.githubusercontent.com/u/5478899?v=4?s=100" width="100px;" alt="Kai Röder"/><br /><sub><b>Kai Röder</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=kroeder" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://www.gerkindevelopment.net"><img src="https://avatars.githubusercontent.com/u/8212504?v=4?s=100" width="100px;" alt="Gerkin"/><br /><sub><b>Gerkin</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=GerkinDev" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="http://alexeagle.github.io"><img src="https://avatars.githubusercontent.com/u/47395?v=4?s=100" width="100px;" alt="Alex Eagle"/><br /><sub><b>Alex Eagle</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=alexeagle" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/alan-agius4"><img src="https://avatars.githubusercontent.com/u/17563226?v=4?s=100" width="100px;" alt="Alan Agius"/><br /><sub><b>Alan Agius</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=alan-agius4" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/lme-agicap"><img src="https://avatars.githubusercontent.com/u/116797118?v=4?s=100" width="100px;" alt="lme-agicap"/><br /><sub><b>lme-agicap</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=lme-agicap" title="Code">💻</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/flavianh"><img src="https://avatars.githubusercontent.com/u/5397842?v=4?s=100" width="100px;" alt="Flavian Hautbois"/><br /><sub><b>Flavian Hautbois</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=flavianh" title="Documentation">📖</a></td>
      <td align="center" valign="top" width="14.28%"><a href="https://github.com/phuctv95"><img src="https://avatars.githubusercontent.com/u/20752858?v=4?s=100" width="100px;" alt="Phuc"/><br /><sub><b>Phuc</b></sub></a><br /><a href="https://github.com/just-jeb/angular-builders/commits?author=phuctv95" title="Documentation">📖</a></td>
    </tr>
  </tbody>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

---
_Source: https://npm.io/package/@angular-builders/common · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._