Nitrowind Documentation
Explore Nitrowind documentation for React Native Tailwind CSS v4 setup, theming, components, native features, APIs, and the C++ ShadowTree engine.
Nitrowind
Open-source Tailwind v4 bindings for React Native, powered by a native C++ ShadowTree engine that updates theme, color-scheme, safe-area, container, and group-state styles without putting React back on the render path.
Install Nitrowind, configure Metro, create global CSS, and render your first className.
PackagePlain CSSUse the native nitrocss engine directly when you do not want Tailwind.
FeaturesStates and groupsUse active, focus, hover, disabled, and group-state variants in React Native.
ReferenceRuntime APIProviders, hooks, style registration, runtime snapshots, and low-level helpers.
It is built as two packages:
| Package | Use it when |
|---|---|
nitrowind | You want Tailwind v4 utilities, platform variants, safe-area utilities, animation helpers, and the full className workflow. |
nitrocss | You want the native CSS engine directly with plain CSS classes and no Tailwind requirement. |
The engine compiles styles at build time, links rendered Fabric nodes to a native C++ resolver, and updates affected native props when runtime state changes. Theme switches, dark mode, dimensions, safe-area insets, RTL, font scale, group state, and container size changes can be recomputed without asking React to re-render your tree.
What you get
- Tailwind v4 utilities in React Native via
className. - A native C++ ShadowTree engine for steady-state style updates.
- A plain-CSS path through
nitrocss. - Platform variants like
ios:,android:,web:,native:,macos:, andwindows:. - Dark mode, themes, responsive styles, safe-area utilities, pseudo states, group variants, and container queries.
- Styled React Native primitives, scrollables, SVG primitives, and wrappers for third-party components.
- Optional Reanimated helpers for entering, exiting, layout, and CSS-keyframe style animations.
Requirements
Nitrowind supports React Native 0.85 through 0.87 and Nitro Modules 0.37 with the new architecture, Fabric, and bridgeless runtime.
The native engine is autolinked through nitrocss. Web, tests, and environments without the native module use the JS fallback resolver.
Docs map
Start with Installation, then read How It Works. If you are coming from NativeWind or Uniwind, the closest pages are Migration, States and Groups, Responsive and Containers, and cssInterop.