BT

Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ

Topics

Choose your language

InfoQ Homepage News HeroUI v3 Lands as a Ground-Up Rewrite for React and React Native, Built on Tailwind CSS v4

HeroUI v3 Lands as a Ground-Up Rewrite for React and React Native, Built on Tailwind CSS v4

Listen to this article -  0:00

HeroUI, the React component library formerly known as NextUI, has released HeroUI v3, a ground-up rewrite that the team frames as one design system for web and native. The March 2026 release ships more than 75 web components, 21 of them new, alongside a brand-new React Native library built from scratch with 37 components.

HeroUI v3 is built on React Aria Components for accessibility and Tailwind CSS v4 for styling, exposing CSS variables, OKLCH colours and BEM modifiers for customisation. Every animation has moved to CSS with no JavaScript runtime, and the library adopts a compound component API that drops the old provider wrapper and works out of the box with React 19 and Next.js.

The rewrite also leans heavily into AI-assisted development, shipping an MCP Server, Agent Skills and an llms.txt file so coding assistants can read component docs directly, plus a Figma Kit v3 with 1:1 component parity.

On npm the core @heroui/react package now records around 341,000 weekly downloads, the separate heroui-native package adds roughly 11,000 a week, and the GitHub repository sits near 27,700 stars.

Several point releases have landed since 3.0. v3.0.3 upgraded React Aria Components to 1.17.0 and dropped around 90 percent of its transitive dependencies for faster installs, while adding a Typography component. v3.1.0 in late May added Chinese documentation, expanded soft colour tokens, a shared themeable scrollbar system and SSR fixes for useTheme, and v3.2.0 arrived on 16 June 2026 as the current line, with monthly minor releases now the stated cadence.

A long-time NextUI and v2 user writing on Reddit praised the themes page and documentation but lamented that input label animations, prebaked units and autocomplete were "all gone" in v3:

I have just started a new project using v3. The themes page is pretty and the documentation is bang on as usual, but I keep finding things missing which I loved in v2... The choice of animations for labels on inputs, the ability to have units prebaked into them, the autocomplete... all gone.

On GitHub, developers questioned the roadmap and missing pieces such as Navbar, with one noting "there's some lack of transparency of the project timeline for sure."

Teams moving from v2 should plan carefully, because v2 and v3 cannot coexist in the same project. The official migration guide offers both a full migration and an incremental migration path, supported by a dedicated migration MCP server, and some components such as Image have been removed entirely in favour of native elements.

HeroUI is an open-source, production-ready React and React Native component library created by Junior García and backed by Y Combinator, distributed under the Apache 2.0 license with full release notes available on GitHub.

About the Author

BT