nativeui-cli

The CLI for Native UI — a collection of beautiful, native-feeling React Native and Expo components that you fully own. The CLI for Native UI — a collection of beautiful, native-feeling React Native and Expo components that you fully own.

Unlike traditional component libraries, Native UI copies component source code directly into your project. No black boxes, no lock-in, and no fighting library abstractions.

Features

• 🎨 Native-feeling UI components for Expo and React Native
• 📦 Copy components directly into your codebase
• 🌗 Built-in dark mode support
• ⚡ Reanimated-powered interactions and animations
• ♿ Accessible by default
• 🔧 Fully customizable source code
• 🚫 No vendor lock-in

Quick Start

Initialize Native UI in your project:

npx nativeui-cli@latest init

Then add components:

npx nativeui-cli@latest add button typography

Commands

init

Set up Native UI in your project.

nativeui-cli init

Creates:

• native-ui.json
• Theme utilities
• Required dependencies
• Project configuration

Options

| Flag | Description | | ------------- | -------------------------------- | | -y, --yes | Skip prompts and use defaults | | -f, --force | Overwrite existing configuration |

add

Add one or more components.

nativeui-cli add button

nativeui-cli add button input card

nativeui-cli add --all

Options

| Flag | Description | | ----------------- | -------------------------------- | | -o, --overwrite | Overwrite existing files | | -a, --all | Install all available components |

remove

Remove installed components.

nativeui-cli remove button

Alias:

nativeui-cli rm button

list

List available and installed components.

nativeui-cli list

Alias:

nativeui-cli ls

diff

Compare your local components against the latest registry versions.

nativeui-cli diff

nativeui-cli diff button

Useful when new component updates are released and you've customized local copies.

Example

# Initialize project
npx nativeui-cli@latest init

# Add components
npx nativeui-cli@latest add button card input

# Check installed components
npx nativeui-cli@latest list

# See available updates
npx nativeui-cli@latest diff

Philosophy

Native UI follows the same philosophy that made shadcn/ui popular:

You own the code.

Components are copied into your project as TypeScript source files. Edit them, refactor them, or delete them entirely. The CLI helps you get started, but your code remains yours.

Documentation

Visit the documentation site for installation guides, component documentation, and examples.

https://nativeui.qzz.io

License

MIT