heroui-native-pro
v1.0.0-beta.3
Published
HeroUI React Native
Readme
HeroUI Native Pro is a premium extension of HeroUI Native OSS — production-ready, fully composable React Native components that follow the same patterns you already know from HeroUI Native OSS. New components and fixes ship regularly as package updates.
For web (46+ components, templates, Theme Builder, and the full Pro suite), see @heroui-pro/react and the HeroUI Pro introduction.
What’s included
- React Native components — Calendar, DatePicker, DateRangePicker, Stepper, SlideButton, ProgressButton, SocialAuthButton, NumberField, NumberStepper, RadioButtonGroup, and more — each with full documentation
- Same design system — Built on the same Uniwind + Tailwind CSS v4 theming, color tokens, and styling patterns as HeroUI Native OSS
- Smooth animations — Built on react-native-reanimated with a unified
animationprop - Figma — Design files for all Pro components
- AI tooling — MCP server, agent skills, and design taste for AI-assisted development
- Priority support — Fast support, prioritized issues, private Discord, and a VIP badge
Requirements
- Bare React Native or Expo
- Tailwind CSS v4 via Uniwind
- HeroUI Native OSS (
heroui-native)
If you have not set up HeroUI Native OSS yet, follow the HeroUI Native quick start first.
Installation
1. Log in
npx heroui-pro loginYou can use bunx heroui-pro login or pnpm heroui-pro login instead.
2. Install
npx heroui-pro installThe CLI adds heroui-native-pro (and heroui-pro as needed), downloads Pro artifacts, installs missing peer dependencies (for example @internationalized/date for date components), and can configure pnpm / bun so postinstall scripts stay trusted.
Run npx heroui-pro with no arguments for the interactive menu.
3. Point Tailwind at Pro sources
In global.css, add a @source entry for Pro (paths are relative to that file):
@import 'tailwindcss';
@import 'uniwind';
@import 'heroui-native/styles';
@source './node_modules/heroui-native/lib';
@source './node_modules/heroui-native-pro/lib';Adjust the @source paths if global.css is not at the project root.
4. CI / automated installs
For GitHub Actions, EAS, and similar, set HEROUI_AUTH_TOKEN from a CI/CD token in the HeroUI dashboard. With that env var set, installs can download Pro artifacts without interactive login.
See the full guide: Installation.
CLI (quick reference)
| Command | Description |
| ------------------------------ | ----------------------------------------------- |
| heroui-pro login | Log in with GitHub |
| heroui-pro install | Add Pro packages, peers, and PM config |
| heroui-pro install --yes | Non-interactive install |
| heroui-pro install --dry-run | Preview installs |
| heroui-pro status | Login and installed products |
| heroui-pro logout | Sign out |
| heroui-pro docs | Open heroui.pro/docs |
Next steps
- Installation & troubleshooting
- Browse components
- Agent skills
- Provider — configure the HeroUI Native provider
License
See LICENSE.
