Starstruk Logo MarkStarstruk

v3.0.5

louislam/dockgev3.0.5May 16, 2026by wingkwong

AI Summary

This release addresses a critical Tailwind CSS utility collision by renaming the `Text` component to `Typography` to prevent style deduplication, alongside various style fixes for radio buttons, checkboxes, and focus rings.

Key Highlights

  • Breaking Change: `Text` component renamed to `Typography` to fix Tailwind utility collision
  • Fix: Use accent soft foreground for default hover states
  • Fix: Use field-border for radio default border color
  • Fix: Add field border width to checkbox control
  • Refactor: Use unprefixed source tokens across components

Breaking Changes

  • `Text` component renamed to `Typography`

New Features

  • CLI page added to documentation

Full Release Notes

## ⚠️ Breaking Changes

### `Text` → `Typography`

The component shipped in [v3.0.4](https://heroui.com/docs/react/releases/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](https://github.com/heroui-inc/heroui/pull/6505), closes [#6497](https://github.com/heroui-inc/heroui/issues/6497)).

**Before:**

```tsx
import {Text} from "@heroui/react";

<Text type="body-sm" color="muted" weight="medium">
  Hello world
</Text>;
```

**After:**

```tsx
import {Typography} from "@heroui/react";

<Typography type="body-sm" color="muted" weight="medium">
  Hello world
</Typography>;
```

## What's Changed
* 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

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