// Quick-reference for building the core Ignite UI for Angular library and related packages. Covers the full production build (`build:lib`), individual partial builds (styles, extras, migrations, schematics, i18n, elements), and the combined build-all command. Use when an agent needs to compile the library, produce a dist output, or verify that code changes compile cleanly. Do NOT use for running tests — use igniteui-angular-testing instead. Do NOT use for linting — use igniteui-angular-linting instead.
Quick-reference for building the core Ignite UI for Angular library and related packages. Covers the full production build (`build:lib`), individual partial builds (styles, extras, migrations, schematics, i18n, elements), and the combined build-all command. Use when an agent needs to compile the library, produce a dist output, or verify that code changes compile cleanly. Do NOT use for running tests — use igniteui-angular-testing instead. Do NOT use for linting — use igniteui-angular-linting instead.
user-invocable
true
Ignite UI for Angular — Build
Quick-reference card for the core library and related build commands in this repository.
Prerequisites
Run npm install at the repo root before any build command.
Full Build
npm run build
Runs all sub-builds in sequence (library, elements, schematics, migrations, i18n, extras). Use this when you need a complete publishable output or before running the full CI pipeline locally. Check package.json for the exact sequence.
Library Build (most common)
npm run build:lib
This is the primary build command. It does two things:
ng build igniteui-angular --configuration production — compiles the library with ng-packagr using Angular Package Format. Uses ng-package.prod.json (production config).
npm run build:styles — runs node scripts/build-styles.mjs to compile and bundle Sass themes into distributable CSS.
Output: dist/igniteui-angular/
When to use build:lib
After implementing a feature or fix, to verify the code compiles.
Before checking that new public symbols are correctly exported.
When another project needs to consume a local build of the library.
Partial Builds
Command
What it does
npm run build:styles
Compiles Sass themes only (scripts/build-styles.mjs). Already included in build:lib.
npm run build:extras
Builds the extras package and then runs extras migrations.
npm run build:schematics
Copies and compiles ng add schematics (projects/igniteui-angular/schematics/).
npm run build:migrations
Copies and compiles ng update migration schematics (projects/igniteui-angular/migrations/).
npm run build:i18n
Compiles the i18n package (projects/igniteui-angular-i18n/).
npm run build:elements
Builds the Angular Elements package + bundling + style copy.
npm run build:docs
Generates TypeDoc + SassDoc documentation.
When to use partial builds
build:schematics — after editing files under projects/igniteui-angular/schematics/.
build:migrations — after editing files under projects/igniteui-angular/migrations/. Required before running test:schematics.
build:extras — after editing the extras package or when validating the full root build flow.
build:i18n — after changing i18n resource strings.
build:elements — when working on the Angular Elements wrapper.
