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.78.0+ with New Architecture mandatory (enabled by default from RN 0.83+)
• React 19+ (enforced at runtime by Unistyles)
• react-native-nitro-modules (native bridge dependency)
• react-native-edge-to-edge (required for Android edge-to-edge insets)
• Expo SDK 53+ (if using Expo; not compatible with Expo Go — requires dev client or prebuild)
• Xcode 16+ (iOS)

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