HeroUI (formerly NextUI)

repository·v3·Indexed 12 days ago

https://github.com/heroui-inc/heroui

A production-ready React component library combining React Aria's accessibility with Tailwind CSS v4 styling. It features a compound component API, native AI-assistant integration via MCP and llms.txt, and a framework-agnostic styles package (@heroui/styles). Designed for modern React and Next.js applications, it provides WCAG-compliant components without requiring a provider wrapper.

Tokens
637.2K
Snippets
1.8K
Records
2.6K
Agent score
97%

What's inside HeroUI

  1. Overview of HeroUI packages

    v3

    HeroUI provides different ways to consume its components depending on your needs:

    • @heroui/react: The full component bundle containing all components.
    • @heroui/styles: Contains only the styles and theme definitions.
    • Individual packages: You can import specific components (e.g., @heroui/button, @heroui/modal) to ensure your bundle is tree-shakeable and lightweight.
  2. What is included in HeroUI Native Agent Skills

    v3

    The HeroUI Native Agent Skills package provides the following knowledge to your AI assistant:

    • HeroUI Native installation guide
    • Component Knowledge: All HeroUI Native components including their props, usage patterns, and examples.
    • Theming and Styling: Guidelines for using Uniwind for styling and theming.
    • Design Principles: Composition patterns and design principles for mobile development.
  3. Introduction to HeroUI

    v3

    HeroUI is an open-source React component library designed for building beautiful, accessible user interfaces. It is built on top of Tailwind CSS v4 and React Aria Components, ensuring high-quality animations, polished details, and built-in accessibility (focus management, keyboard navigation, and screen reader support) out of the box.

    Key Features

    • Accessibility: Built with React Aria Components to meet WCAG standards.
    • Customizability: Components are composed of customizable parts (slots), allowing for deep customization via Tailwind utility classes, CSS variables, or BEM modifiers.
    • Developer Experience: Fully typed APIs with excellent IDE autocompletion and support for React 19.
    • Performance: Supports Tree Shaking to ensure only the components you use are included in your final bundle.
    • License: Distributed under the Apache License 2.0.
  4. Overview of HeroUI features and architecture

    v3

    HeroUI is a modern React UI component library designed for React 19 and Next.js App Router. It combines accessibility, styling flexibility, and AI-ready tooling.

    Core Architecture

    • Accessibility-first: Built on React Aria primitives, ensuring robust screen reader support, keyboard navigation, and ARIA compliance out of the box.
    • Tailwind CSS v4 Native: Uses a CSS-based theming system with @theme and design tokens, avoiding the runtime overhead associated with CSS-in-JS.
    • Compound Component API: Employs a composable pattern (e.g., Card.Header, Table.Column, Modal.Body) to provide full control over markup and layout.
    • Server Component Friendly: Designed with React Server Components (RSC) in mind, featuring minimal and clearly documented client boundaries.

    AI Tooling Support

    HeroUI provides specialized resources to help AI coding assistants work with its APIs accurately:

    • MCP Server: For Model Context Protocol integration.
    • llms.txt: For providing context to Large Language Models.
    • Agent Skills: Specialized instructions for AI agents.
  5. Introduction to HeroUI Native

    v3

    HeroUI Native is an open-source React Native UI component library designed for building beautiful and accessible mobile interfaces. It is built on top of Tailwind v4 and Uniwind, making it compatible with modern mobile technology stacks like Expo.

    Key Features

    • Beautiful by Default: Professional aesthetics out of the box.
    • Accessibility First: Built-in focus management, touch accessibility, and screen reader support following mobile best practices.
    • Highly Composable: Components are made of replaceable sub-parts, allowing for deep customization without breaking core logic.
    • Developer Friendly: Fully typed APIs with excellent IDE autocomplete support.
    • Lightweight: Supports tree-shaking to ensure only the components you actually use are included in your bundle.
    • AI-Friendly: APIs are designed to be easily used with AI-assisted development and code generation.

    Ecosystem

    • HeroUI v3 (Web): React components based on Tailwind CSS v4.
    • HeroUI Native (Mobile): Aesthetic components for React Native.
    • HeroUI Chat: A platform for creating applications using natural language.
    • LLM-oriented UI: Upcoming platforms and MCP (Model Context Protocol) support.
  6. Overview of the HeroUI Ecosystem

    v3

    HeroUI provides a multi-platform design system ecosystem:

    • HeroUI (Base): The core open-source React component library.
    • HeroUI Pro: A paid extension providing app-level infrastructure such as AppLayout, Sidebar, Navbar, complex DataGrid tables, dashboard metrics (KPI, TrendChip), and data visualization (LineChart, BarChart).
    • HeroUI Native: A React Native implementation that shares the same design tokens, compound component API, and accessibility standards as the web version, allowing for true cross-platform design consistency.
    • Figma Kit: A design tool resource to keep Figma designs in sync with the React implementation.
    • Storybook: A visual documentation tool to explore all component variants, states, and compositions.
  7. Compare HeroUI and Chakra UI for React projects

    v3

    When choosing between HeroUI and Chakra UI in 2026, consider these core architectural differences:

    FeatureHeroUI v3
    StylingTailwind CSS v4 (static CSS)
    AccessibilityReact Aria (Adobe)
    Component APICompound components + className
    CSS outputStatic CSS from Tailwind and HeroUI styles
    ThemingCSS custom properties + @theme
    Server componentsStatic pieces can stay server-rendered; interactive pieces use client boundaries
    FeatureChakra UI v3
    StylingPanda CSS API-based styling system and style props
    AccessibilityArk UI / Zag.js (Chakra team)
    Component APIStyle props on components
    CSS outputRuntime styling in the stable Chakra setup
    ThemingTheme tokens + semantic tokens
    Server componentsDepends on component and styling usage
  8. Explore the HeroUI Ecosystem

    v3

    HeroUI provides several specialized tools and products to extend its capabilities:

    • HeroUI Pro: A paid offering providing application-level components and templates (e.g., AppLayout, Sidebar, DataGrid, LineChart, and dashboard templates).
    • HeroUI Native: A solution for cross-platform development that brings the same design tokens, composite component APIs, and accessibility standards to React Native using native APIs instead of WebViews.
    • Figma Kit: A design tool kit that ensures design and code remain synchronized.
    • Storybook: A visual library of all component variants and states for testing and documentation.
    • AI Tools: Includes an MCP server and llms.txt for integration with AI coding assistants.
  9. Compare HeroUI and Mantine component libraries

    v3

    HeroUI and Mantine are both React component libraries with different philosophies:

    • HeroUI v3: Focuses on a deep, accessible component set using React Aria, styled with Tailwind CSS v4, and utilizes a compound component API. It is designed for high-compliance environments (WCAG) and features first-party AI tooling (MCP, llms.txt).
    • Mantine v8: A 'batteries-included' toolkit with a very broad catalog (120+ components, 70+ hooks). It uses CSS Modules/PostCSS for styling and includes built-in utilities like @mantine/form and @mantine/hooks.
    FeatureHeroUI v3Mantine v8
    ComponentsBroad focused set120+ components
    StylingTailwind CSS v4 (CSS-first)CSS files / CSS Modules + PostCSS
    AccessibilityReact Aria (Adobe)Built into Mantine components
    Hooks libraryNone (use React Aria hooks)70+ hooks
    Component APICompound componentsFlat components with props
    AI toolingMCP, llms.txt, agent skillsMCP, llms.txt, skills
    Form handlingWorks with any libraryBuilt-in @mantine/form
    CSS runtimeZeroZero
    ThemingCSS custom properties + @themeCSS variables + MantineProvider
  10. Compare React Dashboard Templates and Frameworks (2026)

    v3

    When choosing a dashboard solution for React, consider the following categories:

    TypeOptionsBest Use Case
    Template + Pro ComponentsHeroUI ProNative HeroUI app shells, KPI widgets, and data grids.
    Dashboard UI ResourcesTremorTailwind v4-based analytics blocks and visualization.
    Data-driven FrameworksRefine, AdminJS, React AdminAutomating CRUD/admin panels from data models or APIs.
    Ecosystem-basedAnt Design ProDeep integration with Ant Design and ProComponents.
    Cross-frameworkCoreUIMaintaining design consistency across React, Vue, and Angular.
    MUI-basedMaterial Dashboard, Berry, MantisLeveraging the Material UI ecosystem.
  11. Why choose HeroUI for your design system

    v3

    HeroUI is a React component library designed for enterprise-grade applications, focusing on accessibility, performance, and AI-native development. It is built on the following core pillars:

    • Accessibility: Powered by React Aria (Adobe), providing industry-leading WCAG compliance, including platform-aware keyboard navigation, screen reader support, touch interactions, and internationalization.
    • Styling: Native support for Tailwind CSS v4, utilizing zero-runtime CSS and design tokens defined via standard CSS @theme directives.
    • API Pattern: Uses a Compound Component API (e.g., Card.Header, Modal.Body) to provide structural control and prevent prop explosion.
    • AI-Native Support: Includes specialized tools like MCP servers, llms.txt, Agent Skills, and AGENTS.md to ensure AI coding assistants (like Cursor or Claude Code) generate accurate, up-to-date code using the correct component structures and imports.
  12. Browse all HeroUI Native components

    v3

    HeroUI Native provides a comprehensive set of components organized into several functional categories. You can explore the available components by category to find the right building blocks for your application. The current categories include:

    • Buttons (按钮)
    • Collections (集合)
    • Controls (控件)
    • Forms (表单)
    • Navigation (导航)
    • Overlays (浮层)
    • Feedback (反馈)
    • Layout (布局)
    • Media (媒体)
    • Data Display (数据展示)
    • Utilities (工具)

    Note that more components are continuously being added to the library.