Changelog

Latest Release

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 .Root suffix (e.g., <Avatar> → <Avatar.Root>)
• Named exports remain unchanged and fully supported

React 19 Improvements

• Removed forwardRef (now native in React 19)
• Simplified Context usage (Context.Provider → React 19)

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

Read full release notes →

---

Previous Releases

v3.0.0-alpha.34

October 15, 2025

• Added Form-based components: Description, FieldError, Fieldset, Form, Input, Label, RadioGroup, TextField, and TextArea.
• Introduced form field tokens --field-*
• Reorganized Storybook by category
• (Breaking change): Renamed --skeleton-default-animation-type to --skeleton-animation in Skeleton
• Aligned data-slot markers across components
• Improved documentation

Read full release notes →

v3.0.0-alpha.33

October 5, 2025

• Upgraded RAC with October 2, 2025 Release
• Reordered Tabs Indicator (Breaking change)
• Updated Tabs component to use React Aria's SelectionIndicator, now supports SSR
• Updated Disclosure and Disclosure Group components to use RAC CSS variables for the expand and collapse animations
• Updated Switch component styles and animations
• Added size variants and added demo in Switch
• Added related showcases in Button, Tabs, Disclosure, Disclosure Group
• Improved documentation

Read full release notes →

v3.0.0-alpha.32

October 1, 2025

Card component redesigned with new variants, added CloseButton component, MCP Server for AI coding assistants, and improved documentation.

Read full release notes →

v3.0.0-alpha.31

September 22, 2025

• 🎨 Showcases page - Gallery of sites built with HeroUI
• 🌀 DisclosureGroup component - Groups multiple disclosures together
• 📇 Card component (preview) - First version of card component
• 🔀 Switch component (preview) - Toggle switch for settings

---

Release Schedule

HeroUI v3 follows a regular release cycle:

• Alpha releases: Weekly to bi-weekly during active development - In progress
• Beta releases: Monthly stabilization releases (once first beta release is made)
• Stable releases: Quarterly major versions (once first stable release is made)

Contributing

Found an issue or want to contribute? Check out our GitHub repository.