Close
Angular React Web Components Blazor Angular

Getting Started with Ignite UI for Angular Schematics

The Ignite UI for Angular Schematics collection is a set of Angular CLI schematics for scaffolding Angular projects and component views pre-configured for Ignite UI for Angular. It integrates into the native Angular CLI workflow - use it with ng new for project creation and ng g for component scaffolding, without installing a separate global tool. The collection is distributed as the @igniteui/angular-schematics package and is added automatically when you run ng add igniteui-angular on an existing Angular project.

The Schematics collection does not run an MCP server - the MCP server process is provided by the Ignite UI CLI and starts via npx -y igniteui-cli mcp, where -y avoids the interactive npx confirmation prompt. The ai-config schematic configures the MCP client connection and copies Agent Skills without requiring a separate CLI install. The collection is specific to Angular; React, Web Components, and Blazor equivalents are covered in their respective framework documentation. Neither tool is required to use Ignite UI for Angular - the library can be installed and configured manually as described in the Getting Started guide.

Install the Schematics Collection

Install @igniteui/angular-schematics globally using npm:

npm i -g @igniteui/angular-schematics

Or, using yarn:

yarn global add @igniteui/angular-schematics

After a global install, the collection is available as the --collection argument to ng new. If you already have an Angular project and want to add Ignite UI for Angular without scaffolding a new one, use:

ng add igniteui-angular

This installs the igniteui-angular package, registers the @igniteui/angular-schematics collection, and configures dependencies, styles, and theme imports automatically.

Create a New Project

The Schematics collection provides two modes for project creation: a guided interactive wizard and a direct ng new command with explicit arguments.

Use the guided wizard

The guided wizard is the recommended starting point for new projects. Activate it with:

ng new --collection="@igniteui/angular-schematics"

For a step-by-step walkthrough of the wizard options, see Step-by-Step Guide Using Ignite UI for Angular Schematics.

Create a project directly

To create an Angular project non-interactively, provide the collection and template arguments to ng new:

ng new newAngularProject --collection="@igniteui/angular-schematics" --template=side-nav

By default, the project uses standalone components. To use NgModule-based bootstrapping instead, add --type=igx-ts-legacy:

ng new newAngularProject --collection="@igniteui/angular-schematics" --type=igx-ts-legacy

The project is created in a directory named after the project. The following base project templates are available:

Template IDDescription
emptyProject structure with routing and a home page. Authentication is not available for this template.
side-navProject structure with a side navigation drawer. Supports authentication as an add-on (see below).
side-nav-miniProject structure with a compact side navigation drawer. Supports authentication as an add-on (see below).

When using the interactive wizard, selecting side-nav or side-nav-mini triggers an additional prompt asking whether to add authentication. The following template IDs are generated and can also be used directly with ng new for non-interactive creation - they are not shown in the wizard’s template list:

Template IDDescription
side-nav-authSide navigation extended with a user authentication module. See Angular Authentication Project Template for details.
side-nav-mini-authSide navigation mini extended with a user authentication module. See Angular Authentication Project Template for details.

The following arguments are available when creating a project:

name

name (alias: -n)

The name of the application. The application is created inside a directory with the same name.

type

—type (alias: -t)

The project bootstrapping type. Use igx-ts-legacy for NgModule-based bootstrapping. Omit to default to standalone components.

theme

—theme (alias: -th)

Project theme (depends on project type).

skip-git

—skip-git (alias: —sg)

Skips automatic Git repository initialization. If omitted, the global skip-git configuration property is used.

skip-install

—skip-install (alias: —si)

Skips the initial npm package installation on project creation.

template

—template

Specifies the project template. Currently available for Ignite UI for Angular igx-ts project types.

Add a Component Template

To add an available Ignite UI for Angular template to an existing project, use ng generate with the Ignite UI for Angular collection and the component schematic, providing the template ID and a name for the new component:

ng g @igniteui/angular-schematics:component grid newGrid

Template addition is supported in projects created with the Angular Schematics, Ignite UI CLI, or any Angular CLI project where Ignite UI for Angular was added with ng add. For the guided component wizard, see Step-by-Step Guide Using Ignite UI for Angular Schematics.

The following arguments are available when adding a template:

module

—module (alias: -m)

Applicable only in Angular projects.

Path to the module.ts file, relative to /src/app/, where the new component should be registered:

ng g @igniteui/angular-schematics:component combo newCombo —module=myModule/myModule.module.ts
skip-route

—skip-route (alias: -srk)

Skips auto-generation of an app navigation route for the new component.

Run the Application

The start schematic builds the application, starts a local web server, and opens it in your default browser:

ng g @igniteui/angular-schematics:start

AI Assistant Integration

The Ignite UI for Angular Schematics collection includes an ai-config schematic that sets up AI coding assistant integration for your project. In a single command, it:

  • Configures MCP servers - writes the MCP config file for your chosen coding assistant with the Ignite UI and Angular CLI MCP server entries
  • Copies skill files - adds Angular-specific skill guides into your agent directories
  • Sets up instruction files - populates each agent’s instruction file with project-specific guidance

Run it from your project root after installing Ignite UI for Angular packages:

ng generate @igniteui/angular-schematics:ai-config

Flags Reference

FlagValuesDefault
--assistantsgeneric, vscode, cursor, gemini, junie, nonePrompted interactively; generic in non-interactive mode
--agentsgeneric, claude, copilot, cursor, codex, windsurf, gemini, junie, nonePrompted interactively; generic + claude in non-interactive mode

Supported Coding Assistants

Coding AssistantChoice valueConfig PathRoot Key
Generic (Claude Code, VS Code, and others)generic.mcp.jsonmcpServers
VS Code (GitHub Copilot)vscode.vscode/mcp.jsonservers
Cursorcursor.cursor/mcp.jsonmcpServers
Geminigemini.gemini/settings.jsonmcpServers
JetBrains Juniejunie.junie/mcp/mcp.jsonmcpServers

Supported AI Agents

AgentSkills DirectoryInstruction File
Generic.agents/skillsAGENTS.md
Claude.claude/skills.claude/CLAUDE.md
Copilot.github/skills.github/copilot-instructions.md
Cursor.cursor/skills.cursor/rules/cursor.mdc
Codex.codex/skills.codex/instructions.md
Windsurf.windsurf/skills.windsurf/rules/guidelines.md
Gemini.gemini/skills.gemini/GEMINI.md
Junie.junie/skills.junie/guidelines.md

Usage Examples

Interactive - prompts for coding assistants, then agents:

ng generate @igniteui/angular-schematics:ai-config

Non-interactive - specify both assistants and agents:

ng generate @igniteui/angular-schematics:ai-config --assistants cursor --agents claude copilot

Skip MCP configuration only:

ng generate @igniteui/angular-schematics:ai-config --assistants none --agents claude generic

Skip skill files and instructions only (MCP servers are still configured):

ng generate @igniteui/angular-schematics:ai-config --assistants vscode --agents none

The schematic also runs automatically as part of ng add igniteui-angular with defaults: agents ["claude", "generic"], assistants ["generic"].

MCP Server Configuration

The schematic writes (or merges into) the config file for your chosen coding assistant. Existing third-party MCP server entries are always preserved - the command merges, never overwrites. When run via the Angular schematic, an additional angular-cli MCP server entry is included automatically alongside the Ignite UI servers.

Generic, Cursor, Gemini, and Junie (.mcp.json and equivalents, root key mcpServers):

{
  "mcpServers": {
    "angular-cli": {
      "command": "npx",
      "args": ["-y", "@angular/cli", "mcp"]
    },
    "igniteui-cli": {
      "command": "npx",
      "args": ["-y", "igniteui-cli", "mcp"]
    },
    "igniteui-theming": {
      "command": "npx",
      "args": ["-y", "igniteui-theming", "igniteui-theming-mcp"]
    }
  }
}

VS Code / GitHub Copilot (.vscode/mcp.json, root key servers):

{
  "servers": {
    "angular-cli": {
      "command": "npx",
      "args": ["-y", "@angular/cli", "mcp"]
    },
    "igniteui-cli": {
      "command": "npx",
      "args": ["-y", "igniteui-cli", "mcp"]
    },
    "igniteui-theming": {
      "command": "npx",
      "args": ["-y", "igniteui-theming", "igniteui-theming-mcp"]
    }
  }
}

Skill Files

Skill files are Angular-specific guides copied into each agent’s skills directory. They are sourced from your installed Ignite UI package and kept in sync each time you run the schematic - existing files are only updated if their content has changed.

If you run ai-config before installing packages (e.g. with --skip-install), the schematic falls back to built-in templates. Re-run the command after installing to pick up the skill files from your installed version.

Using the Ignite UI CLI Instead

If you have the Ignite UI CLI installed globally, the equivalent command is:

ig ai-config

The ig ai-config command configures only the two Ignite UI entries, igniteui-cli and igniteui-theming, and does not register angular-cli. Use ng generate @igniteui/angular-schematics:ai-config to get all three servers configured in a single step.

For full setup instructions across all AI clients and Agent Skills wiring, see Ignite UI CLI MCP.