HextaUI CLI

A command-line tool for adding customizable UI components to Next.js, Vite, and Astro projects.

🚀 Quick Start

# Initialize HextaUI
npx hextaui@latest init

# Add components
npx hextaui add Button Card Input

# Interactive mode
npx hextaui add

📦 Installation

Run without installation using npx:

npx hextaui@latest init

🛠️ Usage

Initialize Project

npx hextaui init

Automatically detects your framework and creates:

• src/components/ui/ for components
• src/lib/utils.ts for utilities
• Configures project for HextaUI
• Framework-specific setup instructions

Add Components

# Add specific components
npx hextaui add Button Card

# Interactive selection
npx hextaui add

Options:

• --deps: Auto-install dependencies
• --no-deps: Skip dependency installation
• --fast: Manual dependency copying

List Components

npx hextaui list

🎨 Components

• Button
• Card
• Input
• Label
• Avatar
• Separator
• Tooltip
• Breadcrumb
• Kbd
• Accordion
• Alert
• Badge
• Calendar
• Checkbox
• Chip
• ColorPicker
• CommandMenu
• DatePicker
• Drawer
• DropdownMenu
• FileUpload
• InputOTP
• Loader
• MenuBar
• Modal
• Pagination
• Progress
• Radio
• ScrollArea

⚙️ Requirements

• Next.js: 13+ with React 18+
• Vite: Latest version with React 18+
• Astro: Latest version with React integration
• All frameworks: Tailwind CSS v4 and Node.js 16+

🎯 Supported Frameworks

Next.js

• Full support for App Router and Pages Router
• Automatic CSS injection into global styles
• TypeScript path aliases configuration

Vite + React

• Automatic alias configuration guide
• Support for all Vite React templates
• TypeScript integration

Astro

• React integration setup instructions
• Tailwind CSS configuration
• TypeScript support with path aliases

📁 Project Structure

src/
├── components/
│   └── ui/
│       ├── button/
│       ├── card/
│       └── ...
└── lib/
    ├── utils.ts
    └── color-utils.ts

🔧 Commands

npx hextaui init              # Initialize project
npx hextaui add Button Card   # Add components
npx hextaui add --deps        # Auto-install dependencies
npx hextaui add --fast        # Fast mode
npx hextaui list              # List components

🌐 Links

• Homepage
• Documentation
• GitHub
• Issues

📄 License

MIT License

Built with ❤️ by Preet Suthar