nextui-org/nextui
 Watch   
 Star   
 Fork   
简介统计版本
2 days ago
nextui
nextui-org

v3.1.0

What's inside

  • 🌐 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

What's Changed

New Contributors

Full Release Note

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

Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.0.5...v3.1.0

12 days ago
nextui
nextui-org

v3.0.5

⚠️ Breaking Changes

Text → Typography

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>;

What's Changed

New Contributors

Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.0.4...v3.0.5

20 days ago
nextui
nextui-org

v3.0.4

What's New

✍️ Text Component

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.

🎨 Docs Theme Selector

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.

📐 Border-Radius Design Tokens

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.

🔲 Table Focus Ring Rework

Focus ring now spans across individual cells using per-cell inset shadows — works correctly with virtualized rows too.

Bug Fixes

  • 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

What's Changed

New Contributors

Full Changelog: https://github.com/heroui-inc/heroui/compare/v3.0.3...v3.0.4

2026-04-17 22:02:23
nextui
nextui-org

v3.0.3

React Aria Components 1.17 with 90% fewer deps, expandable Table rows, useTheme hook, and Apache 2.0 license.

Highlights:

⚡ 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

What's Changed

Full release notes: https://heroui.com/docs/releases/v3-0-3

2026-04-03 22:36:02
nextui
nextui-org

v3.0.2

Bug Fixes

  • Autocomplete: --trigger-width CSS variable on the popover now tracks the trigger element's width via useResizeObserver (#6374)
  • Drawer: Panel transitions rewritten from Tailwind animate-in/animate-out to native CSS translate transitions for smoother animations (#6393)
  • InputGroup: Secondary variant focus background triggers only on actual input/textarea focus (#6362)
  • Tag: CloseButton now has explicit aria-label="Remove tag" for screen readers (#6341)

Features

  • --backdrop theme variable: New CSS variable for overlay backdrops — Modal, AlertDialog, Drawer now use bg-backdrop instead of hardcoded values (#6375)

Style Improvements

  • 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 sm and md sizes get increased horizontal padding (#6315)

Internal

  • 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

2026-03-21 20:26:51
nextui
nextui-org

@heroui/react@3.0.1

Introducing HeroUI v3

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 ❤️

2026-03-07 23:57:58
nextui
nextui-org

@heroui/use-aria-button@2.2.22

Patch Changes

2026-03-07 23:57:58
nextui
nextui-org

@heroui/use-aria-link@2.2.23

Patch Changes

2026-03-07 23:57:58
nextui
nextui-org

@heroui/use-aria-accordion@2.2.20

Patch Changes

2026-03-07 23:57:58
nextui
nextui-org

@heroui/use-disclosure@2.2.19

Patch Changes