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)
@heroui/use-disclosure@2.2.19
- #6281
7437888Thanks @wingkwong! - react-aria versions (release v1.16.0)
@heroui/use-aria-overlay@2.0.6
- #6281
7437888Thanks @wingkwong! - react-aria versions (release v1.16.0)
@heroui/use-aria-accordion@2.2.20
- #6281
7437888Thanks @wingkwong! - react-aria versions (release v1.16.0)