@sig-ui/cli

CLI workflows for SigUI project setup, token builds, validation, and template installation.

What this package is for

Use @sig-ui/cli to:

• initialize project config and generated outputs
• regenerate CSS/token artifacts after config changes
• validate contrast, target sizes, and layout quality
• copy component templates for project-owned customization

How it fits in SigUI

Tooling layer over all runtime libraries.

• Uses @sig-ui/core + @sig-ui/theme for deterministic generation/checks.
• Integrates with @sig-ui/components conventions for add workflow.
• Produces assets consumed directly by apps and components.

Install

bun add -d @sig-ui/cli

or run directly:

bunx sigui --help

Commands

bunx sigui init --brand=#6366f1
bunx sigui build --watch
bunx sigui check --full
bunx sigui add button card tabs --dir=src/ui/components

Config typing example

/** @type {import("@sig-ui/theme").SiguiConfig} */
const config = { brand: "#6366f1" };

export default config;

Full docs

• docs/ARCHITECTURE_OVERVIEW.md
• docs/CLI.md
• docs/CORE.md and docs/THEME.md (generation/check internals)
• docs/COMPONENTS.md (template conventions)