heroui README

The project's README from github.com/heroui-inc/heroui. As one markdown file: README.md.

HeroUI v3 logo

License npm downloads

Why HeroUI?

HeroUI (previously NextUI) is a production-ready React component library that combines the accessibility rigor of React Aria with the utility-first styling of Tailwind CSS v4. It ships a clean compound component API (Card.Header, Card.Content, Select.Item, …), requires no <Provider> wrapper, and works out of the box with React 19 and Next.js.

Packages

Package Description
@heroui/react Full component bundle
@heroui/styles Styles / theme only
Individual packages e.g. @heroui/button, @heroui/modal — tree-shakeable per-component imports

Getting Started

Visit heroui.com/docs/react/getting-started/quick-start to get started with HeroUI.

npm install @heroui/react

Who Is This For?

HeroUI is a good fit if you are building:

AI-Powered Development

HeroUI is built for the AI-assisted development workflow.

Tool What it does
MCP Server (@heroui/react-mcp) Components that understand your theme — install the server in Cursor, Claude Code, Windsurf, or any MCP-compatible editor
llms.txt Available at heroui.com/llms.txt — structured context for LLMs about every component
Agent Skills Run npx heroui-cli agents-md to install skills for Cursor, Claude Code, and more

Works with Cursor, Claude Code, Windsurf, GitHub Copilot, and any tool that supports MCP or llms.txt.

Compared To

Library How HeroUI differs
shadcn/ui HeroUI is batteries-included with a consistent design system; shadcn is copy-paste-customize
MUI HeroUI is lighter, Tailwind-native, no CSS-in-JS runtime overhead
Chakra UI HeroUI uses React Aria (stronger a11y primitives) and Tailwind v4 (better perf)
Mantine HeroUI has AI tooling (MCP, llms.txt), Tailwind-first styling

Documentation

Storybook

Visit storybook-v3.heroui.com to view the storybook for all components.

Roadmap

Visit herouiv3.featurebase.app/roadmap to view the roadmap for HeroUI v3.

Figma

Visit the HeroUI Figma Kit (v3) to view the design kit.

Community

We're excited to see the community adopt HeroUI, raise issues, and provide feedback. Whether it's a feature request, bug report, or a project to showcase, please get involved!

Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

Please adhere to this project's CODE_OF_CONDUCT.

License

MIT

heroui (heroui-inc/heroui)

Searching Database…

31K ·GitHub
Что это такое?HeroUI (ранее NextUI) — готовая к использованию в продакшене библиотека компонентов для React, которая сочетает примитивы доступности из React Aria со стилизацией на Tailwind CSS v4.
Это UI-библиотека или полноценный фреймворк?Это набор компонентов, который вы встраиваете в своё приложение на React или Next.js, а не самостоятельный фреймворк. Он предоставляет составной API компонентов (например, Card.Header, Select.Item) и не требует оборачивать приложение в дополнительный Provider.
Как добавить это в проект?Следуйте руководству по быстрому старту на heroui.com/docs. Можно установить полный набор через пакет @heroui/react или подключить отдельные пакеты, например @heroui/button или @heroui/modal, которые позволяют подключать только нужное.
Нужно ли заранее настраивать Tailwind CSS?Да, стилизация HeroUI построена на Tailwind CSS v4, а не на среде выполнения CSS-in-JS, и она рассчитана на работу с React 19 и Next.js из коробки.
Это тот же проект, что и NextUI?Да, HeroUI — переименованное продолжение NextUI, поэтому существующие приложения и документация NextUI напрямую соответствуют ему. Обратите внимание, что документация v2 и v3 находится на разных сайтах: v2.heroui.com и heroui.com.
Для каких приложений предназначен HeroUI?SaaS-приложения, дашборды и админ-панели, витрины интернет-магазинов и маркетинговые сайты — по сути, любой проект на React или Next.js, которому нужен доступный и продуманный интерфейс.
Какие инструменты для разработки с использованием ИИ входят в состав?HeroUI поставляется с MCP-сервером (@heroui/react-mcp) для редакторов вроде Cursor, Claude Code и Windsurf, структурированным файлом llms.txt по адресу heroui.com/llms.txt и устанавливаемыми навыками для агентов через npx heroui-cli agents-md.
Чем это отличается от shadcn/ui или MUI?В отличие от подхода shadcn, где компоненты копируются в проект и затем настраиваются, HeroUI поставляется со всем необходимым и единой дизайн-системой. По сравнению с MUI она легче, построена на Tailwind и не несёт накладных расходов от среды выполнения CSS-in-JS.
Можно ли подключить только один компонент, а не всю библиотеку?Да, помимо полного пакета @heroui/react, каждый компонент также публикуется как отдельный пакет, который можно подключать по отдельности (например, @heroui/button, @heroui/modal).
Есть ли набор для дизайна или демо, чтобы посмотреть компоненты?Да: для v3 доступен Figma Kit, а со всеми компонентами можно ознакомиться в Storybook по адресу storybook-v3.heroui.com.
Creator
heroui-inc
Size
110.4 MB
Stars
31K
Age
5y
Commits · 90 Days