Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
default
✓ import zartCli from 'zart-cli'
✗ const zartCli = require('zart-cli')
zart-cli is a CLI tool; programmatic usage is not typical, but the package exports a default object.
cli
✓ import { cli } from 'zart-cli'
✗ import { CLI } from 'zart-cli'
The CLI entry is exported as 'cli' (lowercase), not 'CLI'.
create
✓ import { create } from 'zart-cli'
✗ const create = require('zart-cli').createCreator
Use the named import 'create' for programmatic project scaffolding.
Shows installing zart-cli, creating a new project, and running dev/build/test/lint commands.
// Install globally or locally
npm install -g zart-cli
# Create a new project interactively
npx zart-cli create my-component-library
# Or programmatically (ESM)
import { create } from 'zart-cli';
create({ projectName: 'my-lib', template: 'default' });
# Start development server
cd my-component-library
zart-cli dev
# Build for production
zart-cli build
# Run tests
zart-cli test
# Lint code
zart-cli lint
Debug
Known issues
breakingNode version requirement: zart-cli requires Node >=10. Older Node versions will crash.fixUpgrade Node.js to version 10 or higher.
affects: >=20.0.0
deprecatedThe `zart-cli release` command may be deprecated in future versions; use `zart-cli build` and manual publishing instead.fixMigrate to manual releases following the documentation.
affects: >=20.0.0
gotchaHusky hooks configuration in package.json may not work with Husky v5+ due to changed configuration format.fixMigrate Husky configuration to .husky directory or use older Husky v4.
affects: >=18.0.0 <21.0.0
gotchaThe default ESLint config extends '@vant', which requires the `eslint-config-vant` package to be installed separately.fixInstall eslint-config-vant as a dev dependency: npm install eslint-config-vant --save-dev
affects: >=20.0.0
Errors
Common errors & fixes
Cannot find module 'zart-cli'
Global installation missing or local node_modules not found
fixInstall zart-cli globally: npm install -g zart-cli, or ensure it's listed in devDependencies and run npm install
zart-cli: command not found
Package not installed or not in PATH
fixInstall zart-cli globally or use npx: npx zart-cli dev
Error: Vue template compiler not found
Missing peer dependency vue-template-compiler
fixInstall vue-template-compiler: npm install vue-template-compiler --save-dev
Audit
Dependencies
vuerequiredPeer dependency: required by the component library being built
vue-template-compilerrequiredPeer dependency: required for Vue 2 template compilation