About
Do you like using Tailwind CSS to style your apps? This helps you do that in React Native. Nativewind is not a component library, it's a styling library. If you're looking for component libraries that support Nativewind, see below.
Nativewind makes sure you're using the best style engine for any given platform (e.g. CSS StyleSheet or StyleSheet.create). Its goals are to to provide a consistent styling experience across all platforms, improving developer UX, component performance, and code maintainability.
Nativewind processes your styles during your application's build step and uses a minimal runtime to selectively apply reactive styles (eg changes to device orientation, light dark mode).
Installation
If you have an existing project, use these guides to configure Nativewind for your respective stack.
Alternatively, you can create a new pre-configured project via our Quickstart below.
Quickstart
- Create Expo Stack:
npx rn-new@latest --nativewind
Features
- Works on all RN platforms, uses the best style system for each platform.
- Uses the Tailwind CSS compiler
- Styles are computed at build time
- Small runtime keeps your components fast
- Support for
- Custom CSS properties, aka CSS Variables
- Dark mode, arbitrary classes, and media queries
- Animations and transitions
- Container queries
container-type
and style-based container queries are not supported
- Pseudo classes - hover / focus / active on compatible components
rem
units- Theme functions and nested functions
- React 18 Suspense API
- Custom CSS
- Styling based on parent state modifiers - automatically style children based upon parent pseudo classes
- Support for the
group
andgroup/<name>
syntax
- Support for the
- Children styles - create simple layouts based upon parent class
Contribution
FAQ
When is v5 landing?
Is it safe to use v4?
Yes.
Is Nativewind moving to Expo?
No.
Can we disable auto-adding nativewind types using a setting or something? I already have the settings using compilerOptions.types
, so I would like to disable the file generation.
withNativeWind(<config>, { disableTypeScriptGeneration: true })
What if I'm looking for a component library that uses Nativewind?
There are a number of different component libraries available that use Nativewind to achieve different results. You should pick the one that best suits your needs.
This multi-platform library focuses on achieving native feel for each individual platform using the familiar interface of Tailwind CSS.
This open source library offers universal shadcn/ui via React Native. Use this as a foundation to develop your own high-quality component library.
From the folks that brought you NativeBase, this library offers customizable cross-platform components designed to look & behave cleanly on every platform.
Documentation
Learn more on our website.