February 6th, 2026
New
We’re excited to share that HeroUI v3.0.0 beta.6 is now live.
This release introduces 6 new components → ColorPicker, ColorArea, ColorSlider, ColorField, ColorSwatch and ColorSwatchPicker. expands Toast behavior, and continues polishing APIs as we wrap up the final pieces before stable.
Release notes: https://v3.heroui.com/docs/react/releases/v3-0-0-beta-6
Improvements and fixes
• Toast improvements with better loading states and stacking behavior
• New Separator variants and visual refinements
• Smarter defaults across multiple components
• Various bug fixes and consistency improvements
⚠️ Breaking changes
As we finalize APIs, this release includes breaking changes focused on stability and long term clarity.
We recommend reviewing the release notes before upgrading.
Upgrade with AI (recommended)
If you use AI tools like Cursor or Claude Code, upgrading is straightforward.
Install either MCP or Skills:
• HeroUI MCP Server
https://v3.heroui.com/docs/ui-for-agents/mcp-server
• HeroUI Agent Skills
https://v3.heroui.com/docs/react/getting-started/agent-skills
Then, just prompt:
“Update HeroUI to the latest version”
Your assistant can compare versions, update imports, and refactor code automatically.
Full changelog
Read the complete beta.6 release notes here:
https://v3.heroui.com/docs/react/releases/v3-0-0-beta-6
We’re almost done with v3, just a few components left before the stable release. 🚀
Thanks for testing and sharing feedback.
Talk soon,
The HeroUI Team
January 20th, 2026
New
We’re excited to share that HeroUI v3.0.0 beta.4/5 is now live.
This release is a major milestone for v3, focused on theming, API clarity, and long term stability as we move closer to the stable release.
It introduces a brand new visual Theme Builder, 3 new components, multiple improvements, and important breaking changes that simplify the system and reduce hidden behavior.
New Theme Builder
Beta.4 introduces the new Theme Builder, a visual tool for creating and customizing HeroUI themes.
You can now design your theme visually and export production ready CSS variables.
Key features:
• Visual color editing using OKLCH
• Real time component previews
• Custom accent colors with global propagation
• Preset themes like Default, Airbnb, Coinbase, Discord, and more
• Light and dark mode customization
• Exportable CSS variables
• Keyboard shortcuts with undo and redo
🎨 Try it now → https://v3.heroui.com/themes
New components
This release introduces 3 new components:
Autocomplete →
https://v3.heroui.com/docs/components/autocomplete
Breadcrumbs →
https://v3.heroui.com/docs/components/breadcrumbs
Toast (preview) - Built on top of View Transitions API →
https://v3.heroui.com/docs/components/toast
Toast is currently in preview and some features may still evolve before the stable release.
Component and API improvements
This update focuses heavily on predictability, visual hierarchy, and composability:
• New secondary variant for Tabs with underline indicator style
• New primary and secondary variants for Input
• InputGroup now supports primary and secondary variants
• InputGroup.TextArea support for multiline inputs with prefix and suffix slots
• New outline variant for Button and ButtonGroup
• Size support added to AlertDialog
• Improved Checkbox animation speed and stroke width
• Focus visible behavior refined to avoid hover conflicts
• Multiple style refinements across components
⚠️ Breaking changes
As part of simplifying the API and removing hidden styling logic:
Link component
• Removed built in underline and underlineOffset props
• Text decoration is now handled via Tailwind CSS utilities
This provides greater flexibility and aligns better with Tailwind conventions.
Form components
• Removed the isInSurface prop and automatic surface detection. Instead, use:
variant="secondary"when placing form components inside Surface, Card, or other surface based containers.
Affected components include:
Input, InputGroup, TextField, TextArea, SearchField, NumberField, DateField, TimeField, Select, ComboBox, and Autocomplete.
Important notice about beta.5
Shortly after releasing beta.4, we identified a critical issue affecting some setups.
To avoid breaking existing projects, we recommend upgrading to v3.0.0 beta.5, which includes a fix for this issue.
If you are currently on beta.4, please upgrade.
Upgrade with your AI assistant
If you use AI tools like Cursor or Claude Code, upgrading is simple.
Just prompt:
“Update HeroUI to the latest version”
Your assistant will compare versions, apply required changes, update imports, and refactor your code where needed.
Learn more about the HeroUI MCP server here →
https://v3.heroui.com/docs/ui-for-agents/mcp-server
Full changelog
Read the complete list of updates here →
https://v3.heroui.com/docs/react/releases/v3-0-0-beta-4
Thank you for continuing to test HeroUI v3 and share feedback.
Talk soon,
The HeroUI Team
December 19th, 2025
New
Hi everyone,
We’re excited to share that HeroUI Beta 3 is now live.
This release continues to refine the v3 foundation with new components, better layout control, cleaner visuals, and important breaking changes as we move closer to a stable release.
New components
This update introduces 7 new components that expand HeroUI’s form, input, and composition capabilities:
ButtonGroup → https://v3.heroui.com/docs/components/button-group
DateField → https://v3.heroui.com/docs/components/date-field
TimeField → https://v3.heroui.com/docs/components/time-field
ScrollShadow → https://v3.heroui.com/docs/components/scroll-shadow
SearchField → https://v3.heroui.com/docs/components/search-field
TagGroup → https://v3.heroui.com/docs/components/tag-group
ErrorMessage → https://v3.heroui.com/docs/components/error-message
Component and API improvements
This release focuses heavily on layout clarity and visual polish:
• New fullWidth prop on multiple components for better form and layout composition
• New hideSeparator prop for Tabs, Accordion, and group components
• Smoother animations and refined motion behavior
• Style fixes across multiple components
• Docs icons upgrade for better visual consistency
⚠️ Breaking changes
As part of simplifying the API and improving long term maintainability:
• The asChild prop has been removed
• AlertDialog and Modal backdrop variants have been updated
Please review the changelog before upgrading if you rely on these APIs. →
https://v3.heroui.com/docs/changelog/v3-0-0-beta-3
Upgrade with your AI assistant
If you use AI tools like Cursor or Claude Code, upgrading is straightforward.
Just prompt:
“Update HeroUI to the latest version”
Your assistant will compare versions, apply required changes, update imports, and refactor your code where needed.
Learn more about the HeroUI MCP server here →
https://v3.heroui.com/docs/ui-for-agents/mcp-server
Full changelog
Read the complete list of updates here →
https://v3.heroui.com/docs/changelog/v3-0-0-beta-3
Thank you for being part of the HeroUI community.
Each beta brings us closer to HeroUI v3 stable, and we’re excited to keep sharing progress with you.
Talk soon,
The HeroUI Team
November 20th, 2025
New
Hi everyone,
We’re excited to share that HeroUI v3 Beta 2 for Web is now live.
This update brings important improvements across the system along with six essential new components.
New components
This release introduces 6 new components that expand what you can build with HeroUI v3:
AlertDialog →
ComboBox →
Dropdown →
InputGroup →
NumberField →
Component and API improvements
Updated Select API for better consistency
Cleaner animations, sharper focus styles, and smoother interactions
Improved dark mode behavior
Refinements to Chip, Separator, and more
Bug fixes and quality improvements
You will notice more stable visuals, improved motion handling, and better accessibility throughout the library.
Upgrade with your AI assistant
If you use AI tools like Cursor or Claude Code, upgrading is simple.
“Update HeroUI to the latest version”
Your tool will compare versions, apply required changes, update imports, and refactor your code.
Learn more about the HeroUI MCP server here →
https://v3.heroui.com/docs/ui-for-agents/mcp-server
Full changelog
Read the complete list of updates →
https://v3.heroui.com/docs/changelog/v3-0-0-beta-2
Thank you for being part of the HeroUI community.
This release brings us one step closer to the stable v3 version, and we can’t wait to share what’s coming next.
Talk soon,
The HeroUI Team
October 1st, 2025
New
This release introduces AI development tools, a redesigned Card component API, and a new CloseButton component — all focused on improving developer experience.
🚀 What’s New
🤖 Official MCP Server (preview)
Connect HeroUI v3 directly with AI assistants like Cursor, Claude Code, and VS Code Copilot.
→ Learn More📇 Redesigned Card Component API
More flexible with new variants, improved accessibility, and support for avatars, background images, and horizontal layouts.
→ Card Documentation👆 New CloseButton Component
A dedicated component for dismissing modals, dialogs, and other UI elements.
→ CloseButton Docs🔀 Improved Switch Component Styles
Better visuals and updated examples in docs.
📚 Resources
📘 Full Docs → v3.heroui.com
⚙️ Alpha 32 PR → GitHub #5747
🗺️ Roadmap
Thanks for following along and supporting HeroUI.
Your feedback is key — let’s keep building together! 🚀