# heroui-react

> Claude/Codex skill by [@heroui-inc](https://omgskills.com/library/heroui-inc/index.md) · 31k stars · Updated 2026-10-26

HeroUI v3 React component library (Tailwind CSS v4 + React Aria). Use when building UIs with HeroUI — creating Buttons, Modals, Forms, Cards; installing @heroui/react; configuring dark/light themes with oklch variables; or fetching component docs. Keywords: HeroUI, Hero UI, heroui, @heroui/react, @heroui/styles.

Tags: component-library, components, library, reactjs

## Install

```sh
git clone https://github.com/heroui-inc/heroui /tmp/heroui && ln -s /tmp/heroui/skills/heroui-react ~/.claude/skills/heroui-react
```

## From README

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. --- --- 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: | Feature | v2 (DO NOT USE) | v3 (USE THIS) | | ------------- | --------------------------------- | ------------------------------------------- | | Provider | required | No Provider needed | | Animations | framer-motion package | CSS-based, no extra deps | | Component API | Flat props: | Compound: | | Styling | Tailwind v3 + @heroui/theme | Tailwind v4 + @heroui/styles | | Packages | @heroui/system, @heroui/theme | @heroui/react, @heroui/styles | CORRECT (v3 patterns) Always fetch v3 docs before implementing.

## Links

- HTML page: https://omgskills.com/skills/heroui-inc/heroui/heroui-react/
- GitHub: https://github.com/heroui-inc/heroui
- Author: [@heroui-inc](https://omgskills.com/library/heroui-inc/index.md)

## More from this repo

- [heroui-migration](https://omgskills.com/skills/heroui-inc/heroui/heroui-migration/index.md) — HeroUI v2 to v3 migration guide for agents.
   - [@heroui-inc](https://omgskills.com/library/heroui-inc/index.md) · 31k stars
- [heroui-native](https://omgskills.com/skills/heroui-inc/heroui/heroui-native/index.md) — HeroUI Native component library for React Native (Tailwind v4 via Uniwind).
   - [@heroui-inc](https://omgskills.com/library/heroui-inc/index.md) · 31k stars