# What changed in @heroui/react

> 37 changes in @heroui/react 2 to 3 from its official release notes, upgrade guides and advisories: 1 breaking, 3 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@heroui/react/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @heroui/react 3

### Breaking changes

- HeroUI v3 styling uses Tailwind CSS v4. (3.0.0) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%403.0.0)

### New APIs and options

- The architecture uses compound components and is fully customizable and headless-ready. (3.0.0) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%403.0.0)
- A new HeroUI library for React Native is introduced, built from scratch with 37+ components. (3.0.0) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%403.0.0)

### Behavior and default changes

- Animations move to CSS, with no JS runtime. (3.0.0) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%403.0.0)

### Tooling

- Agent Skills are included as part of the developer tooling for AI assistants. (3.0.0) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%403.0.0)
- LLMs.txt is included as part of the developer tooling for AI assistants. (3.0.0) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%403.0.0)
- An MCP Server is included as part of the developer tooling for AI assistants. (3.0.0) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%403.0.0)

## @heroui/react 2

### New APIs and options

- Added support for outside-top label placement. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)

### Fixes and other changes

- Reopening the dropdown scrolls to the selected item. (2.8.10) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.10)
- Transform position now persists across renders when using useDraggable. (2.8.10) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.10)
- Corrected disableRipple prop precedence for Button. (2.8.9) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.9)
- Fixed extendVariants rendering behavior when using as. (2.8.9) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.9)
- Fixes click behavior for dynamically generated accordion items. (2.8.8) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.8)
- Opens the date picker when clicking its border. (2.8.8) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.8)
- Fixes the types for compound variants in extendVariants. (2.8.8) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.8)
- Prevents option focus from start and end content slots. (2.8.8) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.8)
- Improves the layout for large page counts. (2.8.8) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.8)
- Resolves a race condition with cached images on Firefox and Safari. (2.8.8) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.8)
- Fixes the password reveal button visibility. (2.8.7) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.7)
- Fixes the link overriding the role. (2.8.7) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.7)
- Fixes the default transition duration. (2.8.7) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.7)
- Fixed the mobile close button display and showing the popover when emptyContent is provided with allowsCustomValue. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed a flickering issue in the code block. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Added slot support and fixed respecting defaultVariants.className in system RSC. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Bordered focus styles now take precedence over hover. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed Safari autofill styling for dark mode readability. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed an issue where useHref was not working correctly. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed label positioning for empty percent format and included labelPlacement in the dependency array. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed handling of props styles in getBaseProps. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed ripple misalignment in RTL layouts by using transform. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed incorrect label positioning. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- The shimmer animation no longer plays when disableAnimation is true. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed spinner animation and support for the global spinner variant. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed column props not being recognized and virtualized tables in Firefox by replacing Spacer with CSS. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed the tab cursor and its responsive resizing so it matches the selected tab. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed vertical tabs support for accessible navigation and aria-orientation. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)
- Fixed long text exceeding the wrapper. (2.8.6) — [release notes](https://github.com/heroui-inc/heroui/releases/tag/%40heroui/react%402.8.6)