@nativeui/cli

CLI for adding beautifully designed, accessible UI components to your Expo and React Native projects.

Copy-paste components. You own the code.

Installation

``bash
npx @nativeui/cli init
`

Or install globally:

`bash
npm install -g @nativeui/cli
nativeui init
`

Quick Start

1. Initialize your project:

`bash
npx @nativeui/cli init
`

This creates a mcellui.config.ts with your theme preferences.

2. Add components:

`bash
npx @nativeui/cli add button
npx @nativeui/cli add card input badge
`

3. Use in your app:

`tsx
import { Button } from '@/components/ui/button';

export function MyScreen() {
return (
console.log('Pressed!')}>
Get Started

);
}
`

Commands

$3

Initialize nativeui in your project.

`bash
npx @nativeui/cli init
`

Creates mcellui.config.ts with theme configuration.

$3

Add one or more components to your project.

`bash
npx @nativeui/cli add button
npx @nativeui/cli add card input badge avatar
`

$3

List all available components.

`bash
npx @nativeui/cli list
npx @nativeui/cli list --category="Inputs"
`

$3

Interactive component picker with categories.

`bash
npx @nativeui/cli pick
`

$3

Show available updates for installed components.

`bash
npx @nativeui/cli diff
npx @nativeui/cli diff button
`

$3

Update installed components to latest version.

`bash
npx @nativeui/cli update button
npx @nativeui/cli update --all
npx @nativeui/cli update --all --dry-run
`

$3

Check project setup and diagnose issues.

`bash
npx @nativeui/cli doctor
`

$3

Scaffold a new custom component.

`bash
npx @nativeui/cli create my-component
npx @nativeui/cli create my-button --template=pressable
`

Templates: basic, animated, pressable, input

Configuration

mcellui.config.ts:

`ts
import { defineConfig } from '@nativeui/cli';

export default defineConfig({
// Theme preset: zinc, slate, stone, blue, green, rose, orange, violet
theme: 'violet',

// Border radius: none, sm, md, lg, full
radius: 'md',

// Color scheme: light, dark, system
colorScheme: 'system',

// Output directory for components
componentsDir: './components/ui',
});
`

Available Components

$3

`bash
npx @nativeui/cli add login-block
npx @nativeui/cli add profile-block settings-list-block
`

Available: login-block, signup-block, profile-block, settings-list-block, empty-state-block, error-state-block`, and more.

Requirements

- Node.js 18+
- Expo SDK 54+ or React Native 0.76+
- TypeScript recommended

Links

- Documentation
- Components
- GitHub

License

MIT