migrate-nativewind-to-uniwind

Migrate React Native projects from NativeWind to Uniwind with Tailwind 4.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/bedirhangull/decky-mobile-app --skill migrate-nativewind-to-uniwind
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-nativewind-to-uniwind
Source: https://github.com/bedirhangull/decky-mobile-app/tree/main/.agents/skills/migrate-nativewind-to-uniwind
Command: npx skills add https://github.com/bedirhangull/decky-mobile-app --skill migrate-nativewind-to-uniwind

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrate a React Native project from NativeWind to Uniwind. Use when the user wants to replace NativeWind with Uniwind, upgrade from NativeWind, switch to Uniwind, or mentions NativeWind-to-Uniwind migration. Handles package removal, config migration, Tailwind 4 upgrade, cssInterop removal, theme conversion, and all breaking changes.

Core Features & Use Cases

  • Step-by-step migration guide that removes NativeWind dependencies and updates project configuration.
  • Guidance for replacing babel and metro configurations, updating Tailwind 4, and migrating theming to CSS variables with Uniwind.
  • Clear instructions for migrating Safe Area utilities, CSS entry points, and removing NativeWind-specific tooling to ensure a clean transition.

Quick Start

Follow the step-by-step migration guide to replace NativeWind with Uniwind in your React Native project.

Frequently Asked Questions about migrate-nativewind-to-uniwind

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a React Native project from NativeWind to Uniwind?

To migrate NativeWind to Uniwind, you need to remove NativeWind packages, update your babel and metro configurations, upgrade to Tailwind 4, and replace cssInterop usage. This transition aligns your React Native project with Uniwind's CSS variable theming.

What is the process for replacing NativeWind with Uniwind in a React Native app?

Replacing NativeWind with Uniwind involves uninstalling NativeWind-specific tooling, migrating configuration files, and updating your CSS entry points. You then convert existing themes to CSS variables and remove cssInterop or remapProps usage for full compatibility.

Can I use Tailwind 4 with Uniwind after upgrading from NativeWind?

Yes, migrating NativeWind to Uniwind upgrades your project to Tailwind 4. The migration enforces the removal of NativeWind packages and updates your global styles to ensure compatibility with Tailwind 4 and Uniwind.

How do I handle cssInterop and remapProps removal during a Uniwind migration?

During a Uniwind migration, you must replace cssInterop and remapProps usage with Uniwind-compatible alternatives. The migration process provides clear instructions for removing these NativeWind-specific functions and adjusting component styling.

What configuration changes are required to switch from NativeWind to Uniwind?

Switching from NativeWind to Uniwind requires updating your babel and metro configuration files. You must also migrate your CSS entry points and Safe Area utilities to ensure a clean transition without leftover NativeWind code.