# heroui-migration

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

HeroUI v2 to v3 migration guide for agents. Use when migrating HeroUI v2 apps to v3, upgrading components, or accessing migration documentation. Keywords: HeroUI migration, v2 to v3, migration guide, upgrade HeroUI.

Tags: component-library, components, library, reactjs

## Install

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

## From README

HeroUI v2 to v3 Migration Guide This skill helps agents migrate HeroUI v2 applications to v3. HeroUI v3 introduces breaking changes: compound components, no Provider, Tailwind v4, and removed hooks. --- --- CRITICAL: Always Fetch Migration Docs Before Applying Do NOT assume v2 patterns work in v3. Always fetch migration guides before implementing changes. Key v2 → v3 Changes | Feature | v2 (Migrate From) | v3 (Migrate To) | | ------------- | -------------------------- | -------------------------------------- | | Provider | required | No Provider needed | | Component API | Flat props: | Compound: | | Event handlers | onClick | onPress | | Styling | classNames prop | className prop | | Hooks | useSwitch, useDisclosure, etc.

## Links

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

## More from this repo

- [heroui-react](https://omgskills.com/skills/heroui-inc/heroui/heroui-react/index.md) — HeroUI v3 React component library (Tailwind CSS v4 + React Aria).
   - [@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