A CLI tool for initializing and managing NativeCN components in React Native projects.
npm install @nativecn/cli
# or
npx @nativecn/cli [command]
npx @nativecn/cli init
The init command will:
- Detect if your project uses NativeWind or StyleSheet
- Create a nativecn-preset.js file with theme configuration
- Add components directory structure
- Install essential dependencies
- Create utility functions
npx @nativecn/cli add button input card
Options:
-
--dir <directory>
- Target directory for components (default: './components/ui') -
--overwrite
- Overwrite existing components
npx nativecn preset
Creates a nativecn-preset.js file with default theme colors.
-
button
- A customizable button component with different variants, sizes and states -
accordion
- A vertically stacked set of interactive headings that reveal or hide associated content -
alert
- A component that displays a brief, important message to get users' attention -
alertdialog
- A modal dialog that interrupts the user with important content and expects a response -
avatar
- An image component used to represent a user, with a fallback for showing initials -
badge
- A small visual indicator for highlighting status, labels or counts -
breadcrumb
- A navigation component that shows the current location in a hierarchical structure -
aspectratio
- A component to maintain consistent width/height ratios across different screen sizes -
card
- A container component that groups related content and actions -
carousel
- A slideshow component for cycling through elements like images or slides of content -
input-otp
- A one-time password input component with individual character boxes and auto-focus -
skeleton
- A placeholder loading component that animates to indicate content is being loaded - And more to come!
MIT