@angular-builders

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

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

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

Click to expand

• Version 21
• Version 20
• Version 19
• Version 18
• Version 17
• Version 16
• Version 15
• Version 14
• Version 13
• Version 12
• Version 11
• Version 10
• Version 9
• Version 8
• Version 7

Builders

• Custom esbuild builders (Allow customizing ESBuild configuration)
• Custom webpack builders (Allow customizing Webpack configuration)
• Jest builder (allows running ng test with Jest)
• Bazel builder (ng wrapper for Bazel build)
• Timestamp builder (an example builder from this article)

Get in touch

Have any questions? Would like to discuss something? Join @angular-builders on Slack!

Further reading

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):

Artur Androsovych 💻 💬	jogelin 💡	Jusef Belkasemi 📖	Andrew Crites 💻	Damien Sorel 💻	Wes Grimes 💻	Michael De Abreu 💻
Adam Russell 🐛 💻	Vix Nguyen 💻	Jan-Kees van Andel 💻	Greg Doerr 💻	arluko 💻	Matthias Zaunseder 💻	Jonas 💻
Michel Hervé NGOUNOU 💻	Marvin Heilemann 💻	Brian Anderson 💬	Anthony Jungmann 📖	Mateo Tibaquirá 💻	Juri Strumpflohner 💻	Tony Narlock 📖
Kai Röder 📖	Gerkin 💻	Alex Eagle 💻	Alan Agius 💻	lme-agicap 💻	Flavian Hautbois 📖	Phuc 📖

This project follows the all-contributors specification. Contributions of any kind welcome!