Last updated on October 2, 2025
withNativeWind
withNativeWind is a higher order component that updates your Metro configuration to support NativeWind.
The only required option is input, which is the relative path to your .css file.
Options
output: The relative path to the output file. Defaults to<projectRoot>/node_modules/.cache/nativewind/projectRoot: Abolsute path to your project root. Only used to setoutputinlineRem: The numeric value used to inline the value ofremunits on native.falsewill disable the behaviour. Defaults to14. More informationconfigPath: Relative path to yourtailwind.configfile. Defaults totailwind.config. Recommended you use@configinstead of this option.hotServerOptions: Options to pass to the hot server. Defaults to{ port: 8089 }
Experimental Options
These options are available under the experiments key.
inlineAnimations: Usereact-native-reanimated's inline shared values instead of hooks. This greatly improves performance, but has issues with fast-refresh