Changelog
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-alpha.35
October 19, 2025
- (Breaking change): Migrated all compound components from dot notation to named exports for React Server Components compatibility
- All 16 compound components affected: Accordion, Alert, Avatar, Card, Disclosure, DisclosureGroup, Fieldset, Kbd, Link, Popover, RadioGroup, Slider, Switch, SwitchGroup, Tabs, and Tooltip
- Improved tree-shaking and TypeScript support
- Updated all documentation to reflect new import patterns
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-typeto--skeleton-animationin Skeleton - Aligned data-slot markers across components
- Improved documentation
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
sizevariants and added demo in Switch - Added related showcases in Button, Tabs, Disclosure, Disclosure Group
- Improved documentation
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.
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.