@aniui/cli
v0.2.29
Published
Beautiful React Native components. Copy. Paste. Ship.
Maintainers
Readme
AniUI is a shadcn/ui-inspired component library for React Native. Instead of installing a package, you copy component source files directly into your project. You own the code. Customize everything.
Built with NativeWind (or Uniwind), rn-primitives for accessibility, class-variance-authority, and strict TypeScript.
Demo: Live Preview (Expo Go) | Docs
Quick Start
# npm
npx @aniui/cli init
# pnpm
pnpm dlx @aniui/cli init
# yarn
yarn dlx @aniui/cli init
# bun
bunx @aniui/cli init
# With Uniwind instead of NativeWind
npx @aniui/cli init --style uniwindThe CLI auto-detects your project (Expo/Bare RN), installs missing dependencies, and configures everything.
# Add components
npx @aniui/cli add button card input textCLI Commands
aniui init
Sets up AniUI in your project:
- Asks: NativeWind or Uniwind? Theme preset? TypeScript?
- Auto-installs missing dependencies (nativewind, tailwindcss, reanimated, etc.)
- Uses
npx expo installfor Expo projects (auto-pins versions) - Creates all config files (metro, babel, tailwind, global.css, tsconfig)
aniui add <components...>
Copies component source files into your project:
npx @aniui/cli add button text input card badge dialog select tabs- Resolves dependencies automatically
- Lists any npm packages you need to install
- Supports TypeScript and JavaScript (
tsx: false)
aniui doctor
Diagnoses your project setup:
npx @aniui/cli doctorChecks all deps, config files, known conflicts, and tells you exactly what to fix.
aniui theme
Switch theme presets: default, blue, green, orange, rose.
Components
89 components in cli/src/registry.ts (tiers 1–3; source of truth for installs):
Tier 1 — Light deps (cva / RN core): Most inputs, display, layout, and form helpers — Button, Card, Text, Calendar, ChartTooltip, ImageGallery, ThemeProvider, and more.
Tier 2 — Includes react-native-reanimated: Skeleton, Toast, Alert Dialog, Drawer, Collapsible, Connection Banner, Typing Indicator.
Tier 3 — Extra packages: @rn-primitives/*, @gorhom/bottom-sheet, react-native-svg (charts), react-native-gesture-handler (swipeable) — e.g. Checkbox, Accordion, Bottom Sheet, Area Chart, Line Chart, Pie Chart.
Compatibility
| | Status |
|---|---|
| Expo | ✅ SDK 53, 54 & 55 |
| Bare React Native | ✅ 0.76+ |
| NativeWind | ✅ v4 + v5 |
| Uniwind | ✅ --style uniwind |
| npm / pnpm / yarn / bun | ✅ All supported |
| TypeScript | ✅ Strict |
| JavaScript | ✅ Via CLI (tsx: false) |
| New Architecture | ✅ |
| Old Architecture | ✅ SDK 53/54 only |
| iOS | ✅ 15+ |
| Android | ✅ API 24+ |
Try on device: Scan with Expo Go
Documentation
Full docs with interactive previews: aniui.dev
Links
License
MIT
