<!-- Auto-generated by `velinstyle docs generate`. Do not edit. Source: cli/cli-manifest.json -->

# CLI commands

VelinStyle CLI v1.4.0. Run `velinstyle --help` for full usage.

| Command | Summary | Subcommands | Flags | Example |
| --- | --- | --- | --- | --- |
| `init` | Create velinstyle.config.js, optional vendor copy, and starter HTML with reveal/sprite defaults | — | — | `velinstyle init` |
| `build` | Build custom CSS with selected layers from config, or production output with --production | — | --output, -o, --out, --minify, --preset, --production, --explain, --watch, --report, --safelist | `velinstyle build --production --explain -o ./dist/velin-production` |
| `production` | Content-aware production builder (CSS/JS/themes/icons/fonts/motion + report) | — | --out, -o, --explain, --watch, --report, --safelist, --no-js, --no-icons, --no-themes, --no-motion, --no-minify | `velinstyle production . --explain --report ./report.json` |
| `themes` | List available built-in themes | — | — | `velinstyle themes` |
| `add` | Add a single component CSS file to your project | — | — | `velinstyle add button` |
| `icons` | Manage icon providers (list, add, remove, build) | list, add, remove, build | --icons, --variant | `velinstyle icons add lucide --icons menu,search` |
| `scan` | Security, accessibility, CSS, and PII scanner; machine --json/--sarif; SAFE Apply via --fix/--fix-dry-run only | — | --format, --severity, --only, --fix, --fix-dry-run, --fix-lang, --json, --sarif | `velinstyle scan index.html` |
| `prefix` | Add missing velin- prefix to classes (dry-run; use --write) | — | --write, --map, --bootstrap-display | `velinstyle prefix src/ --write` |
| `migrate` | Tailwind → VelinStyle migration (dry-run by default; --write applies Mapped only) | tailwind, rollback | --dry-run, --write, --apply, --compat, --heuristic, --snapshot, --json | `velinstyle migrate tailwind ./my-project` |
| `blueprint` | Print HTML blueprint snippets; --strict fails on classes missing from CSS | list | --output, -o, --strict | `velinstyle blueprint modal -o snippet.html --strict` |
| `create` | Scaffold a runnable project: landing \| dashboard \| docs \| auth | landing, dashboard, docs, auth | --theme, --no-copy | `velinstyle create landing ./my-site --theme earth` |
| `serve` | Serve a directory over HTTP (default port 4173) | — | --port | `velinstyle serve . --port 4173` |
| `doctor` | Check dist assets, themes, config, icons, and Windows ESM import hints | — | — | `velinstyle doctor` |
| `check` | Aggregate gate: doctor + blueprint --strict + scan + review (alias: validate) | — | --json, --sarif, --profile | `velinstyle check . --profile marketing` |
| `scaffold` | Plan-first page HTML, recipe fragment, or Atelier Library compose (--atelier, beta) | list-intents | --output, -o, --json, --atelier, --from, --base-url | `velinstyle scaffold --atelier 04,07 -o compose.html --from ./atelier/library` |
| `plan` | Emit page plan JSON from a prompt or --atelier Library ids (beta) | — | --output, -o, --json, --atelier | `velinstyle plan --atelier 04,07` |
| `atelier` | Pull curated Atelier Library showcase by number/id; blade/vue/react = wrappers only | list | --output, -o, --format, --from, --base-url, --rewrite-vendor | `velinstyle atelier 36 -o ./velin-atelier/36-calendar --format html` |
| `review` | Design / a11y / SEO / performance / conversion review gate | — | --json, --prompt, --profile | `velinstyle review out.html --profile marketing` |
| `wc` | Inspect Web Component APIs from source | api | — | `velinstyle wc api velin-toast` |
| `layout` | Responsive layout audit (flex, grid, viewport) | audit, suggest, fix | --json, --write, --dry-run | `velinstyle layout suggest index.html` |
| `perf` | Performance audit for images and scripts (directory or .html file) | audit, suggest, fix | --json, --write, --dry-run | `velinstyle perf audit index.html` |
| `tokens` | Build or validate design tokens JSON | build, validate | --input, --output, -o | `velinstyle tokens validate --input examples/tokens.full.json` |
| `docs` | Generate developer reference Markdown (alias: documentation) | generate | --scope, --out | `velinstyle docs generate --scope all` |
| `meta` | Build Velin-Meta agent bundle; page --write merges curated goals/intent | page | --out, --llms-out, --base-url, --no-llms, --write | `velinstyle meta page index.html --write` |
| `search` | Build JSON search index for VelinSearch | index | --out, --extra-html | `velinstyle search index --out dist/search-index.json` |
| `skills` | Registry-first AI skill catalog and install runner | list, show, install, run, validate, doctor, packs, bundles, templates, projects, graphs | --capability, --status, --priority, --origin, --category, --target, --no-deps, --json, --human | `velinstyle skills show scaffold.landing --human` |
| `blocks` | Velin Blocks registry — list, info, and ownership install (velinstyle blocks add) | list, info, add | --force, --out, --dry-run, --json | `velinstyle blocks list` |
| `workflow` | Resolve workflow graph or project workflow steps | — | --json, --dry-run, --step | `velinstyle workflow landingpage --json` |
| `dashboard` | Aggregate Production, Review, Accessibility, Transparency, Performance, Security | — | — | `velinstyle dashboard` |
| `replay` | Replay a Velin Experience record.json through the same renderer | — | — | `velinstyle replay record.json` |
| `transparency` | Transparency Framework doctor, validate, report, export, migrate | doctor, validate, report, export, migrate | --policy, --json | `velinstyle transparency doctor .` |
| `motion` | Velin Motion — page registry + clip pipeline (create, atelier, AI providers) | list, presets, create, atelier, transition, sequence, export, usage, providers, setup, zoom, pan, rotate, particles, intro, outro, doctor, scan, policy, demo, analyze, review, report, optimize, blueprint | --json, --write, --out, --output, -o, --policy, --preset, --ai, --yes, -y, --provider, --model, --quality, --duration, --style, --prompt, --count, --dry-run, --clips | `velinstyle motion create atelier.webp` |
| `security` | Velin Security Suite — Security Engine: doctor, scan, audit, publish, ci, deps, secrets, report | doctor, scan, audit, publish, ci, deps, secrets, report | --json, --strict, --repo, --consumer, --ci, --publish, --deps, --secrets, --out, --output, -o | `velinstyle security doctor .` |