# All Releases · HeroUI > All updates and changes to HeroUI v3, including new features, fixes, and breaking changes. - Page: https://jiguang132.com/systems/heroui/docs/releases - Based on: HeroUI documentation (Apache-2.0) @ 60edd8ed751b1d2a270623fbb182bbcfa8baa9af > **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](/docs/ui-for-agents/mcp-server). ## Latest Release ### v3.2.2 **June 19, 2026** Patch release: upgrades to React Aria `1.19.0` (`react-aria@3.50.0`), adds overflow scrolling to `Tabs.ListContainer`, fixes clear/close buttons accidentally submitting their surrounding form, and prevents visually hidden inputs in `Checkbox`, `Radio`, and `Switch` from causing overflow scroll. [Read full release notes →](/systems/heroui/docs/releases/v3-2-2) --- ### v3.2.1 **June 17, 2026** Patch release: `@heroui/react` no longer bundles its own copy of `react-aria`. The `react-aria` subpaths are externalized in the Rollup build, so consumers resolve to the single `react-aria` installed in their project instead of a vendored copy. Also fixes `SwitchGroup` horizontal layout. [Read full release notes →](/systems/heroui/docs/releases/v3-2-1) --- ### v3.2.0 **June 6, 2026** Calendar week and day views, a reworked year picker, and range demos on React Aria 1.18, plus tooltip delay theme variables and the patch fixes shipped with it. Breaking: `Radio`, `Checkbox`, and `Switch` move to an explicit `*.Content` composition (control nests inside `*.Content`; the label is plain text, no nested ``; help text becomes a sibling). [Read full release notes →](/systems/heroui/docs/releases/v3-2-0) --- ### v3.1.0 **May 25, 2026** Minor release: Chinese React docs and localized demos, accessible soft foreground tokens with a vibrant palette opt-in, a shared scrollbar system, fixes for `useTheme`, Toast, Fieldset, Link, overlays, and improved RTL support across Table, pickers, and MenuItem. [Read full release notes →](/systems/heroui/docs/releases/v3-1-0) --- ### v3.0.5 **May 15, 2026** Patch release: `Text` is renamed to `Typography` to resolve a `tailwind-merge` collision (⚠️ **breaking change**), derived color tokens are refactored into unprefixed source variables, Checkbox and Radio get aligned field-border styling, Calendar hover uses `accent-soft-foreground` for readability, and a new CLI docs page is added. [Read full release notes →](/systems/heroui/docs/releases/v3-0-5) --- ### v3.0.4 **May 2026** Patch release: new `Text` compound component ported from HeroUI Pro, docs theme selector, `min()`-capped border-radius tokens across 45+ component CSS files, reworked Table focus rings, and fixes for Checkbox, Autocomplete, Tooltip, and form field padding. [Read full release notes →](/systems/heroui/docs/releases/v3-0-4) --- ### v3.0.3 **April 17, 2026** Patch release: React Aria Components 1.17 (dependencies consolidation, faster installs, Table expandable rows), the `useTheme` hook for Vite and CRA, a DOM polymorphic render prop for lightweight components, and fixes for NumberField resets and nested Tabs styling. [Read full release notes →](/systems/heroui/docs/releases/v3-0-3) ### v3.0.2 **April 3, 2026** Bug fixes, smoother Drawer transitions, new `--backdrop` theme variable, and style refinements for triggers, arrows, and tags. Autocomplete popover width tracking fixed, overlay triggers now `inline-block`, and Tag gets improved spacing + accessibility. [Read full release notes →](/systems/heroui/docs/releases/v3-0-2) ### v3.0.0 **March 2026** A ground-up rewrite for React and React Native. 75+ web components, 37 native components, Tailwind CSS v4, React Aria, compound component architecture, CSS-first theming with OKLCH tokens, `data-reduce-motion` animation control, and built for AI-assisted development with MCP servers, agent skills, and LLMs.txt. [Read the full announcement →](/systems/heroui/docs/releases/v3-0-0) --- ### HeroUI Pro Premium components, templates, and AI tooling for React and React Native. Pre-sale pricing is live. [See plans and pricing at heroui.pro →](https://heroui.pro) --- ### v3.0.0-rc.1 **March 14, 2026** Seven new components ([Drawer](/systems/heroui/docs/components/drawer), [ToggleButton](/systems/heroui/docs/components/toggle-button), [ToggleButtonGroup](/systems/heroui/docs/components/toggle-button-group), [Meter](/systems/heroui/docs/components/meter), [ProgressBar](/systems/heroui/docs/components/progress-bar), [ProgressCircle](/systems/heroui/docs/components/progress-circle), [Toolbar](/systems/heroui/docs/components/toolbar)), **virtualization** for [Table](/systems/heroui/docs/components/table) and [ListBox](/systems/heroui/docs/components/list-box), `ButtonGroup.Separator` + vertical orientation for [ButtonGroup](/systems/heroui/docs/components/button-group), and React Aria Components bumped to v1.16.0. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-rc-1) --- ### v3.0.0-beta.8 **March 2, 2026** This release adds three new components ([Badge](/systems/heroui/docs/components/badge), [Pagination](/systems/heroui/docs/components/pagination), [Table](/systems/heroui/docs/components/table)) and new `InputContainer` composition APIs for [DateField](/systems/heroui/docs/components/date-field) + [TimeField](/systems/heroui/docs/components/time-field). ⚠️ **Breaking changes**: TextField CSS classes were renamed from `.text-field` to `.textfield`. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-beta-8) --- ### v3.0.0-beta.7 **February 18, 2026** This release introduces a comprehensive **Date & Time** system with four new components ([Calendar](/systems/heroui/docs/components/calendar), [RangeCalendar](/systems/heroui/docs/components/range-calendar), [DatePicker](/systems/heroui/docs/components/date-picker), [DateRangePicker](/systems/heroui/docs/components/date-range-picker)), new [Switch.Content](/systems/heroui/docs/components/switch) sub-component, explicit [Tabs.Separator](/systems/heroui/docs/components/tabs) for opt-in separator lines, and ⚠️ **breaking changes** removing `hideSeparator` from Tabs and consolidating `DateInputGroup`/`ColorInputGroup` under their respective field components. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-beta-7) --- ### v3.0.0-beta.6 **February 6, 2026** This release introduces a comprehensive **Color System** with six new components ([ColorPicker](/systems/heroui/docs/components/color-picker), [ColorArea](/systems/heroui/docs/components/color-area), [ColorSlider](/systems/heroui/docs/components/color-slider), [ColorField](/systems/heroui/docs/components/color-field), [ColorSwatch](/systems/heroui/docs/components/color-swatch), [ColorSwatchPicker](/systems/heroui/docs/components/color-swatch-picker)), major [Toast](/systems/heroui/docs/components/toast) improvements with loading states and promise support, [Separator](/systems/heroui/docs/components/separator) variants, and ⚠️ **breaking changes** renaming `Toast.Container` to `Toast.Provider` and updating CSS class names to hyphenated format. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-beta-6) --- ### v3.0.0-beta.5 - Fixed build issue ### v3.0.0-beta.4 **January 20, 2026** > **Critical Build Issue Fixed**: This version (beta.4) had a critical build issue that has been fixed in **beta.5**. Please upgrade to `@heroui/styles@3.0.0-beta.5` and `@heroui/react@3.0.0-beta.5` to ensure proper TypeScript declaration generation and export resolution. This release introduces the new [Theme Builder](https://heroui.com/themes) for visual theme customization, three new components ([Autocomplete](/systems/heroui/docs/components/autocomplete), [Breadcrumbs](/systems/heroui/docs/components/breadcrumbs), [Toast](/systems/heroui/docs/components/toast)), secondary variant for [Tabs](/systems/heroui/docs/components/tabs), primary/secondary variants for [Input](/systems/heroui/docs/components/input) and [InputGroup](/systems/heroui/docs/components/input-group), and ⚠️ **breaking changes** removing Link's underline variants and `isInSurface` prop from form components. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-beta-4) --- ### v3.0.0-beta.3 **December 19, 2025** This release introduces seven new components ([ButtonGroup](/systems/heroui/docs/components/button-group), [DateField](/systems/heroui/docs/components/date-field), [ErrorMessage](/systems/heroui/docs/components/error-message), [ScrollShadow](/systems/heroui/docs/components/scroll-shadow), [SearchField](/systems/heroui/docs/components/search-field), [TagGroup](/systems/heroui/docs/components/tag-group), [TimeField](/systems/heroui/docs/components/time-field)), adds `fullWidth` support for form and input components, introduces `hideSeparator` to [Tabs](/systems/heroui/docs/components/tabs), [ButtonGroup](/systems/heroui/docs/components/button-group), and [Accordion](/systems/heroui/docs/components/accordion) for cleaner layouts, includes styling fixes, and ⚠️ **breaking changes** removing the `asChild` prop and updating [AlertDialog](/systems/heroui/docs/components/alert-dialog) & [Modal](/systems/heroui/docs/components/modal) backdrop variant. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-beta-3) --- ### v3.0.0-beta.2 **November 20, 2025** This release introduces six essential new components ([AlertDialog](/systems/heroui/docs/components/alert-dialog), [ComboBox](/systems/heroui/docs/components/combo-box), [Dropdown](/systems/heroui/docs/components/dropdown), [InputGroup](/systems/heroui/docs/components/input-group), [Modal](/systems/heroui/docs/components/modal), [NumberField](/systems/heroui/docs/components/number-field)), enhances theme compatibility and motion preferences, improves the [Select](/systems/heroui/docs/components/select) component API with a ⚠️ **breaking change**, plus various refinements and bug fixes. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-beta-2) --- ### 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](/docs/compoenents/alert), [Checkbox](/systems/heroui/docs/components/checkbox), [InputOTP](/systems/heroui/docs/components/input-otp), [ListBox](/systems/heroui/docs/components/listbox), [Select](/systems/heroui/docs/components/select), [Slider](/systems/heroui/docs/components/slider), [Surface](/systems/heroui/docs/components/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 →](/systems/heroui/docs/releases/v3-0-0-beta-1) --- ## Previous Releases ### v3.0.0-alpha.35 **October 21, 2025** #### React Server Components Support - 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., `` → ``) - Named exports remain unchanged and fully supported #### React 19 Improvements - Removed `forwardRef` (now native in [React 19](https://react.dev/blog/2024/12/05/react-19#ref-as-a-prop)) - Simplified Context usage (`Context.Provider` → [React 19](https://react.dev/blog/2024/12/05/react-19#context-as-a-provider)) #### Switch Component Refactoring - **(⚠️ Breaking change)**: Split Switch and SwitchGroup into separate components - Cleaner API: `` replaces `` and `` - 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 →](/systems/heroui/docs/releases/v3-0-0-alpha-35) ### v3.0.0-alpha.34 **October 15, 2025** - Added Form-based components: [Description](/systems/heroui/docs/components/description), [FieldError](/systems/heroui/docs/components/field-error), [Fieldset](/systems/heroui/docs/components/fieldset), [Form](/systems/heroui/docs/components/form), [Input](/systems/heroui/docs/components/input), [Label](/systems/heroui/docs/components/label), [RadioGroup](/systems/heroui/docs/components/radio-group), [TextField](/systems/heroui/docs/components/text-field), and [TextArea](/systems/heroui/docs/components/textarea). - Introduced form field tokens `--field-*` - Reorganized Storybook by category - **(Breaking change)**: Renamed `--skeleton-default-animation-type` to `--skeleton-animation` in [Skeleton](/systems/heroui/docs/components/skeleton) - Aligned data-slot markers across components - Improved documentation [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-alpha-34) ### v3.0.0-alpha.33 **October 5, 2025** - Upgraded RAC with [October 2, 2025 Release](https://react-spectrum.adobe.com/releases/2025-10-02.html) - Reordered [Tabs](/systems/heroui/docs/components/tabs) Indicator (**Breaking change**) - Updated [Tabs](/systems/heroui/docs/components/tabs) component to use React Aria's `SelectionIndicator`, now supports SSR - Updated [Disclosure](/systems/heroui/docs/components/disclosure) and [Disclosure Group](/systems/heroui/docs/components/disclosure-group) components to use RAC CSS variables for the expand and collapse animations - Updated [Switch](/systems/heroui/docs/components/switch) component styles and animations - Added `size` variants and added demo in [Switch](/systems/heroui/docs/components/switch#sizes) - Added related showcases in [Button](/systems/heroui/docs/components/button), [Tabs](/systems/heroui/docs/components/tabs), [Disclosure](/systems/heroui/docs/components/disclosure), [Disclosure Group](/systems/heroui/docs/components/disclosure-group) - Improved documentation [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-alpha-33) ### v3.0.0-alpha.32 **October 1, 2025** Card component redesigned with [new variants](/systems/heroui/docs/components/card), added [CloseButton](/systems/heroui/docs/components/close-button) component, [MCP Server](/docs/ui-for-agents/mcp-server) for AI coding assistants, and improved documentation. [Read full release notes →](/systems/heroui/docs/releases/v3-0-0-alpha-32) ### 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 is now stable. Future releases follow a regular cycle: - **Patch releases**: Bug fixes and minor improvements as needed - **Minor releases**: New components and features, typically monthly - **Major releases**: Architectural changes with migration guides ## Contributing Found an issue or want to contribute? Check out our [GitHub repository](https://github.com/heroui-inc/heroui). --- Index of all JGuang resources: https://jiguang132.com/llms.txt