nx-ng-esbuild

library0.5.3jsnpmunverified

An Nx plugin that enables using ESBuild as the build system for Angular applications within an Nx workspace. Version 0.5.3 is the current stable release. The package provides generators to add ESBuild configuration to existing Angular apps or scaffold new apps with ESBuild support. It offers faster builds compared to the default Angular builder, though it currently produces larger bundle sizes and lacks features like type checking, file hashing, caching, and production readiness. It supports build, watch, and serve modes. The library is in early development and not recommended for production use.

devops

npm install nx-ng-esbuild

package ↗

INSTALL

IMPORT

SIG · NX-NG-ESBUILD

nx-ng-esbuild

devopsjavascriptv0.5.3

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.

createNodes

✓ import { createNodes } from 'nx-ng-esbuild'

✗ const { createNodes } = require('nx-ng-esbuild')

ESM-only package; CommonJS require is not supported.

NxAngularEsbuildPlugin

✓ import { NxAngularEsbuildPlugin } from 'nx-ng-esbuild'

✗ import NxAngularEsbuildPlugin from 'nx-ng-esbuild'

Named export, not default.

executor (buildExecutor)

✓ import { executor } from 'nx-ng-esbuild/build'

✗ import { buildExecutor } from 'nx-ng-esbuild'

Executor is exported from a subpath.

Commands to install the plugin, generate a new Angular app, build, and serve with custom port.

// Install the plugin // npm install --save-dev nx-ng-esbuild // Generate a new Angular app with ESBuild support // nx g nx-ng-esbuild:app myApp // Build the app // nx run myApp:esbuild // Serve with watch mode on port 4201 // nx run myApp:esbuild --serve=true --watch=true --port=4201 // Add ESBuild configuration to an existing app // nx g nx-ng-esbuild:add-esbuild-config existingApp

Debug

Known issues

breakingPackage is not production-ready and may have breaking changes between minor versions.

fix

Pin to exact version and test upgrades carefully.

affects: >=0.0.1

gotchaDoes not run TypeScript type checking; type errors will not be caught during build.

fix

Add a separate type-checking step (e.g., tsc --noEmit).

affects: >=0.0.1

gotchaLarger bundle size compared to the default Angular builder.

fix

Consider alternative builders if bundle size is critical.

affects: >=0.0.1

gotchaDoes not hash output files; caching and incremental builds not supported natively.

fix

Implement custom hashing or use Nx caching with proper inputs.

affects: >=0.0.1

gotchaDry run mode likely does not work for generators.

fix

Do not rely on --dry-run; test changes on a separate branch.

affects: >=0.0.1

Errors

Common errors & fixes

Cannot find module 'nx-ng-esbuild' or its corresponding type declarations.

Package not installed or TypeScript cannot resolve types.

fix

Ensure package is installed: npm install --save-dev nx-ng-esbuild

Schema validation failed: Data path '' must NOT have additional properties (port).

Passing unsupported options to the executor, e.g., 'port' is only valid when 'serve=true'.

fix

Ensure 'serve' option is set to true when using 'port': nx run app:esbuild --serve=true --port=4201

TypeError: Cannot read properties of undefined (reading 'project')

Generator called without a valid project name.

fix

Provide a valid project name: nx g nx-ng-esbuild:add-esbuild-config myApp

Upgrade

Version history

0.5.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/nx-ng-esbuild ↗