Changelog

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-beta.2

November 19, 2025

This release introduces five essential new components (AlertDialog, ComboBox, Dropdown, Modal, NumberField), enhances theme compatibility and motion preferences, improves the Select component API with a ⚠️ breaking change, plus various refinements and bug fixes.

Read full release notes →

v3.0.0-beta.1

November 6, 2025

This release introduces a comprehensive redesign of HeroUI v3, merging v2's beauty and animations with v3's simplicity. All components have been redesigned, 8 new components added (Alert, Checkbox, InputOTP, ListBox, Select, Slider, Surface), and the design system has been completely overhauled with better color tokens, shadows, and architecture. Includes breaking changes to design system variables, component APIs, and flexible component patterns.

Read full release notes →

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 →

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