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