Registry / web-framework / angular-extended-builder

angular-extended-builder

library21.2.0jsnpmunverified

Angular Extended Builders (v21.2.0) extends @angular/build with custom options for esbuild plugins, index HTML transformers, and Vite dev-server middlewares. Aligns major/minor versions with Angular (21.x). Requires Node >=22 and Angular 21.2.x. Offers ESM/TypeScript plugin support, ideal for advanced Angular build customization beyond the default CLI.

web-framework devops

npm install angular-extended-builder

github ↗package ↗

INSTALL

IMPORT

SIG · ANGULAR-EXTENDED-B

angular-extended-builder

web-frameworkjavascriptv21.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

application builder

✓ import 'angular-extended-builder' // builder registered via angular.json

✗ import { application } from 'angular-extended-builder'

Builders are used via angular.json builder key, not programmatic import.

dev-server builder

✓ import 'angular-extended-builder' // builder registered via angular.json

✗ import { devServer } from 'angular-extended-builder'

Same as application builder; use builder name in angular.json.

Plugin type

✓ import type { Plugin } from 'esbuild'

✗ import { Plugin } from 'angular-extended-builder'

Plugin type is from esbuild, not this package.

Install the package and configure angular.json to use extended builders with plugins.

npm install angular-extended-builder --save-dev # angular.json snippet: # "builder": "angular-extended-builder:application", # "options": { "plugins": ["./plugins/my-plugin.ts"], "indexHtmlTransformer": "./transform.mjs" }

Debug

Known issues

breakingVersion 21.x requires Node >=22 and Angular 21.x. Older Node or Angular will fail.

fix

Upgrade Node to >=22 and Angular to 21.x.

affects: >=21.0.0

gotchaPlugin and middleware paths in angular.json must be relative to workspace root or use absolute paths.

fix

Use paths starting with './' or a full path.

affects: all

gotchaPlugin modules must export a default esbuild Plugin object; named exports are not recognized.

fix

Use export default { name, setup }.

affects: all

breakingVersion 20.x to 21.x: The Angular major bump may break compatibility; align angular-extended-builder version with Angular's.

fix

Use version matching your Angular version (e.g., 20.x for Angular 20).

affects: >=21.0.0

gotchaThe $schema path in angular.json must point to the installed package's schema.json for autocomplete.

fix

Add "$schema": "./node_modules/angular-extended-builder/dist/schema.json".

affects: all

Errors

Common errors & fixes

Error: Builder 'angular-extended-builder:application' not found

Builder not registered or package not installed

fix

Run npm install angular-extended-builder and ensure angular.json builder key matches exactly.

Cannot find module './plugins/my-plugin.ts'

Path relative to workspace root, not project root

fix

Adjust path to be relative to workspace root or use absolute path.

TypeError: plugin must be an object with 'name' and 'setup'

Plugin module exports default incorrectly

fix

Ensure plugin file has a default export of an esbuild Plugin object.

Schema validation failed: data should have required property 'plugins'

Adding 'plugins' option without using extended builder

fix

Set builder to 'angular-extended-builder:application'.

Upgrade

Version history

21.2.0latest on npm

Audit

Dependencies

@angular-devkit/architectrequiredPeer dependency for Angular Architect framework

@angular-devkit/corerequiredPeer dependency for Angular core utilities

@angular/clirequiredPeer dependency for Angular CLI

rxjsrequiredPeer dependency for reactive extensions

Agent activity

29 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/muuvmuuv/angular-extended-builders ↗

packagehttps://www.npmjs.com/package/angular-extended-builder ↗