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

Note: Since v3.1.0, react-native-edge-to-edge is an optional dependency. We strongly recommend setting edgeToEdgeEnabled=true in your android/gradle.properties — it enforces translucent system bars on modals, disables legacy StatusBar hacks, and enables additional React Native core fixes. Expo SDK 54+ enables this automatically. You can still install react-native-edge-to-edge for ecosystem compatibility with libraries like react-native-bootsplash or react-native-permissions.

Then follow installation guides for your platform.

Documentation

• Start here
• Migration from Unistyles 2.0
• Learn how Unistyles 3.0 works
• API
• Tutorial
• LLMs

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!

Discord

Looking for help or you want to chat with me?

Join Discord

License

MIT