v3.0.4

heroui-inc/herouiv3.0.4May 8, 2026by wingkwong

AI Summary

Introduced a new Text typography component, a theme selector for documentation, and design token improvements for border-radius and focus rings.

Key Highlights

  • New Text typography component with Heading, Paragraph, Code, and Prose sub-components.
  • Docs theme selector with 11 built-in themes.
  • Border-radius design tokens using min() to prevent visual issues on large radius themes.
  • Reworked Table focus ring using per-cell inset shadows.

New Features

  • Text typography primitive (Heading, Paragraph, Code, Prose).
  • Docs theme selector.
  • Border-radius design tokens.
  • Table focus ring rework using per-cell inset shadows.

Full Release Notes

## 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
* 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

## New Contributors
* @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