Documentation

React Native

The tested capability contract for the beta Motionwind v2 React Native adapter.

React Native in v2

motionwind-react-native is the beta adapter for Reanimated. It shares syntax, configuration, presets, plugins, and diagnostics with the stable web adapters, then maps the supported subset to native styles and event handlers.

import { defineConfig, MotionwindProvider, mw } from "motionwind-react-native";

const config = defineConfig({
  adapter: "react-native",
  strict: true,
  reducedMotion: "user",
});

export default function Card() {
  return (
    <MotionwindProvider config={config}>
      <mw.Pressable className="animate-tap:scale-95 animate-spring">
        <mw.Text>Press me</mw.Text>
      </mw.Pressable>
    </MotionwindProvider>
  );
}

Capability contract

Capability	v2 status	Notes
Initial and enter	Beta	Reanimated timing and spring transitions.
Tap	Beta	Uses `onPressIn` and `onPressOut`; prefer `mw.Pressable`.
Hover and focus	Beta	Work only when the rendered native component/platform emits those handlers.
Named variants	Beta	Includes parent-to-child active-state propagation.
Scroll-linked values	Beta	Descendants consume normalized progress from `mw.ScrollView`.
Reduced motion	Beta	Provider policy and Reanimated's system preference are applied.
Drag	Direct API	Emits `unsupported-native-drag`; integrate Gesture Handler directly.
Layout transitions	Direct API	Emits `unsupported-native-layout`; use Reanimated layout transitions.
In-view classes	Direct API	Emits `unsupported-native-inview`; orchestrate visibility yourself.
SVG and web-only styles	Direct API	Emits `unsupported-native-property`; use native/SVG APIs.
Exit orchestration	Direct API	Exit data can be parsed, but unmount must be coordinated by the application.

Non-animation classes pass through to NativeWind when it is installed. Unsupported animation syntax returns parser diagnostics, and development warnings identify the required direct API.

Timing differences

The shared parser stores Motion durations in seconds. The native adapter converts them to Reanimated milliseconds. It also maps x/y to translateX/translateY and formats rotation values as degree strings.

Continue with Installation, Components, and the API Reference.