migrate-nativewind-to-uniwind

The migrate-nativewind-to-uniwind skill is a step-by-step migration guide for moving a React Native project from NativeWind to Uniwind, a styling library the skill positions as offering better performance and stability. It solves the friction of a breaking migration that requires Tailwind CSS 4 and switches from JS-config theming to CSS-based theming, walking through package removal, config migration, cssInterop removal, theme conversion, and other breaking changes so nothing is silently missed.

The workflow is a single detailed SKILL.md with a pre-migration checklist and numbered steps. It has the user audit existing config (package.json, tailwind.config, metro.config, babel.config, global.css, type definitions, and cssInterop/remapProps usage), then uninstall nativewind and its commonly missed react-native-css-interop dependency, install uniwind and Tailwind 4, update the Babel and Metro configs (with withUniwindConfig as the outermost wrapper and a relative cssEntryFile path), convert global.css to Tailwind 4 imports, fix the CSS entry import location, delete NativeWind type definitions and tailwind.config, migrate theme values to Tailwind 4's @theme directive, and replace every cssInterop/remapProps call with Uniwind's withUniwind wrapper defined at module level. It highlights common pitfalls such as the missed react-native-css-interop dependency, path.resolve misuse for cssEntryFile, and setting polyfills.rem to 14 to preserve spacing. The operations it recommends, ripgrep searches, npm/yarn/bun add and remove, and deleting migration-obsolete config files, are all standard, scoped development actions.

Target users are React Native developers with existing NativeWind projects who want to switch to Uniwind. It is benign developer tooling that only touches project dependencies and config within the project directory.