# heroui-inc/heroui-native

📱Beautiful, fast and modern React Native UI library

Repository: https://github.com/heroui-inc/heroui-native
Canonical: https://ross.abutalabs.com/products/heroui-native
Homepage: https://heroui.com/docs/native/getting-started
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: library, nativewind, react-native, android, design-system, expo, heroui, ios, ui-components
Last push: 2026-08-25T12:51:25+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 95, longevity 32
- inputs: {"age_days": 456, "days_push": 8, "days_rel": 33, "gap_med": 14.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3622, forks 142 (observed 2026-08-28T04:08:11.890613+00:00)

## What it is
HeroUI Native is an open-source React Native UI component library built on Tailwind CSS v4 via Uniwind, offering animated, accessible, and fully customizable components for iOS and Android. It includes a CLI scaffold, an Expo example app, a preview app, theming with CSS variables, and an MCP server for AI-assisted setup.

## Use cases
- build a mobile app UI with React Native components
- add a polished design system to an Expo project
- style React Native components with Tailwind CSS classes
- get accessible and animated mobile UI components out of the box
- scaffold a preconfigured React Native app quickly
- customize a mobile component library's theming and dark mode
- preview UI components on a device before integrating

## When to choose
- you're building a React Native or Expo app and want beautiful, production-ready components with animations and accessibility built in
- you prefer Tailwind CSS utility styling (className) and CSS-variable theming in mobile development
- you want semantic variant APIs, dark mode support, and a Figma design kit to match your code
- you want AI-assisted setup via an MCP server or a zero-config CLI scaffold

## When to avoid
- you're building a web-only app (use HeroUI v3 for web instead)
- you need a component not yet in the library — new components are added only by the core team per the roadmap
- you want full control over low-level component internals or prefer writing all animations yourself
- your project doesn't use or want Tailwind/Uniwind-based styling

## Facets
- artifact type: library
- maturity: active
- function: ui-components, animation, theme, accessibility
- domain: mobile-development, frontend, web-development, cross-platform
- platform: cross-platform
- tags: react-native, expo, nativewind, uniwind, tailwind-css, design-system, component-library, mobile-ui, heroui, dark-mode, figma-kit, ios, android, typescript

## Member repositories
- heroui-inc/heroui-native (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:11.890613+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:31:57.423207+00:00, confidence not recorded.
  - readme: https://github.com/heroui-inc/heroui-native (fetched 2026-08-28T04:08:11.890613+00:00, sha 0fbf4ebd85a3)
  - homepage: https://heroui.com/docs/native/getting-started (fetched 2026-08-29T09:26:47.416693+00:00, sha 2309147fae10)
  - site_page: https://heroui.com/en/docs/native/getting-started/quick-start (fetched 2026-08-29T09:26:47.423214+00:00, sha 788f8df69fe0)
  - site_page: https://heroui.com/en/docs/native/getting-started/design-principles (fetched 2026-08-29T09:26:47.425624+00:00, sha 00dad45b4a84)
  - site_page: https://heroui.com/en/docs/native/getting-started/provider (fetched 2026-08-29T09:26:47.428771+00:00, sha 7cb3074fe2ca)
  - site_page: https://heroui.com/en/docs/native/getting-started/portal (fetched 2026-08-29T09:26:47.431124+00:00, sha 0e700698e6b5)
  - site_page: https://heroui.com/en/docs/native/getting-started/colors (fetched 2026-08-29T09:26:47.433387+00:00, sha 65ce0dcc8286)
  - site_page: https://heroui.com/en/docs/native/getting-started/theming (fetched 2026-08-29T09:26:47.435141+00:00, sha 2f7c61e9a5a9)
  - site_page: https://heroui.com/en/docs/native/getting-started/styling (fetched 2026-08-29T09:26:47.436978+00:00, sha be8bd0fc363d)
  - site_page: https://heroui.com/en/docs/native/getting-started/animation (fetched 2026-08-29T09:26:47.438865+00:00, sha 6b47bc594a63)
- Data as of 2026-08-30T08:39:29.467469+00:00.