uni-stack avatar

Migrate Nativewind To Uniwind

This handles the full NativeWind to Uniwind migration, which is messier than it looks. It removes the old packages (including react-native-css-interop, which people constantly miss), converts your Tailwind 3 config to Tailwind 4's CSS-based theme system, replaces all cssInterop calls with withUniwind wrappers, and updates your Metro and Babel configs. The skill is thorough about the breaking changes, like ensuring your metro config uses relative paths for cssEntryFile and setting rem polyfills to 14 to match NativeWind's defaults. Most helpful if you're dealing with a codebase that has custom theme extensions or lots of third-party components wrapped with cssInterop, since that's where migrations usually break.

skills.sh installs
2K
GitHub stars
1.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add uni-stack/uniwind --skill migrate-nativewind-to-uniwind --agent claude-code

Installs into .claude/skills of the current project.

Files

Migrate NativeWind to Uniwind

Uniwind replaces NativeWind with better performance and stability. It requires Tailwind CSS 4 and uses CSS-based theming instead of JS config.

Pre-Migration Checklist

Before starting, read the project's existing config files to understand the current setup:

  • package.json (NativeWind version, dependencies)
  • tailwind.config.js / tailwind.config.ts
  • metro.config.js
  • babel.config.js
  • global.css or equivalent CSS entry file
  • nativewind-env.d.ts or nativewind.d.ts
  • Any file using cssInterop or remapProps from nativewind
  • Any file importing from react-native-css-interop
  • Any ThemeProvider from NativeWind (vars() usage)

Step 1: Remove NativeWind and Related Packages

Uninstall ALL of these packages (if present):

npm uninstall nativewind react-native-css-interop
# or
yarn remove nativewind react-native-css-interop
# or
bun remove nativewind react-native-css-interop

Sponsors

Details

Repository
github.com/uni-stack/uniwind
Categories
Frontend Development, Marketing & SEO

More from uni-stack/uniwind

All 2
1enzed avatarr3f-lightingenzed/r3f-skillsReact Three Fiber lighting - light types, shadows, Environment component, IBL. Use when adding lights, configuring shadows, setting up environment lighting, or 2Kskills.sh installs
2unclecatvn avatarodoo-19unclecatvn/agent-skillsOdoo 19 development knowledge base with 18 specialized guides covering Actions (ir.actions.*, cron jobs, server actions), Controllers (HTTP routing, endpoints, 2Kskills.sh installs
3yamadashy avatarrepomix-exploreryamadashy/repomixAnalyze or explore a codebase (remote or local repository) by packing it with the Repomix CLI, then reading and searching the generated output. Use when the use2Kskills.sh installs
4minimax-ai avatarflutter-devminimax-ai/skillsFlutter cross-platform development guide covering widget patterns, Riverpod/Bloc state management, GoRouter navigation, performance optimization, and platform-s2Kskills.sh installs
5supabase avatarvercel-composition-patternssupabase/supabaseReact composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reus1.9Kskills.sh installs
6millionco avatarexpectmillionco/expectUse when editing .tsx/.jsx/.css/.html, React components, pages, routes, forms, styles, or layouts. Also when asked to test, verify, validate, QA, find bugs, che1.9Kskills.sh installs