@native-mate/cli

The command-line tool for native-mate. Initialize projects, add components, list the registry, and upgrade installed components.

View on npm →

Installation

No global install needed — use npx to run any command:

bash
1
2
npx @native-mate/cli init
npx @native-mate/cli add button

Or install globally:

bash
1
2
npm install -g @native-mate/cli
native-mate init

Commands

CommandDescription
initInitialize native-mate in your project — creates config, installs @native-mate/core
add <components...>Fetch components from registry and write to your project
add --allInstall all available components at once
list (ls)List all available components grouped by category
upgrade [components...]Check for and apply component updates

Features

  • Arrow-key navigation and multi-select for interactive component picking
  • Automatic dependency resolution (components and npm packages)
  • 4 theme presets: zinc, slate, rose, midnight
  • Overwrite protection with --overwrite flag
  • Custom registry support via -r flag
  • Version tracking and hash-based upgrade detection
  • Auto-detects your package manager (npm, yarn, pnpm, bun)

Full reference