NativeCN

A React Native UI component library inspired by shadcn/ui. Get beautiful, accessible UI components for your React Native apps by copying and pasting code.

Installation & Usage

Note: You need to have nativewind installed and setup in your project to use this library.

# Install via npm
npm install @nativecn/cli
# Or use directly with npx
npx @nativecn/cli [command]

Initialize NativeCN in your project

npx @nativecn/cli init

The init command will:

1. Detect if your project uses NativeWind or StyleSheet
2. Create a nativecn-preset.js file with theme configuration
3. Add components directory structure
4. Install essential dependencies
5. Create utility functions

Add components to your project

npx @nativecn/cli add button

Options:

• --dir <directory> - Target directory for components (default: './components/ui')
• --overwrite - Overwrite existing components

Generate theme preset file (optional)

This is asked to be done automatically when you run npx @nativecn/cli init. Use this if you want a more fine-grained control over the preset file.

npx nativecn preset

Creates a nativecn-preset.js file with default theme colors.

Component Progress

Category	Progress	Completed	Total
Essential UI Primitives	⬛⬜⬜⬜⬜⬜⬜⬜⬜⬜	1	10
Common Components	⬛⬛⬛⬛⬛⬛⬜⬜⬜⬜⬜⬜	6	12
Navigation & Structure	⬛⬛⬜⬜⬜⬜⬜⬜	2	8
Advanced Interaction	⬛⬜⬜⬜⬜⬜⬜⬜⬜⬜	1	10
Data & Specialized Components	⬛⬛⬜⬜⬜⬜	2	6
Overall	⬛⬛⬜⬜⬜⬜⬜⬜⬜⬜	12	46

Check out the Roadmap for more details.

Features

• Non-intrusive installation process - Components as source code, not packages
• Easy theming - NativeWind preset for consistent styling
• Flexible styling - Works with NativeWind or React Native StyleSheet
• Full control - Customize components to your specific needs
• Type safety - Built with TypeScript for better development experience

Roadmap

NativeCN is under active development. Here's what we're planning:

• More Components: Expand our library with additional UI components that are present in shadcn/ui
• Documentation Site: Create a dedicated documentation website with live examples
• Example Apps: Create example apps using expo and react-native-cli to showcase the components in action

For a more detailed view of our plans and progress, check out our Roadmap.

Development

To develop locally:

# Build the packages
npm run build

# Link for local development (simplified approach)
npm link

# Now you can run the CLI
npx @nativecn/cli init
npx @nativecn/cli add button

Alternatively, you can link individual packages

# Link individual packages
npm link @nativecn/cli @nativecn/components

# Run commands
npx @nativecn/cli init
npx @nativecn/cli add button

Contributing

We welcome contributions from everyone! Whether you're fixing a bug, adding a feature, or improving documentation, your help is appreciated.

Please read our Contributing Guidelines for details on our code of conduct, the development process, and how to get your pull request accepted.

Quick Start for Contributors

1. Fork the repository
2. Clone your fork locally
3. Set up the development environment:

   npm install
   npm run build

4. Create a branch for your feature or bugfix
5. Make your changes
6. Test your changes
7. Submit a pull request

For more detailed instructions, please see the Contributing Guidelines.

Code of Conduct

We expect all participants to adhere to our Code of Conduct. Please read it before participating.

License

MIT

---

If you find this project helpful, consider buying me a coffee ☕