All Releases
All updates and changes to HeroUI v3, including new features, fixes, and breaking changes.
Using AI assistants? Simply prompt "Hey Cursor, update HeroUI to the latest version" and your AI assistant will automatically compare versions and apply the necessary changes. Learn more about the HeroUI MCP Server.
Latest Release
v3.0.0
March 2026
A ground-up rewrite for React and React Native. 75+ web components, 37 native components, Tailwind CSS v4, React Aria, compound component architecture, CSS-first theming with OKLCH tokens, data-reduce-motion animation control, and built for AI-assisted development with MCP servers, agent skills, and LLMs.txt.
Previous Releases
v3.0.0-alpha.35
October 21, 2025
React Server Components Support
- Fixed critical issue where compound components didn't work in React Server Components (RSC)
- Moved compound pattern logic from components to index files, resolving
"use client"conflicts - (⚠️ Breaking change): Main component now requires
.Rootsuffix (e.g.,<Avatar>→<Avatar.Root>) - Named exports remain unchanged and fully supported
React 19 Improvements
Switch Component Refactoring
- (⚠️ Breaking change): Split Switch and SwitchGroup into separate components
- Cleaner API:
<SwitchGroup>replaces<Switch.Group>and<Switch.GroupItems> - Matches Radio/RadioGroup pattern for consistency
- Separate styles, types, and implementations
Affected Components
All compound components now require .Root suffix: Accordion, Avatar, Card, Disclosure, Fieldset, Kbd, Link, Popover, Radio, Switch, Tabs, Tooltip
Release Schedule
HeroUI v3 is now stable. Future releases follow a regular cycle:
- Patch releases: Bug fixes and minor improvements as needed
- Minor releases: New components and features, typically monthly
- Major releases: Architectural changes with migration guides
Contributing
Found an issue or want to contribute? Check out our GitHub repository.