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:

1. ng build igniteui-angular --configuration production — compiles the library with ng-packagr using Angular Package Format. Uses ng-package.prod.json (production config).
2. 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.

Key Paths

Path	Purpose
projects/igniteui-angular/	Library source root
projects/igniteui-angular/ng-package.prod.json	Production ng-packagr config
projects/igniteui-angular/ng-package.json	Dev ng-packagr config (preserves dest)
dist/igniteui-angular/	Build output
scripts/build-styles.mjs	Sass theme compilation script

Related Skills

• igniteui-angular-testing — Running tests
• igniteui-angular-linting — Linting code and styles