- React Native 0.85+ with the New Architecture
- React 19+
- Expo SDK 56+ (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.
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 settingedgeToEdgeEnabled=truein yourandroid/gradle.propertiesinstead — 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.
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 integrationsunistyles-v2-to-v3-migration- step by step migration from Unistyles 2.0
npx skills add jpudysz/react-native-unistyles- 🚀 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!
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!
The repository uses a git submodule (unifiber). Clone it with git clone --recurse-submodules, or run git submodule update --init in an existing clone.
MIT