Pro--% off in--d : --h : --m : --s
HeroUI
27.7k

v3.0.4

New Text component, docs theme selector, border-radius design tokens with min() capping, table focus ring rework, and bug fixes.

May 2026

Patch release: new Text compound component ported from HeroUI Pro, a docs theme selector for previewing components in different themes, min()-capped border-radius tokens across 45+ component CSS files, reworked Table focus rings, and fixes for Checkbox, Autocomplete, Tooltip, and form field padding.

Installation

Update to the latest version:

npm i @heroui/styles@latest @heroui/react@latest
pnpm add @heroui/styles@latest @heroui/react@latest
yarn add @heroui/styles@latest @heroui/react@latest
bun add @heroui/styles@latest @heroui/react@latest

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.

What's New

Text Component

New compound component for structured typography, ported from HeroUI Pro (#6479). Renders the right HTML element automatically — <h1><h6>, <p>, or <code> — based on the sub-component or type prop.

h136px / 600 / 1.11 / tight

Build better interfaces

h230px / 600 / 1.17 / tight

Built for the intelligence age

h324px / 600 / 1.25 / tight

Pricing on your terms

h420px / 600 / 1.33 / tight

Apply to the startup program

h518px / 600 / 1.39 / tight
Card titles
h616px / 600 / 1.50 / tight
Smaller feature headers
body16px / 400 / 1.75

Primary body text used across documentation, marketing copy, and descriptions.

body-sm14px / 400 / 1.50

Secondary body, table cells, navigation, and sidebar items.

body-xs12px / 400 / 1.25

Captions, badges, helper text, and fine print.

code14px / mono
pnpm add @heroui/react
import {Text} from "@heroui/react";

const scale = [
  {
    label: "h1",

Sub-components: Text.Heading, Text.Paragraph, Text.Code, Text.Prose.

Props on all sub-components: align, color, weight, truncate. Text.Heading accepts level (1–6). Text.Paragraph accepts size ("base", "sm", "xs").

Wrap mixed content in Text.Prose for automatic prose spacing:

<Text.Prose>
  <Text.Heading level={3}>Getting Started</Text.Heading>
  <Text.Paragraph>Install the package and import the component.</Text.Paragraph>
</Text.Prose>

Docs Theme Selector

The documentation site now includes a theme selector that lets you preview every component in different themes — light, dark, brutalism, and more. Your choice is saved to localStorage so it persists across sessions (#6471).

Border-Radius Design Tokens

All rounded-full and hardcoded border-radius values across ~45 component CSS files now use min() to cap the computed radius (#6465). Components no longer look broken when users set very large custom radius themes — the radius stops growing once it would exceed the element's dimensions.

Table Focus Ring Rework

Table row focus indicators are split across individual cells using per-cell inset shadows instead of a single box-shadow on the row. The ring now looks continuous across all cells and works correctly with virtualized table wrappers.

Bug Fixes

  • Checkbox: removed hardcoded accent-hover background from selected/indeterminate indicator state (#6487)
  • Autocomplete: isDisabled now propagates from root to Trigger and ClearButton via context (#6443)
  • Description: removed unnecessary horizontal padding from description text in form fields (textfield, color-field, date-field, number-field, search-field, time-field) (#6484)
  • Tooltip: changed padding from px-2 py-1 to p-2 and switched border-radius to design token (#6481)
  • Theme Builder: fixed swapped accent-foreground values (#6401)
  • Soft color contrast: accent-soft-foreground now uses a darker shade for light accent themes (Sky, Lavender, Mint), fixing barely-visible text on secondary buttons, chips, and badges. The shared theme now reads from --accent-soft-foreground with a fallback to --accent

Contributors

Thanks to everyone who contributed to this release!

On this page