igniteui-cli 15.5.1 → 15.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +4 -4
- package/templates/blazor/igb/projects/ai-config/files/skills/AGENTS.md +6 -3
- package/templates/blazor/igb/projects/ai-config/files/skills/README.md +30 -45
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/SKILL.md +48 -96
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/charts.md +61 -238
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/data-display.md +60 -193
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/feedback.md +36 -92
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/form-controls.md +66 -224
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/layout-manager.md +39 -88
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/layout.md +75 -152
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/setup.md +40 -149
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/SKILL.md +58 -243
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/references/component-mapping.md +89 -280
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-generate-from-image-design/references/gotchas.md +143 -431
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/SKILL.md +91 -157
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/data-operations.md +50 -228
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/editing.md +61 -222
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/features.md +67 -360
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/grid-migration.md +55 -236
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/paging-remote.md +53 -202
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/sizing.md +31 -232
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/state.md +27 -119
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/structure.md +88 -363
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/types.md +87 -415
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-lite-testing/SKILL.md +8 -4
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-lite-testing/references/interop-contracts.md +42 -6
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/SKILL.md +83 -211
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/references/common-patterns.md +93 -184
- package/templates/react/igr-ts/avatar/default/files/src/app/__path__/__filePrefix__.tsx +3 -3
- package/templates/react/igr-ts/avatar/default/files/src/app/__path__/style.module.css +9 -0
- package/templates/react/igr-ts/button/default/files/src/app/__path__/__filePrefix__.tsx +1 -1
- package/templates/react/igr-ts/button/default/files/src/app/__path__/style.module.css +3 -0
- package/templates/react/igr-ts/icon/default/files/src/app/__path__/__filePrefix__.tsx +2 -2
- package/templates/react/igr-ts/icon/default/files/src/app/__path__/style.module.css +3 -0
- package/templates/react/igr-ts/icon-button/default/files/src/app/__path__/__filePrefix__.tsx +1 -1
- package/templates/react/igr-ts/icon-button/default/files/src/app/__path__/style.module.css +3 -0
- package/templates/react/igr-ts/pivot-grid/basic/files/src/app/__path__/__filePrefix__.tsx +3 -4
- package/templates/react/igr-ts/projects/_base/files/package.json +1 -0
- package/templates/react/igr-ts/projects/ai-config/files/skills/README.md +30 -83
- package/templates/react/igr-ts/projects/ai-config/files/skills/grid-lite-to-igr-grid-migration/SKILL.md +98 -191
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/SKILL.md +38 -147
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/COMPONENTS.md +65 -0
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/DATAVIZ.md +90 -0
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/MCP.md +43 -0
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/TROUBLESHOOTING.md +17 -145
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/USAGE.md +85 -0
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/SKILL.md +83 -135
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/reference/CSS-THEMING.md +51 -218
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/SKILL.md +58 -187
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/reference/gotchas.md +55 -154
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-optimize-bundle-size/SKILL.md +48 -401
- package/templates/webcomponents/igc-ts/avatar/default/files/src/app/__path__/__filePrefix__.ts +7 -2
- package/templates/webcomponents/igc-ts/button/default/files/src/app/__path__/__filePrefix__.ts +8 -3
- package/templates/webcomponents/igc-ts/card/default/files/src/app/__path__/__filePrefix__.ts +3 -1
- package/templates/webcomponents/igc-ts/constants.d.ts +5 -5
- package/templates/webcomponents/igc-ts/constants.js +5 -5
- package/templates/webcomponents/igc-ts/date-time-input/default/files/src/app/__path__/__filePrefix__.ts +8 -2
- package/templates/webcomponents/igc-ts/icon/default/files/src/app/__path__/__filePrefix__.ts +7 -3
- package/templates/webcomponents/igc-ts/icon-button/default/files/src/app/__path__/__filePrefix__.ts +8 -2
- package/templates/webcomponents/igc-ts/projects/_base/files/package.json +1 -1
- package/templates/webcomponents/igc-ts/projects/_base_with_home/files/package.json +6 -6
- package/templates/webcomponents/igc-ts/projects/ai-config/files/skills/README.md +1 -0
- package/templates/webcomponents/igc-ts/projects/side-nav-auth/files/src/app/authentication/login-bar/login-bar.ts +1 -1
- package/templates/webcomponents/igc-ts/tabs/default/files/src/app/__path__/__filePrefix__.ts +21 -15
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/references/mcp-setup.md +0 -78
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-grids/references/mcp-setup.md +0 -78
- package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-theming/references/mcp-setup.md +0 -81
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/CHARTS-GRIDS.md +0 -398
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/COMPONENT-CATALOGUE.md +0 -161
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/EVENT-HANDLING.md +0 -72
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/INSTALLATION.md +0 -139
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/JSX-PATTERNS.md +0 -187
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/MCP-SERVER.md +0 -77
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-components/reference/REFS-FORMS.md +0 -232
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/reference/MCP-SERVER.md +0 -67
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-customize-theme/reference/TROUBLESHOOTING.md +0 -35
- package/templates/react/igr-ts/projects/ai-config/files/skills/igniteui-react-generate-from-image-design/reference/component-mapping.md +0 -132
- /package/templates/webcomponents/igc-ts/tabs/default/files/src/app/__path__/{__filePrefix__.test → __filePrefix__.test.ts} +0 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "igniteui-cli",
|
|
3
|
-
"version": "15.
|
|
3
|
+
"version": "15.6.1",
|
|
4
4
|
"description": "CLI tool for creating Ignite UI projects",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"CLI",
|
|
@@ -66,9 +66,9 @@
|
|
|
66
66
|
"all": true
|
|
67
67
|
},
|
|
68
68
|
"dependencies": {
|
|
69
|
-
"@igniteui/angular-templates": "~22.
|
|
70
|
-
"@igniteui/cli-core": "~15.
|
|
71
|
-
"@igniteui/mcp-server": "~15.
|
|
69
|
+
"@igniteui/angular-templates": "~22.1.1561",
|
|
70
|
+
"@igniteui/cli-core": "~15.6.1",
|
|
71
|
+
"@igniteui/mcp-server": "~15.6.1",
|
|
72
72
|
"@inquirer/prompts": "^7.9.0",
|
|
73
73
|
"chalk": "^5.3.0",
|
|
74
74
|
"glob": "^11.0.0",
|
|
@@ -55,7 +55,10 @@ You are an expert in C#, Blazor, and scalable web application development. You w
|
|
|
55
55
|
- Component tests: bUnit for rendering and interaction verification
|
|
56
56
|
- Use Visual Studio's diagnostics tools for performance profiling
|
|
57
57
|
|
|
58
|
-
## UI Components
|
|
58
|
+
## UI Components — Ignite UI for Blazor
|
|
59
59
|
|
|
60
|
-
-
|
|
61
|
-
-
|
|
60
|
+
- **Packages**: `IgniteUI.Blazor.Lite` for general-purpose components and `IgniteUI.Blazor.GridLite` for the lightweight grid (both MIT, NuGet.org); `IgniteUI.Blazor` — publicly available for evaluation as `IgniteUI.Blazor.Trial` — for feature-rich grids, charts, maps, gauges, and Dock Manager. If the project already references the full `IgniteUI.Blazor`, do not add Lite or GridLite unless the user explicitly chooses to switch package strategy. If no Ignite UI package is present, add the one that matches the chosen strategy.
|
|
61
|
+
- **Setup**: `builder.Services.AddIgniteUIBlazor()` in `Program.cs`, `@using IgniteUI.Blazor.Controls` in `_Imports.razor`, one theme stylesheet, and `_content/IgniteUI.Blazor/app.bundle.js` before the Blazor framework script in the host page. Missing the script tag renders the app blank.
|
|
62
|
+
- **Do not write Ignite UI component, property, or event names from memory** — the Blazor API differs from the Angular, React, and Web Components products. Use the `skills/` reference files and the `igniteui-cli` MCP server.
|
|
63
|
+
- Prefer the `Async` form of component methods (`ShowAsync()`, not `Show()`); the sync twins require an in-process JS runtime and throw on Blazor Server.
|
|
64
|
+
- Style components with `--ig-*` design tokens on `igc-*` selectors, adding `::deep` in `.razor.css` files. Scope a theme to a page region with `IgbThemeProvider`.
|
|
@@ -1,61 +1,46 @@
|
|
|
1
|
-
# Ignite UI for Blazor
|
|
1
|
+
# Ignite UI for Blazor — AI Agent Skills
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Skill files for AI coding agents, plus the [`AGENTS.md`](./AGENTS.md) instruction file. Together they give an agent the Blazor coding standards and verified Ignite UI APIs needed to produce correct code instead of Angular- or React-flavored guesses.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Each skill is a `SKILL.md` routing hub with `references/` sub-files. The agent reads the hub, loads only the reference files the request touches, optionally verifies against the Ignite UI MCP servers, and writes code from that.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
**The skills work without the MCP servers.** The reference files are self-contained; the MCP servers add per-version doc and token verification. No skill will configure an MCP server on its own — each includes the config snippet for when a user asks.
|
|
8
8
|
|
|
9
|
-
Skills
|
|
9
|
+
## Skills for building apps *with* Ignite UI for Blazor
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
| Skill | Covers |
|
|
12
|
+
|---|---|
|
|
13
|
+
| [`igniteui-blazor-components`](./igniteui-blazor-components/SKILL.md) | Every non-grid component: setup, form controls, layout and navigation, data display, overlays, Tile/Dock Manager, and charts, gauges, maps, sparklines |
|
|
14
|
+
| [`igniteui-blazor-grids`](./igniteui-blazor-grids/SKILL.md) | `IgbGridLite`, `IgbGrid`, `IgbTreeGrid`, `IgbHierarchicalGrid`, `IgbPivotGrid` — columns, editing, features, paging and remote data, sizing, state, migration |
|
|
15
|
+
| [`igniteui-blazor-theming`](./igniteui-blazor-theming/SKILL.md) | Built-in themes, `IgbThemeProvider`, palettes, component design tokens, CSS parts, dark mode, layout tokens |
|
|
16
|
+
| [`igniteui-blazor-generate-from-image-design`](./igniteui-blazor-generate-from-image-design/SKILL.md) | End-to-end workflow for implementing a view from a design image; composes the three skills above |
|
|
12
17
|
|
|
13
|
-
|
|
18
|
+
## Skill for working *on* this repository
|
|
14
19
|
|
|
15
|
-
|
|
20
|
+
| Skill | Covers |
|
|
21
|
+
|---|---|
|
|
22
|
+
| [`igniteui-blazor-lite-testing`](./igniteui-blazor-lite-testing/SKILL.md) | The bUnit unit suite and Playwright integration suite under `tests/`, and how to author interop wire contracts |
|
|
16
23
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
| Component | Package | Use case |
|
|
20
|
-
|---|---|---|
|
|
21
|
-
| `IgbGridLite` | `IgniteUI.Blazor.GridLite` (MIT) | Read-only display with sorting, filtering, virtualization |
|
|
22
|
-
| `IgbGrid` | `IgniteUI.Blazor` | Flat tabular data - editing, grouping, paging, export |
|
|
23
|
-
| `IgbTreeGrid` | `IgniteUI.Blazor` | Self-referencing tree data (org charts, BOM) |
|
|
24
|
-
| `IgbHierarchicalGrid` | `IgniteUI.Blazor` | Multi-schema parent-child data |
|
|
25
|
-
| `IgbPivotGrid` | `IgniteUI.Blazor` | Pivot table analytics |
|
|
26
|
-
|
|
27
|
-
### [`igniteui-blazor-theming`](./igniteui-blazor-theming/SKILL.md)
|
|
28
|
-
|
|
29
|
-
Theme switching (Bootstrap, Material, Fluent, Indigo - light/dark), color palettes, CSS design tokens, dark mode, CSS shadow parts, and global layout tokens (roundness, spacing, size). All CSS is generated by the `igniteui-theming` MCP server - no token names are written from memory.
|
|
30
|
-
|
|
31
|
-
### [`igniteui-blazor-generate-from-image-design`](./igniteui-blazor-generate-from-image-design/SKILL.md)
|
|
32
|
-
|
|
33
|
-
End-to-end workflow for implementing a Blazor view from a design image or mockup. Combines all three skills above: analyzes the image, discovers components via MCP, generates a theme, implements the full view with mock data, and refines visual fidelity.
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## MCP Servers
|
|
38
|
-
|
|
39
|
-
Both servers must be configured in your AI tool. Setup instructions are in each skill's `references/mcp-setup.md`.
|
|
24
|
+
## MCP servers
|
|
40
25
|
|
|
41
26
|
| Server | Purpose | Key tools |
|
|
42
27
|
|---|---|---|
|
|
43
|
-
|
|
|
44
|
-
|
|
|
28
|
+
| `igniteui-cli` | Component docs and API reference | `list_components`, `get_doc`, `search_docs`, `search_api`, `get_api_reference` |
|
|
29
|
+
| `igniteui-theming` | Palette and design-token CSS generation | `create_palette`, `get_component_design_tokens`, `create_component_theme`, `set_roundness`, `set_spacing`, `set_size` |
|
|
45
30
|
|
|
46
|
-
|
|
31
|
+
Setup snippets are in each skill's `SKILL.md`.
|
|
47
32
|
|
|
48
|
-
## AGENTS.md
|
|
33
|
+
## AGENTS.md
|
|
49
34
|
|
|
50
|
-
[`AGENTS.md`](./AGENTS.md) is a
|
|
35
|
+
[`AGENTS.md`](./AGENTS.md) is a general-purpose agent instruction file for developers building Blazor applications **with** Ignite UI — it is not the AGENTS.md for this library's own repository.
|
|
51
36
|
|
|
52
|
-
Copy it (and optionally the `skills/` folder) into your Blazor application
|
|
37
|
+
Copy it (and optionally the `skills/` folder) into your Blazor application and place it where your tool reads project instructions:
|
|
53
38
|
|
|
54
|
-
|
|
|
55
|
-
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
39
|
+
| Tool | File |
|
|
40
|
+
|---|---|
|
|
41
|
+
| Claude Code | `CLAUDE.md` in the project root |
|
|
42
|
+
| GitHub Copilot (VS Code) | `.github/copilot-instructions.md` |
|
|
43
|
+
| Cursor | `.cursor/rules/igniteui-blazor.mdc` (or legacy `.cursorrules`) |
|
|
44
|
+
| Windsurf | `.windsurfrules` |
|
|
45
|
+
| Codex CLI | `AGENTS.md` in the project root |
|
|
46
|
+
| Aider | `CONVENTIONS.md`, or `--read AGENTS.md` at startup |
|
package/templates/blazor/igb/projects/ai-config/files/skills/igniteui-blazor-components/SKILL.md
CHANGED
|
@@ -1,120 +1,72 @@
|
|
|
1
1
|
---
|
|
2
|
+
license: MIT
|
|
2
3
|
name: igniteui-blazor-components
|
|
3
|
-
description: "
|
|
4
|
+
description: "Ignite UI for Blazor non-grid components: project setup and module registration; form controls (input, textarea, combo, select, date/time pickers, calendar, checkbox, radio, switch, slider, rating, mask input); layout and navigation (tabs, stepper, accordion, expansion panel, nav drawer, navbar, tree, splitter, divider); data display (list, card, carousel, avatar, badge, chip, icon, progress, dropdown, tooltip, chat); overlays (dialog, snackbar, toast, banner); Dock Manager and Tile Manager; and visualizations (charts, gauges, maps, sparklines). Use for any Ignite UI Blazor component that is not a data grid. For data grids use igniteui-blazor-grids; for theming and CSS use igniteui-blazor-theming."
|
|
4
5
|
user-invocable: true
|
|
5
6
|
---
|
|
6
7
|
|
|
7
8
|
# Ignite UI for Blazor - UI Components
|
|
8
9
|
|
|
9
|
-
##
|
|
10
|
+
## How to use this skill
|
|
10
11
|
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
- `@using IgniteUI.Blazor.Controls` added to `_Imports.razor`
|
|
15
|
-
- A theme CSS file and `_content/IgniteUI.Blazor/app.bundle.js` runtime script linked in the host page (see [`references/setup.md`](./references/setup.md))
|
|
16
|
-
- The **Ignite UI CLI MCP server** (`igniteui-cli`) is available as a tool provider
|
|
12
|
+
1. Map the request to rows in the routing table below and read **every** matching reference file (in one parallel batch). A request often spans several — a form inside a dialog needs `form-controls.md` **and** `feedback.md`.
|
|
13
|
+
2. If the `igniteui-cli` MCP server is available, call `get_doc(framework: "blazor", name: "<slug>")` for each component involved, and `search_api` / `get_api_reference` for exact property, event, and method signatures. MCP output wins over this skill on any conflict.
|
|
14
|
+
3. Write code from what you read. The reference files carry verified Blazor APIs — do not substitute Angular, React, or Web Components syntax from memory, and say so plainly when something is not covered rather than guessing.
|
|
17
15
|
|
|
18
|
-
|
|
19
|
-
>
|
|
20
|
-
> Before using any Ignite UI CLI MCP tools, you MUST verify the MCP server is available
|
|
21
|
-
> by calling `list_components(framework: "blazor")`. If the tool is not available or the call fails,
|
|
22
|
-
> you MUST automatically configure it by following the setup process steps described below.
|
|
23
|
-
>
|
|
24
|
-
> After writing the file, inform the user that the MCP server has been
|
|
25
|
-
> configured and they may need to reload the editor for the tools to activate.
|
|
26
|
-
> Start the MCP server and wait for that MCP server to start before continuing the component-related work.
|
|
27
|
-
> Do NOT skip this step or ask the user to do it manually.
|
|
16
|
+
**Without the MCP server this skill still works** — the reference files are self-contained. Do not configure MCP unprompted; if the user wants it, see [MCP server (optional)](#mcp-server-optional).
|
|
28
17
|
|
|
29
|
-
|
|
18
|
+
### Routing table
|
|
30
19
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
You are **required** to complete ALL of the following steps before producing any component-related code or answer:
|
|
41
|
-
|
|
42
|
-
**STEP 1 - Identify every component or feature involved.**
|
|
43
|
-
Map the user's request to one or more rows in the Task → Reference File table below. A single request often spans multiple categories (e.g., a form inside a Dialog requires reading both `form-controls.md` AND `feedback.md`).
|
|
20
|
+
| Task | Read |
|
|
21
|
+
|---|---|
|
|
22
|
+
| NuGet install, `Program.cs`, `_Imports.razor`, theme CSS + script tags, project types (Server / WASM / Web App / MAUI), render modes | [`references/setup.md`](./references/setup.md) |
|
|
23
|
+
| Input, Textarea, Combo, Select, Date Picker, Date Range Picker, Calendar, Date Time Input, Mask Input, Checkbox, Radio, Switch, Slider, Range Slider, Rating, value binding | [`references/form-controls.md`](./references/form-controls.md) |
|
|
24
|
+
| Tabs, Stepper, Accordion, Expansion Panel, Nav Drawer, Navbar, Tree, Splitter, Divider | [`references/layout.md`](./references/layout.md) |
|
|
25
|
+
| List, Card, Carousel, Avatar, Badge, Chip, Icon, Icon Button, Button, Button Group, Circular/Linear Progress, Dropdown, Tooltip, Ripple, Chat, Highlight | [`references/data-display.md`](./references/data-display.md) |
|
|
26
|
+
| Dialog, Snackbar, Toast, Banner | [`references/feedback.md`](./references/feedback.md) |
|
|
27
|
+
| Dock Manager, Tile Manager | [`references/layout-manager.md`](./references/layout-manager.md) |
|
|
28
|
+
| Category / Data / Financial / Pie / Donut charts, Sparkline, Treemap, Geographic Map, Gauges, Dashboard Tile, chart features | [`references/charts.md`](./references/charts.md) |
|
|
44
29
|
|
|
45
|
-
|
|
46
|
-
Call `read_file` (or equivalent) on **all** reference files identified in Step 1 **in a single parallel batch**. Reference files map components to their MCP doc slugs and explain which MCP calls to make.
|
|
30
|
+
## Packages
|
|
47
31
|
|
|
48
|
-
|
|
49
|
-
|
|
32
|
+
| Package | Source | Contains |
|
|
33
|
+
|---|---|---|
|
|
34
|
+
| `IgniteUI.Blazor.Lite` | NuGet.org, MIT | Core UI components: forms, layout, navigation, data display, feedback, Tile Manager, Theme Provider |
|
|
35
|
+
| `IgniteUI.Blazor.GridLite` | NuGet.org, MIT | `IgbGridLite` only |
|
|
36
|
+
| `IgniteUI.Blazor` | Infragistics licensed feed | Full suite: everything above plus charts, maps, gauges, Dock Manager, enterprise grids |
|
|
37
|
+
| `IgniteUI.Blazor.Trial` | NuGet.org | Same as `IgniteUI.Blazor`, watermarked |
|
|
50
38
|
|
|
51
|
-
|
|
39
|
+
All four use the `IgniteUI.Blazor.Controls` namespace and serve static assets from `_content/IgniteUI.Blazor/` (except `IgniteUI.Blazor.GridLite`, which uses `_content/IgniteUI.Blazor.GridLite/`). **Do not mix `IgniteUI.Blazor` with `IgniteUI.Blazor.Lite`** — duplicate types in the same namespace. If the project already references the full package, do not add Lite/GridLite unless the user asks to switch strategy.
|
|
52
40
|
|
|
53
|
-
|
|
41
|
+
## Rules that apply to every component
|
|
54
42
|
|
|
55
|
-
**
|
|
56
|
-
|
|
43
|
+
- **Registration.** `builder.Services.AddIgniteUIBlazor()` in `Program.cs` is required. Passing `typeof(Igb<Name>Module)` arguments eagerly pre-loads exactly those modules; with no arguments every module is available. In `IgniteUI.Blazor.Lite` each component also registers its own module on first render, so the explicit list is a bundle-size optimization rather than a correctness requirement.
|
|
44
|
+
- **Runtime script.** `<script src="_content/IgniteUI.Blazor/app.bundle.js"></script>` must appear before the Blazor framework script in the host page. Missing it means no web components register and the app renders blank.
|
|
45
|
+
- **Theme CSS.** Exactly one theme stylesheet, e.g. `_content/IgniteUI.Blazor/themes/light/bootstrap.css`.
|
|
46
|
+
- **Slots.** Composition uses named slots (`slot="start"`, `slot="title"`, `slot="footer"`, …), not wrapper components. Use `IgbIcon` inside slots — a font-icon `<span>` is `display: inline` and drifts to the top of the slot's flex box.
|
|
47
|
+
- **`@ref`.** Declare a field of the component type and use `@ref` for programmatic calls (`await dialog.ShowAsync()`). The reference is `null` until after first render. Some components need `await component.EnsureReady()` before their async methods in `OnAfterRenderAsync(firstRender)` — icon registration especially.
|
|
48
|
+
- **Parameters are PascalCase** (`ChartType`, `DataSource`), never Angular-style `[chartType]`.
|
|
49
|
+
- **`Name` is not an HTML name attribute.** On every Ignite UI component `Name` is the framework's element identity used for lookups. Do not use it to group radios or to name a form field.
|
|
50
|
+
- **Forms.** There is no universal form-integration pattern; several components (`IgbCombo`, `IgbRadio`) do not participate in a plain HTML `<form>`. Bind explicitly with `@bind-Value` / `@bind-Checked` and check the component's doc before assuming form behavior.
|
|
51
|
+
- **Dynamic `class` values** must be a single C# expression (`class="@ChipClass(item)"`). Mixing literal text with `@(...)` in one attribute raises **RZ9986**.
|
|
57
52
|
|
|
58
|
-
|
|
53
|
+
## MCP server (optional)
|
|
59
54
|
|
|
60
|
-
|
|
61
|
-
|---|---|
|
|
62
|
-
| NuGet install, `Program.cs` registration, `_Imports.razor`, CSS/script references, project types (Server, WASM, Web App, MAUI) | [`references/setup.md`](./references/setup.md) |
|
|
63
|
-
| Input, Combo Box, Select, Date Picker, Date Range Picker, Calendar, Date Time Input, Mask Input, Checkbox, Radio / Radio Group, Switch, Slider / Range Slider, Rating, form/value binding | [`references/form-controls.md`](./references/form-controls.md) |
|
|
64
|
-
| Tabs, Stepper, Accordion, Expansion Panel, Navigation Drawer, Navbar, Tree | [`references/layout.md`](./references/layout.md) |
|
|
65
|
-
| List, Card, Carousel, Avatar, Badge, Chip, Icon, Icon Button, Button, Button Group, Circular Progress, Linear Progress, Dropdown, Tooltip, Ripple | [`references/data-display.md`](./references/data-display.md) |
|
|
66
|
-
| Dialog, Snackbar, Toast, Banner | [`references/feedback.md`](./references/feedback.md) |
|
|
67
|
-
| Dock Manager (panes, tabs, floating, serialization), Tile Manager | [`references/layout-manager.md`](./references/layout-manager.md) |
|
|
68
|
-
| Category Chart, Data Chart, Financial / Stock Chart, Pie Chart, Donut Chart, Sparkline, Treemap, Geographic Map, Gauges, Dashboard Tile, visualization features (animations, tooltips, markers, highlighting, zooming, legends, maps, ranges) | [`references/charts.md`](./references/charts.md) |
|
|
55
|
+
`igniteui-cli` provides `list_components`, `get_doc`, `search_docs`, `search_api`, `get_api_reference`, all taking `framework: "blazor"`. To enable it, add to `.vscode/mcp.json` (VS Code, key `servers`):
|
|
69
56
|
|
|
70
|
-
|
|
57
|
+
```json
|
|
58
|
+
{ "servers": { "igniteui-cli": { "command": "npx", "args": ["-y", "igniteui-cli", "mcp"] } } }
|
|
59
|
+
```
|
|
71
60
|
|
|
72
|
-
|
|
61
|
+
Or `.cursor/mcp.json` / `claude_desktop_config.json` (key `mcpServers`):
|
|
73
62
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
| `IgniteUI.Blazor.GridLite` | NuGet.org | Open-source / MIT users needing the lightweight `IgbGridLite` data grid |
|
|
78
|
-
| `IgniteUI.Blazor` | Infragistics private NuGet feed (`https://packages.infragistics.com/nuget/licensed/`) | Licensed / enterprise users that need the full component suite (grids, charts, maps, gauges, Dock Manager) |
|
|
79
|
-
| `IgniteUI.Blazor.Trial` | NuGet.org | Evaluation users - same full suite as `IgniteUI.Blazor` but with a trial watermark |
|
|
80
|
-
|
|
81
|
-
`IgniteUI.Blazor.Lite` contains the open-source UI component set, while `IgniteUI.Blazor.GridLite` contains the free `IgbGridLite` data grid package. Both use the `IgniteUI.Blazor.Controls` namespace. Do **not** mix the licensed `IgniteUI.Blazor` package with `IgniteUI.Blazor.Lite` in the same project; they use the same namespaces and duplicate some components. If full `IgniteUI.Blazor` is already referenced, do not add Lite/GridLite unless the user explicitly asks to switch package strategy.
|
|
82
|
-
|
|
83
|
-
## Key Blazor-Specific Notes
|
|
84
|
-
|
|
85
|
-
Add the Ignite UI runtime script before the Blazor framework script in the host page: `<script src="_content/IgniteUI.Blazor/app.bundle.js"></script>`. **If this script is missing, web components will not register and the app will render blank or broken. Verify this is present in every new project.**
|
|
86
|
-
|
|
87
|
-
> **AGENT INSTRUCTION - Module Registration**
|
|
88
|
-
>
|
|
89
|
-
> Every Ignite UI for Blazor component **and its sub-components** has a corresponding module. Register **all** modules for every component used on the page in `Program.cs`:
|
|
90
|
-
>
|
|
91
|
-
> ```csharp
|
|
92
|
-
> builder.Services.AddIgniteUIBlazor(typeof(IgbComboModule), typeof(IgbDatePickerModule));
|
|
93
|
-
> ```
|
|
94
|
-
>
|
|
95
|
-
> Calling `builder.Services.AddIgniteUIBlazor()` with no arguments registers ALL modules (useful for prototypes but increases bundle size). Prefer explicit module registration in production.
|
|
96
|
-
|
|
97
|
-
> **AGENT INSTRUCTION - `@ref` and `EnsureReady`**
|
|
98
|
-
>
|
|
99
|
-
> When accessing a component from C# code (e.g., to call `ShowAsync()` on a dialog), use `@ref`:
|
|
100
|
-
>
|
|
101
|
-
> ```razor
|
|
102
|
-
> <IgbDialog @ref="DialogRef" />
|
|
103
|
-
>
|
|
104
|
-
> @code {
|
|
105
|
-
> public IgbDialog DialogRef { get; set; }
|
|
106
|
-
> }
|
|
107
|
-
> ```
|
|
108
|
-
>
|
|
109
|
-
> Some components (e.g., `IgbIcon`) require `await component.EnsureReady()` before calling async registration methods in `OnAfterRenderAsync(bool firstRender)`.
|
|
110
|
-
|
|
111
|
-
> **AGENT INSTRUCTION - Forms**
|
|
112
|
-
>
|
|
113
|
-
> Several Ignite UI Blazor components such as `IgbCombo` and `IgbRadio` do **not** work with the standard HTML `<form>` element. Do not assume a universal form pattern. Check the component's MCP doc first, bind component values explicitly (`@bind-Value`, `@bind-Checked`, or documented change events), and only use form integration patterns shown by the current docs.
|
|
63
|
+
```json
|
|
64
|
+
{ "mcpServers": { "igniteui-cli": { "command": "npx", "args": ["-y", "igniteui-cli", "mcp"] } } }
|
|
65
|
+
```
|
|
114
66
|
|
|
115
|
-
|
|
67
|
+
Reload the editor afterwards. JetBrains: **Settings → Tools → AI Assistant → MCP Servers**, command `npx`, arguments `igniteui-cli mcp`.
|
|
116
68
|
|
|
117
|
-
## Related
|
|
69
|
+
## Related skills
|
|
118
70
|
|
|
119
|
-
- [`igniteui-blazor-grids`](../igniteui-blazor-grids/SKILL.md)
|
|
120
|
-
- [`igniteui-blazor-theming`](../igniteui-blazor-theming/SKILL.md)
|
|
71
|
+
- [`igniteui-blazor-grids`](../igniteui-blazor-grids/SKILL.md) — Grid, Tree Grid, Hierarchical Grid, Pivot Grid, Grid Lite
|
|
72
|
+
- [`igniteui-blazor-theming`](../igniteui-blazor-theming/SKILL.md) — themes, palettes, design tokens, CSS parts
|