

Requirements
- React Native 0.81+ with the New Architecture
- React 19+
- Expo SDK 54+ (if you use Expo, development builds only, Expo Go is not supported)
Need support for older React Native versions or the Old Architecture? Use Unistyles 2.0.
Installation
yarn add react-native-unistyles react-native-nitro-modules
| react-native-unistyles | Minimum react-native-nitro-modules |
|---|
| >= 3.0.0 | >= 0.33.9 |
| >= 3.1.0 | >= 0.35.0 |
| >= 3.2.0 | >= 0.35.2 |
| >= 3.3.0 | >= 0.36.1 |
| >= 3.4.0 | >= 0.37.1 |
Note: You don't need react-native-edge-to-edge (optional since v3.1.0, now deprecated). We strongly recommend setting edgeToEdgeEnabled=true in your android/gradle.properties instead — it enforces translucent system bars on modals, disables legacy StatusBar hacks, and enables additional React Native core fixes. Expo SDK 54+ enables this automatically.
Then follow installation guides for your platform.
AI agent skills
This repository ships skills for AI coding agents (Claude Code, Codex, Cursor and others):
react-native-unistyles-v3 - setup, theming, responsive styles, variants, web and 3rd party integrations
unistyles-v2-to-v3-migration - step by step migration from Unistyles 2.0
npx skills add jpudysz/react-native-unistyles
Features
- 🚀 Shared core with C++ and JSI bindings
- 🏎️ Powered by Nitro Modules
- 🦸🏼♂️ No re-renders
- 🦄 Custom web parser, classes and pseudo classes
- ⚛️ Tightly integrated with Fabric and Shadow Tree
- 🔥 Crazy performance, adds under 0.1 ms to your StyleSheet
- 🎳 Share up to 100% of your styles across platforms in monorepo
- 🎯 Doesn't introduce new components, your view hierarchy is always clean
- 🎨 Register multiple themes and change them with single function call
- and much much more!
Sponsors




Past sponsors




























Sponsor my work
How to become a sponsor?
If you found the react-native-unistyles time-saving and valuable, please consider sponsoring my work. Your support enables me to continue creating libraries with a fresh approach.
Github: https://github.com/sponsors/jpudysz
Ko-fi: https://ko-fi.com/jpudysz
Your support is greatly appreciated and helps me dedicate more time and resources to creating quality libraries. Thank you for all the support!
Contributing
The repository uses a git submodule (unifiber). Clone it with git clone --recurse-submodules, or run git submodule update --init in an existing clone.
License
MIT