Roadmap
Changelog

March 14th, 2026

New

HeroUI v3.0.0-rc.1

We're excited to share that RC-1 is now live. This is the last release before stable.

This release introduces 7 new components → Drawer, ToggleButton, ToggleButtonGroup, Meter, ProgressBar, ProgressCircle, and Toolbar. It also brings virtualization to Table and ListBox, a new ButtonGroup Separator sub-component with vertical orientation support, granular per-component subpath imports, and upgrades React Aria Components to v1.16.0.

Release notes: https://v3.heroui.com/docs/react/releases/v3-0-0-rc-1

New components

  • Drawer — slide-out panel with drag-to-dismiss, 4 placements (top/bottom/left/right), backdrop variants, and full compound composition

  • ToggleButton — stateful toggle with all button variants, icon-only mode, controlled or uncontrolled

  • ToggleButtonGroup — single or multi-select toggle group, attached/detached layouts, vertical orientation, and Separator sub-component

  • Meter — value within a known range (disk usage, password strength, quotas) with Track and Fill composition

  • ProgressBar — linear progress with determinate + indeterminate states, color variants, and custom value display

  • ProgressCircle — circular SVG progress with customizable TrackCircle and FillCircle sub-components

  • Toolbar — groups buttons, toggle buttons, and separators with horizontal or vertical orientation

Improvements and fixes

  • Table & ListBox virtualization — render 1000+ rows via React Aria's Virtualizer, TableLayout, and ListLayout (re-exported from @heroui/react)

  • ButtonGroup Separator sub-component + vertical orientation + inset focus rings

  • Granular per-component subpath imports (import { Button } from "@heroui/react/button")

  • ButtonGroup root upgraded from <div> to React Aria's Group for proper role="group" semantics

  • React Aria Components upgraded from v1.15.1 to v1.16.0

  • @internationalized/date upgraded from v3.11.0 to v3.12.0

  • InputGroup focus styles scoped to actual input/textarea focus

  • Avatar fallback now inherits border-radius from parent

  • Modal & AlertDialog backdrop clicks no longer propagate through portals

  • Table header rounding and background color fixed in Firefox

Upgrade with AI (recommended)

If you use AI tools like Cursor or Claude Code, upgrading is straightforward.

Install either MCP or Skills:

Then, just prompt: "Update HeroUI to the latest version" Your assistant can compare versions, update imports, and refactor code automatically.

Full changelog: https://v3.heroui.com/docs/react/releases/v3-0-0-rc-1

Stable is next. We're ready. 🚀

Talk soon, The HeroUI Team

Write a comment...