hub / github.com/heroui-inc/heroui-native

github.com/heroui-inc/heroui-native @v1.0.5 sqlite

repository ↗ · DeepWiki ↗ · release v1.0.5 ↗

1,121 symbols 3,278 edges 594 files 71 documented · 6%

README

Beautiful, fast and modern React Native UI library

v1.0.4

Getting Started

Visit https://heroui.com/docs/native/getting-started/quick-start to get started with HeroUI Native.

Documentation

Visit https://heroui.com/docs/native/getting-started to view the full documentation.

Preview App

Experience HeroUI Native components in action with our official preview app! You can explore all components and their variants directly on your device.

Download

iOS: Download on the App Store
Android: Coming soon to Google Play

Quick Start with Example App

Want to start building with HeroUI Native immediately? We provide a standalone example app that's fully configured and ready to use:

🚀 HeroUI Native Example App

This repository contains a pre-configured React Native app with HeroUI Native already set up, including:

All necessary dependencies installed
Uniwind configuration ready
Example components showcasing best practices
Perfect for quickly prototyping or starting a new project

Simply clone, install, and start building!

Changelog

See CHANGELOG.md for a history of changes to this library.

Roadmap

See Roadmap to see what we're working on.

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! We appreciate your help in making HeroUI Native better.

How to Contribute

Bug Fixes: Check our GitHub Issues for bugs that need fixing
New Components: Only core team can add new components. Check our Roadmap to see what's planned
Feature Proposals: Start a discussion in GitHub Discussions before implementing

Important: Please do not add new components or variants, change existing designs, or modify component behavior without prior discussion. We follow a strict design system based on our Figma designs and roadmap.

For detailed guidelines, see CONTRIBUTING.md.

Please adhere to this project's CODE_OF_CONDUCT.

License

Apache License 2.0

Extension points exported contracts — how you extend this code

AppInfoFromStore (Interface)

Shape returned by both store-lookup helpers

example/src/helpers/utils/version-check.ts

SliderProps (Interface)

* Props for the Slider root component. * Extends the primitive Root props with visual styling. * * Value-related prop

src/components/slider/slider.types.ts

ForceMountable (Interface)

* Interface for components that can be force mounted even when normally hidden

src/helpers/internal/types/primitives.ts

ISubMenuContext (Interface)

* Internal context interface for managing sub-menu state. * Provides open state, toggle callback, and a unique identifi

src/primitives/sub-menu/sub-menu.types.ts

GlobalAnimationSettingsProviderProps (Interface)

(no doc)

src/providers/animation-settings/types.ts

UniwindConfig (Interface)

(no doc)

example/src/uniwind.d.ts

SliderOutputProps (Interface)

* Props for the Slider.Output sub-component. * Displays the current slider value as formatted text.

src/components/slider/slider.types.ts

Insets (Interface)

* Interface for defining spacing/padding from screen edges

src/helpers/internal/types/primitives.ts

Core symbols most depended-on inside this repo

called by 147

src/helpers/external/utils/cn.ts

called by 86

src/helpers/external/utils/cn.ts

getAnimationValueProperty

called by 70

src/helpers/internal/utils/animation.ts

useThemeColor

called by 64

src/helpers/external/hooks/use-theme-color.ts

createContext

called by 62

src/helpers/internal/utils/create-context.ts

combineStyles

called by 42

src/primitives/slot/utils.ts

clamp100

called by 41

src/helpers/external/utils/color-kit/index.ts

clampRGB

called by 39

src/helpers/external/utils/color-kit/index.ts

Shape

Function 811

Interface 310

Languages

TypeScript100%

Modules by API surface

src/helpers/external/utils/color-kit/index.ts106 symbols

src/components/select/select.types.ts17 symbols

src/components/menu/menu.types.ts17 symbols

example/src/app/(home)/components/tag-group.tsx15 symbols

example/src/app/(home)/components/control-field.tsx14 symbols

example/src/app/(home)/components/toast.tsx13 symbols

src/components/popover/popover.types.ts12 symbols

example/src/app/(home)/components/tabs.tsx11 symbols

example/src/app/(home)/components/input-otp.tsx11 symbols

example/src/app/(home)/components/accordion.tsx11 symbols

src/providers/toast/types.ts10 symbols

src/helpers/internal/hooks/use-relative-position.ts10 symbols

Dependencies from manifests, versioned

@babel/core7.29.0 · 1×

@commitlint/config-conventional19.6.0 · 1×

@eslint/compat1.2.7 · 1×

@eslint/eslintrc3.3.0 · 1×

@eslint/js9.22.0 · 1×

@evilmartians/lefthook1.5.0 · 1×

@expo-google-fonts/inter0.4.1 · 1×

@expo-google-fonts/saira0.4.2 · 1×

@expo-google-fonts/sn-pro0.4.0 · 1×

@expo-google-fonts/space-grotesk0.4.1 · 1×

@expo/metro-runtime57.0.2 · 1×

@expo/vector-icons15.1.1 · 1×

For agents

$ claude mcp add heroui-native \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact