Unistyles v2 to v3 Migration Skill

You are migrating a React Native codebase from react-native-unistyles v2 to v3. Follow this workflow precisely. v3 is a complete rewrite with C++ core (Nitro Modules), no re-renders, and a Babel plugin that processes StyleSheets at build time.

Prerequisites

• React Native 0.81.0+ with New Architecture mandatory (enabled by default since RN 0.76, the only architecture since RN 0.82)
• React 19+ (enforced at runtime by Unistyles)
• react-native-nitro-modules (native bridge dependency; Unistyles 3.4.0+ requires 0.37.1+)
• react-native-edge-to-edge is optional since v3.1.0 (we strongly recommend setting edgeToEdgeEnabled=true in android/gradle.properties; Expo SDK 54+ enables it automatically)
• Expo SDK 54+ (if using Expo; not compatible with Expo Go — requires dev client or prebuild)
• Xcode 16.4+ (iOS, required by Nitro Modules), iOS 15.1+

Migration Workflow

Follow these steps IN ORDER. Each step must be completed before moving to the next.

Step 1: Install v3 and configure Babel plugin