v3.0.5
plausible/analyticsv3.0.5May 16, 2026by wingkwong
AI Summary
HeroUI v3.0.5 introduces a breaking change by renaming the `Text` component to `Typography` to resolve Tailwind CSS class conflicts. The release also includes style refactoring and documentation updates.
Key Highlights
- Renamed `Text` component to `Typography`
- Fixed Tailwind `text-*` class collision
- Refactored styles to use unprefixed source tokens
- Improved theme builder consistency
Breaking Changes
- Component renamed from `Text` to `Typography`
- BEM modifiers changed from `text-*` to `typography-*`
New Features
- Refactored theme builder tokens
- Improved style consistency across components
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