zard

Installs, composes, and styles zard/ui Angular components via the zard-cli and registry.

1.1k|95|Updated Mar 5, 2025
One-click install
npx skills add https://github.com/zard-ui/zardui --skill zard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zard
Source: https://github.com/zard-ui/zardui/tree/main/skills/zard
Command: npx skills add https://github.com/zard-ui/zardui --skill zard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires zard-cli, zard-mcp, and includes references (resource) components.

What problem does it solve?

Working with zard/ui requires knowing the real component APIs, the project configuration in components.json, and the correct CLI commands — guessing inputs or import paths is the most common failure mode. This Skill grounds every action in the actual project configuration, the published registry, and the component documentation instead of remembered APIs.

Core Features & Use Cases

  • Project-aware component management: Reads components.json to resolve aliases, project type (angular, nx, analog, libraries), icon family, and package manager before running zard-cli init or add.
  • Real API access: Uses the registry index, published Markdown docs, and the zard-mcp server (list-components, get-component-docs, install-component) so code is written against the actual component API.
  • Enforced conventions: Applies zard/ui rules for standalone OnPush components, signal inputs, semantic Tailwind v4 tokens, CVA variants, composition patterns, forms, icons, and typeset prose styling.
  • Use Case: A developer asks to add a settings page to an Nx workspace — the Skill reads components.json, confirms which components are installed, adds card/field/input/button via npx zard-cli add, and composes the page using z-card, z-field-group, and variant inputs rather than custom markup.

Quick Start

Ask the assistant to set up zard/ui in your Angular project and add a button and card component using the project's package manager.

Frequently Asked Questions about zard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a zard/ui component to my Angular project?

Run npx zard-cli add <name> with your project's package runner after init has written components.json. The CLI resolves npm dependencies and other registry items automatically, then writes the component source into the directory configured by aliases.components.

How do I set up zard/ui in an Nx workspace?

Run npx zard-cli init --type nx --project <name> to configure the workspace application. Nx project types write path aliases to tsconfig.base.json instead of the project tsconfig, and Tailwind is configured per project rather than at the workspace root.

Does zard/ui work with Angular libraries and Analog apps?

Yes, init supports angular-library, nx-library, and analog project types. Libraries skip app.config.ts registration and ship theme CSS as an asset, while Analog uses the Tailwind Vite plugin instead of PostCSS.

Why does my zard/ui icon render nothing in Angular?

Icons render nothing when the symbol is not registered with provideIcons in the component's viewProviders. The icon family comes from the icons field in components.json, and the template name must exactly match the imported @ng-icons symbol.

Can I use zard/ui with a private component registry?

Yes, set registryUrl in components.json or ZARD_REGISTRY_URL in the environment to point at your own registry. The registry must serve registry.json, per-item JSON files, and icons.json matching the published schemas.

What commands does zard-cli support?

zard-cli has only two commands: init to set up a project and add to install components. There is no search, view, diff, info, or build command — use the registry index or the zard-mcp server to discover components and read documentation.