@expcat/tigercat-cli

@expcat/tigercat-cli

CLI tooling for the Tigercat UI component library.

Installation

pnpm add -g @expcat/tigercat-cli
# or
npx @expcat/tigercat-cli

Usage Examples

Start a Vue 3 project

tigercat create admin-console --template vue3
cd admin-console
pnpm install
pnpm dev

Preview the generated file list without writing files:

tigercat create admin-console --template vue3 --dry-run

Start a React project

tigercat create design-lab --template react
cd design-lab
pnpm install
pnpm dev

Add component boilerplate to an existing project

Run from a project that already depends on @expcat/tigercat-vue or @expcat/tigercat-react:

tigercat add Button Form Input Select
tigercat add --framework vue3 --install --snippet src/tigercat-components.ts

When no component names are provided, add opens an interactive multi-select prompt. The command prints the correct package import, detects missing peer dependencies, can install them with --install, and creates src/components/*Demo.vue or src/components/*Demo.tsx files when a src/components directory exists.

tigercat add Button Form Input Select --dry-run

Open a temporary playground

tigercat playground --template vue3 --port 3456
tigercat playground --template react --port 3457
tigercat playground --template react --no-open

Playground files are created under .tigercat-playground/ in the current working directory.

tigercat playground --template react --port 3457 --dry-run

Generate API docs from type definitions

tigercat generate docs --input packages/core/src/types --output docs/api
tigercat generate docs --input packages/core/src/types --output docs/api --dry-run
tigercat generate test Button --framework both
tigercat generate doc-template Button --output docs/components

Check project compatibility

tigercat doctor
tigercat doctor --json

doctor verifies package.json, Node.js, pnpm, Tailwind CSS, Tigercat peer dependencies, template dependency compatibility, and the supported version compatibility matrix. JSON output is designed for CI and automated diagnostics.

The full command matrix for agents is cli.md.

Windows Support

The CLI is fully cross-platform. All template file paths use forward slashes and are resolved via Node.js path.resolve() at write time, so they work correctly on Windows with backslash paths, paths containing spaces, and UNC paths.

Package Manager .cmd Shims

When installed globally or locally, each package manager creates platform-specific shims so that tigercat can be invoked directly from PowerShell, CMD, or Git Bash:

Package manager	Global install	Shim files created
pnpm	pnpm add -g @expcat/tigercat-cli	tigercat.cmd, tigercat (sh)
npm	npm i -g @expcat/tigercat-cli	tigercat.cmd, tigercat (sh), tigercat.ps1
bun	bun add -g @expcat/tigercat-cli	tigercat.cmd, tigercat (sh)

For local (non-global) installs, run via npx tigercat, pnpm exec tigercat, or bunx tigercat. The #!/usr/bin/env node shebang in the built output is used by all three package managers to locate the Node.js runtime.

On Windows, spawn pnpm with shell: true when using Corepack; repo scripts already do this via scripts/utils/pnpm.mjs.

License

MIT