@nx/angular:ng-packagr-lite

Builds a library with support for incremental builds.

This executor is meant to be used with buildable libraries in an incremental build scenario. It is similar to the @nx/angular:package executor but with some key differences:

For supported Angular versions lower than v16, it doesn't run ngcc automatically (ngcc is no longer available from Angular v16 onwards, for lower versions, it needs to be run separately beforehand if needed, this can be done in a postinstall hook on package.json).
It only produces ESM2022 bundles (ESM2020 for supported Angular versions lower than v16).

Options can be configured in project.json when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/reference/project-configuration#targets.

Options playground

Try out this interactive editor of the configuration object. Values are validated as you type and hovering over labels will give you more information.

Examples

These buttons show the config object for specific common tasks.

Options

project

Required

string

The file path for the ng-packagr configuration file, relative to the workspace root.

tsConfig

string

The full path for the TypeScript configuration file, relative to the workspace root.

buildableProjectDepsInPackageJsonType

string

Default: peerDependencies

Accepted values: dependencies, peerDependencies

When updateBuildableProjectDepsInPackageJson is true, this adds dependencies to either peerDependencies or dependencies.

tailwindConfig

string

The full path for the Tailwind configuration file, relative to the workspace root. If not provided and a tailwind.config.js file exists in the project or workspace root, it will be used. Otherwise, Tailwind will not be configured.

updateBuildableProjectDepsInPackageJson

boolean

Default: true

Whether to update the buildable project dependencies in the build output package.json.

watch

boolean

Default: false

Whether to run a build when any file changes.