CLI

init

Initialize AniUI in your React Native project. Sets up the utility helper, global CSS theme, and Tailwind config.

npx @aniui/cli init

The init command will:

• Detect your project type (Expo or bare React Native)
• Check that NativeWind is installed
• Prompt for component directory path (default: components/ui)
• Prompt for utility path (default: lib/utils.ts)
• Prompt for a theme preset
• Copy lib/utils.ts, global.css, tailwind.config.js, and nativewind-env.d.ts

add

Add components to your project. Components are copied as source files — you own the code.

npx @aniui/cli add [component...]

Examples:

# Add a single component
npx @aniui/cli add button

# Add multiple components
npx @aniui/cli add button text input card

# Add a component with dependencies (auto-resolved)
npx @aniui/cli add select
# → also adds bottom-sheet (registry dependency)

If a component needs extra npm packages (e.g. react-native-reanimated for Tier 2 components), the CLI will print the install command for you.

theme

Switch between theme presets. Updates the CSS variables in your global.css.

npx @aniui/cli theme

Available presets: Default (neutral), Blue, Green, Orange, Rose.

generate

Generate a complete screen using AI. Requires the ANTHROPIC_API_KEY environment variable.

# Generate a screen from a description
npx @aniui/cli generate "login page with email and password"

# Specify output path
npx @aniui/cli generate "settings page" -o app/settings.tsx

The AI knows the full AniUI component catalog and generates screens using only existing components with proper imports and NativeWind styling.

mcp

Print the MCP server configuration for AI tools like Claude Desktop or Cursor.

npx @aniui/cli mcp

This outputs a JSON config block you can paste into your AI tool's MCP settings. The MCP server exposes component registry data, source code, usage patterns, and theme tokens.