heroui-react

Installation
Summary

Accessible React component library built on Tailwind CSS v4 and React Aria with compound component patterns.

  • Provides 20+ pre-built components (Button, Modal, Form, Card, TextField, etc.) using compound composition syntax (Card.Header, Card.Content)
  • Requires Tailwind CSS v4 and uses CSS variables with oklch color space for theme customization; no provider wrapper needed in v3
  • Semantic variant system (primary, secondary, tertiary, danger, ghost, outline) for consistent intent-driven styling across components
  • Currently in beta; fetch component MDX docs from v3.heroui.com/docs/react/components/{name}.mdx for complete props, examples, and anatomy before implementing
SKILL.md

HeroUI v3 React Development Guide

HeroUI v3 is a component library built on Tailwind CSS v4 and React Aria Components, providing accessible, customizable UI components for React applications.


Installation

curl -fsSL https://heroui.com/install | bash -s heroui-react

CRITICAL: v3 Only - Ignore v2 Knowledge

This guide is for HeroUI v3 ONLY. Do NOT apply v2 patterns — the provider, styling, and component API all changed:

Related skills
Installs
5.3K
GitHub Stars
29.3K
First Seen
Jan 27, 2026