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 card for the core library and related build commands in this repository.
npm install at the repo root before any build command.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.
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 (production config).ng-package.prod.jsonnpm run build:styles — runs node scripts/build-styles.mjs to compile and bundle Sass themes into distributable CSS.Output: dist/igniteui-angular/
build:lib| 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. |
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.| 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 |
igniteui-angular-testing — Running testsigniteui-angular-linting — Linting code and styles