Beautiful, fast and modern React Native UI library
v1.0.0-beta.9
Getting Started
Visit https://v3.heroui.com/docs/native/getting-started/quick-start to get started with HeroUI Native.
Documentation
Visit https://v3.heroui.com/docs/native/getting-started to view the full documentation.
Preview App
Experience HeroUI Native components in action with our preview app! You can explore all components and their variants directly on your device.
Prerequisites
Make sure you have the latest version of Expo Go installed on your mobile device
How to Access
Choose one of the following methods to access the preview app:
Option 1: Scan the QR Code
Use your device's camera or Expo Go app to scan:
Note for Android users: If scanning the QR code with your device's camera or other scanner apps redirects to a browser and shows a 404 error, open Expo Go first and use its built-in QR scanner instead.
Option 2: Click the Link
This will automatically open the app in Expo Go if it's installed on your device.
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:
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.