v3.2.2
- 📦 React Aria 1.19.0
- 📑 Tabs → overflow scrolling with chevrons + edge fade
- ✏️ Input fields → clear/close buttons no longer submit forms
- ✅ Checkbox, Radio, Switch → overflow scroll fix
- 🎨 Chip, DatePicker, Autocomplete, Toast → polish fixes
- fix(docs): switch custom-styles and with-icons examples by @wingkwong in https://github.com/heroui-inc/heroui/pull/6662
- build(docs): configure android asset links for herouinative app by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6668
- fix(docs): render native-showcase fallback page outside the [lang] tree by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6671
- docs(native): add v1.0.5 release notes and update component docs by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6685
- feat(docs): enable Android Play Store download link by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6675
- feat(docs): order release badges by date, newest first by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6686
- chore(docs): fix typos in native release note & add cn version by @wingkwong in https://github.com/heroui-inc/heroui/pull/6687
- chore(docs): add react router in CLI page by @wingkwong in https://github.com/heroui-inc/heroui/pull/6695
- feat(tabs): add tabs scroller to handle overflow by @wingkwong in https://github.com/heroui-inc/heroui/pull/6633
- V3.2.2 by @wingkwong in https://github.com/heroui-inc/heroui/pull/6660
https://heroui.com/docs/react/releases/v3-2-2
Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.2.1...v3.2.2
v3.2.1
- 📦 @heroui/react → no longer bundles its own copy of react-aria
- 💬 Tooltip → duplicate-instance issues fixed
- 🔧 SwitchGroup → horizontal layout fix
- chore(docs): add missing typography in component category by @wingkwong in https://github.com/heroui-inc/heroui/pull/6650
- fix(react): externalize react-aria subpaths to prevent vendored copy by @wingkwong in https://github.com/heroui-inc/heroui/pull/6653
- fix(switch-group): add missing switch-group-items by @wingkwong in https://github.com/heroui-inc/heroui/pull/6655
- V3.2.1 by @wingkwong in https://github.com/heroui-inc/heroui/pull/6654
Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.2.0...v3.2.1
v3.2.0
- React Aria 1.18.0
- Calendar → week/day views, multi-select, year picker
- Table → SortableColumnHeader
- Autocomplete → Virtualizer
- Tooltip → delay theme vars
- Toggles → new Field composition
Radio, Checkbox, and Switch move to an explicit *.Content composition — *.Control nests inside *.Content, the label is plain text inside *.Content (no nested <Label>), and Description/FieldError become siblings of *.Content.
- fix(docs): broken component links by @wingkwong in https://github.com/heroui-inc/heroui/pull/6577
- chore(docs): add dark mode guide (cn) by @wingkwong in https://github.com/heroui-inc/heroui/pull/6578
- fix(docs): broken redirects by @wingkwong in https://github.com/heroui-inc/heroui/pull/6579
- docs(native): add v1.0.4 release notes and component updates by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6580
- chore(docs): update cn docs for pr6580 & sync missing changes by @wingkwong in https://github.com/heroui-inc/heroui/pull/6581
- fix(toast): defer success/error toast after promise to avoid ViewTransition collision by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6511
- fix(styles): cap modal/alert-dialog scroll-inside height so body scrolls by @wingkwong in https://github.com/heroui-inc/heroui/pull/6597
- fix(fieldset): propagate disabled to descendant RAC by @wingkwong in https://github.com/heroui-inc/heroui/pull/6596
- refactor(table): export Table.SortableColumnHeader by @wingkwong in https://github.com/heroui-inc/heroui/pull/6588
- chore(deps): React Aria Upgrade (v1.18.0) by @wingkwong in https://github.com/heroui-inc/heroui/pull/6586
- fix(scroll-shadow): preserve scrollbar mask by @diegonzs in https://github.com/heroui-inc/heroui/pull/6598
- docs(native): remove figma links from component docs by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6601
- fix(styles): column separator and resizer position in RTL layout by @shlomoi10 in https://github.com/heroui-inc/heroui/pull/6606
- docs(native): add create-heroui-native-app CLI docs and quick-start restructure by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6608
- docs(native): cli release note (cn version) by @wingkwong in https://github.com/heroui-inc/heroui/pull/6610
- Enhance calendar component with new features and documentation by @diegonzs in https://github.com/heroui-inc/heroui/pull/6611
- feat(tooltip): add tooltip delay css vars by @wingkwong in https://github.com/heroui-inc/heroui/pull/6617
- docs(react): add copy prompt in quick install by @wingkwong in https://github.com/heroui-inc/heroui/pull/6609
- refactor(toggles): explicit composition for radio, checkbox & switch by @diegonzs in https://github.com/heroui-inc/heroui/pull/6614
- fix(styles): preserve Select/Autocomplete variant background when isInvalid is set by @mvanhorn in https://github.com/heroui-inc/heroui/pull/6582
- fix: typecheck issues by @wingkwong in https://github.com/heroui-inc/heroui/pull/6623
- fix(toast): align close button position with container padding by @Xuxyyy in https://github.com/heroui-inc/heroui/pull/6574
- fix(styles): inherit font-size from parent instead of forcing text-sm in link by @wingkwong in https://github.com/heroui-inc/heroui/pull/6621
- fix(styles): prevent date-picker calendar popover from being horizontally clipped by @wingkwong in https://github.com/heroui-inc/heroui/pull/6622
- fix(styles): correct secondary header borders in virtualized mode by @wingkwong in https://github.com/heroui-inc/heroui/pull/6624
- fix(docs): preserve NativeComponentsCategory tag in native llms-full.txt by @wingkwong in https://github.com/heroui-inc/heroui/pull/6634
- chore(docs): update Style Fixes for latest merged PRs by @wingkwong in https://github.com/heroui-inc/heroui/pull/6635
- fix(styles): constrain popover size for virtualized ListBox by @wingkwong in https://github.com/heroui-inc/heroui/pull/6642
- refactor(docs): optimization by @wingkwong in https://github.com/heroui-inc/heroui/pull/6630
- fix(autocomplete): popover focus by @wingkwong in https://github.com/heroui-inc/heroui/pull/6627
- fix(tooltip): avoid Focusable warning when mounted inside inert subtree by @wingkwong in https://github.com/heroui-inc/heroui/pull/6628
- fix(spinner): restore animation in non-flex layouts by @wingkwong in https://github.com/heroui-inc/heroui/pull/6644
- fix(styles): browser autofill highlight on grouped input fields by @wingkwong in https://github.com/heroui-inc/heroui/pull/6625
- fix(styles): prevent flex-shrink from collapsing virtualized ListBox scroll height by @wingkwong in https://github.com/heroui-inc/heroui/pull/6636
- V3.2.0 by @wingkwong in https://github.com/heroui-inc/heroui/pull/6616
- @shlomoi10 made their first contribution in https://github.com/heroui-inc/heroui/pull/6606
- @mvanhorn made their first contribution in https://github.com/heroui-inc/heroui/pull/6582
- @Xuxyyy made their first contribution in https://github.com/heroui-inc/heroui/pull/6574
https://heroui.com/docs/react/releases/v3-2-0
Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.1.0...v3.2.0
v3.1.0
- 🌐 Chinese React docs, release notes & localized demos
- 🎨 Accessible soft foreground tokens with a vibrant palette opt-in
- 📜 Shared scrollbar utilities with data-scrollbar="thin" | "default" | "none"
- 🔗 Link underline now appears on hover, with pressed-state decoration updates
- ⌨️ Toast tab order cleanup and height measurement fixes
- 🧭 Better RTL support for Table, pickers, ListBox and Menu items
- 🔧 Fixes for useTheme SSR, Fieldset disabled propagation, overlays, Modal and Dialog focus behavior
- feat(docs): SEO improvements, blog content rebalancing, and AI discoverability by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6536
- chore(.github): revise bug_report template content by @wingkwong in https://github.com/heroui-inc/heroui/pull/6539
- fix(styles): define calculated theme tokens on .dark for nested dark regions by @wingkwong in https://github.com/heroui-inc/heroui/pull/6542
- fix(demo): update Google and Apple icons in login demo by @diegonzs in https://github.com/heroui-inc/heroui/pull/6543
- fix(docs): Add missing variant props in Modal example by @DarkstarXDD in https://github.com/heroui-inc/heroui/pull/6464
- chore(docs): add missing init cmd options & add agents-md content by @wingkwong in https://github.com/heroui-inc/heroui/pull/6541
- feat(docs): wire HeroUI Native Universal Links and download fallback by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6540
- fix(fieldset): forward disabled state to descendant fields by @wingkwong in https://github.com/heroui-inc/heroui/pull/6547
- feat(styles): add soft foreground tokens and migrate components by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6548
- feat(styles): add shared scrollbar system with per-component utilities by @diegonzs in https://github.com/heroui-inc/heroui/pull/6545
- docs(native-showcase): add privacy policy page by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6551
- Agent readiness features by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6553
- fix(docs): sync home iframe demo themes by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6554
- fix(docs): use white accent for uber dark theme by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6556
- fix(docs): move mobile design theme selector to header by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6555
- fix(styles): prevent body focus ring clipping by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6557
- fix(styles): prevent overlay placement miscalculation during enter animation by @Emiyaaaaa in https://github.com/heroui-inc/heroui/pull/6549
- fix(styles): prevent Dialog from being programmatically scrolled by focus by @anobaka in https://github.com/heroui-inc/heroui/pull/6448
- fix(table): use logical border-radius for RTL corners by @FZ1010 in https://github.com/heroui-inc/heroui/pull/6568
- fix(toast): move tabindex from style object to HTML attribute by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6510
- fix(toast): clean up stale toastHeights entries when toasts are dismissed by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6512
- fix(hooks): resolve useTheme SSR crash and circular dependency by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6561
- fix(docs): correct NumberField "With Chevrons" demo layout by @wingkwong in https://github.com/heroui-inc/heroui/pull/6569
- feat(docs): support i18n and add cn pages by @wingkwong in https://github.com/heroui-inc/heroui/pull/6533
- fix(link): update underline hover states by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6570
- chore(docs): sync with PR6570 by @wingkwong in https://github.com/heroui-inc/heroui/pull/6571
- fix(style): use logical inline-end/start for chevrons, value text and indicators by @FZ1010 in https://github.com/heroui-inc/heroui/pull/6573
- V3.1.0 by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6576
- @DarkstarXDD made their first contribution in https://github.com/heroui-inc/heroui/pull/6464
- @Emiyaaaaa made their first contribution in https://github.com/heroui-inc/heroui/pull/6549
- @anobaka made their first contribution in https://github.com/heroui-inc/heroui/pull/6448
- @FZ1010 made their first contribution in https://github.com/heroui-inc/heroui/pull/6568
https://heroui.com/docs/react/releases/v3-1-0
Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.0.5...v3.1.0
v3.0.5
The component shipped in v3.0.4 used text-* BEM modifiers, which collide with Tailwind's text-* utility family. tailwind-variants runs tailwind-merge on every variant composition and dedupes text--body-sm, text--color-muted, text--weight-normal to a single class — silently dropping the others.
Renaming the block to typography permanently fixes the collision (#6505, closes #6497).
Before:
import {Text} from "@heroui/react";
<Text type="body-sm" color="muted" weight="medium">
Hello world
</Text>;
After:
import {Typography} from "@heroui/react";
<Typography type="body-sm" color="muted" weight="medium">
Hello world
</Typography>;
- fix(styles): use accent soft foreground for default hover by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6500
- fix(styles): disable twMerge for textVariants by @wingkwong in https://github.com/heroui-inc/heroui/pull/6501
- refactor(styles): use unprefixed source tokens across components and theme builder by @diegonzs in https://github.com/heroui-inc/heroui/pull/6499
- feat(docs): add CLI page by @wingkwong in https://github.com/heroui-inc/heroui/pull/6498
- docs(native): document HeroUI Native v1.0.3 release by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6502
- docs(text): refine Text component docs — reorder sidebar and update usage demo by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6504
- refactor(text): rename Text to Typography by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6505
- chore(deps): bump next version + action version by @wingkwong in https://github.com/heroui-inc/heroui/pull/6529
- fix(styles): use field-border for radio default border color by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6522
- fix(styles): add field border width to checkbox control by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6521
- docs(releases): add v3.0.5 release notes by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6531
- V3.0.5 by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6503
- @aosmcleod made their first contribution in https://github.com/heroui-inc/heroui/pull/6505
Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.0.4...v3.0.5
v3.0.4
New compound component for semantic typography — Text.Heading, Text.Paragraph, Text.Code, and Text.Prose. Renders the correct HTML element automatically. Ported from HeroUI Pro.
Preview any component page in 11 built-in themes — Sky, Lavender, Mint, Netflix, Uber, Spotify, Coinbase, Airbnb, Discord, and Rabbit. Your pick is saved to localStorage.
All hardcoded border-radius values across 45+ component CSS files now use min() to cap the radius. No more broken visuals with large custom radius themes.
Focus ring now spans across individual cells using per-cell inset shadows — works correctly with virtualized rows too.
- Checkbox — removed hardcoded accent-hover background from selected/indeterminate state
- Autocomplete — isDisabled now propagates to Trigger and ClearButton
- Tooltip — revised padding and switched border-radius to design token
- Description — removed extra horizontal padding from form field descriptions
- Theme Builder — fixed swapped accent-foreground values
- Soft color contrast — darker accent-soft-foreground for light accent themes (Sky, Lavender, Mint), fixing barely-visible text on secondary buttons, chips, and badges
- fix(docs): correct swapped accent-foreground values in theme builder by @wingkwong in https://github.com/heroui-inc/heroui/pull/6401
- fix(docs): update mail template iframe url to /templates/email by @diegonzs in https://github.com/heroui-inc/heroui/pull/6449
- refactor(docs): adjust styling in PreviewContainer component by @diegonzs in https://github.com/heroui-inc/heroui/pull/6450
- chore(docs): replace pre-sale with launch discount in pro banner by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6453
- chore(textfield): move value to TextField by @wingkwong in https://github.com/heroui-inc/heroui/pull/6454
- feat(docs): show Pro components in OSS search with PRO badge by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6458
- feat(docs): add UTM params to Pro search result links by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6459
- fix(autocomplete): isDisabled by @wingkwong in https://github.com/heroui-inc/heroui/pull/6443
- fix(styles): replace rounded-full and hardcoded border-radius with design tokens by @diegonzs in https://github.com/heroui-inc/heroui/pull/6465
- fix(docs): keep sidebar scroll within viewport by @lunaxislu in https://github.com/heroui-inc/heroui/pull/6472
- chore: add AGENTS.md and configure pnpm onlyBuiltDependencies by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6473
- refactor(styles): table focus by @wingkwong in https://github.com/heroui-inc/heroui/pull/6476
- fix(styles): revise tooltip padding by @wingkwong in https://github.com/heroui-inc/heroui/pull/6481
- fix(styles): remove description horizontal padding from form fields by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6484
- fix(styles): wire text.css into styles bundle and enrich Text stories by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6485
- feat(react): add Text typography primitive by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6479
- fix(styles): cap border-radius with min() to prevent visibility issues on large radius themes by @diegonzs in https://github.com/heroui-inc/heroui/pull/6487
- feat: Redesign colors documentation with light/dark previews and CSS variables by @diegonzs in https://github.com/heroui-inc/heroui/pull/6486
- fix(docs): pass fallback to color copy handler by @diegonzs in https://github.com/heroui-inc/heroui/pull/6492
- feat(docs): add design theme selector by @wingkwong in https://github.com/heroui-inc/heroui/pull/6471
- feat(docs): add frameworks by @wingkwong in https://github.com/heroui-inc/heroui/pull/6495
- fix(docs): add missing github.pull and pr link by @wingkwong in https://github.com/heroui-inc/heroui/pull/6496
- V3.0.4 by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6483
- @lunaxislu made their first contribution in https://github.com/heroui-inc/heroui/pull/6472
Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.0.3...v3.0.4
v3.0.3
React Aria Components 1.17 with 90% fewer deps, expandable Table rows, useTheme hook, and Apache 2.0 license.
⚡ React Aria Components 1.17 — 90% fewer dependencies, faster installs and builds (#6433) 🌲 Expandable Table rows — tree-style expand/collapse for file browsers, nested categories & hierarchical data 🎨 New useTheme hook — theme switching for Vite & CRA apps, persists to localStorage, supports system preference (#6426) 🧩 DOM polymorphic utility — render-prop API to swap host elements (e.g. render a Card as ) (#6403) 📜 License moved to Apache 2.0 — same permissive freedoms + explicit patent grant, no action needed 🐛 Fix for nested Tabs inheriting parent variant styles
- fix(docs): add missing github.pull and pr link by @wingkwong in https://github.com/heroui-inc/heroui/pull/6396
- chore(docs): add codex and opencode examples by @wingkwong in https://github.com/heroui-inc/heroui/pull/6398
- fix(dropdown): with-section example by @wingkwong in https://github.com/heroui-inc/heroui/pull/6413
- chore: update LICENSE by @wingkwong in https://github.com/heroui-inc/heroui/pull/6415
- chore: update license to Apache License 2.0 by @wingkwong in https://github.com/heroui-inc/heroui/pull/6416
- chore(docs): mute videos by default by @wingkwong in https://github.com/heroui-inc/heroui/pull/6420
- docs(native): add v1.0.2 release notes and update component API references by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6429
- fix(docs): broken link in migration guide by @Stybo in https://github.com/heroui-inc/heroui/pull/6440
- V3.0.3 by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6441
Full release notes: https://heroui.com/docs/releases/v3-0-3
v3.0.2
- Autocomplete:
--trigger-widthCSS variable on the popover now tracks the trigger element's width viauseResizeObserver(#6374) - Drawer: Panel transitions rewritten from Tailwind
animate-in/animate-outto native CSStranslatetransitions for smoother animations (#6393) - InputGroup: Secondary variant focus background triggers only on actual input/textarea focus (#6362)
- Tag:
CloseButtonnow has explicitaria-label="Remove tag"for screen readers (#6341)
--backdroptheme variable: New CSS variable for overlay backdrops — Modal, AlertDialog, Drawer now usebg-backdropinstead of hardcoded values (#6375)
- Trigger elements across Popover, Tooltip, Dropdown, Modal, AlertDialog, Drawer, Disclosure now apply
inline-block(#6373) - Default arrow SVG for Tooltip + Popover updated to a smoother cubic bezier curve (#6372)
- Tag
smandmdsizes get increased horizontal padding (#6315)
- Release workflow added with
pnpm publish+NPM_TOKEN - Replaced changesets with bumpp for version management (#6354)
Full release notes: https://heroui.com/docs/releases/v3-0-2
@heroui/react@3.0.1
A complete rewrite for React. A brand-new library for React Native.
One design system. Beautiful everywhere.
🌐 Web → 75+ components, 21 new 📱 Native → 37+ components, built from scratch 🎨 Styling → Tailwind CSS v4, CSS variables, OKLCH, BEM ⚡ Performance → CSS animations, no JS runtime ♿ Accessibility → React Aria Components ✨ Architecture → Compound components, fully customizable, headless-ready 🤖 AI → MCP Server, Agent Skills, LLMs.txt 📎 Figma Kit v3 with 1:1 component parity
Every component rewritten. Every animation moved to CSS. Styles decoupled from implementation. And tooling that treats AI assistants as a first-class dev interface.
🔗 Post/Tweet → https://x.com/hero_ui/status/2035353807735976374 📋 Release Notes → https://heroui.com/docs/react/releases/v3-0-0 🌐 Docs → https://heroui.com/docs/react/getting-started/quick-start 📱 Native Docs → https://heroui.com/docs/native/getting-started/quick-start 🖼️ Figma Kit → https://www.figma.com/community/file/1546526812159103429/heroui-figma-kit-v3
A huge thank you to everyone who used the alpha and beta versions — your bug reports, feedback, and patience helped us find and fix issues that made v3 stable. This release wouldn't be the same without you ❤️
@heroui/use-aria-button@2.2.22
- #6281
7437888Thanks @wingkwong! - react-aria versions (release v1.16.0)