migrate-nativewind-to-uniwind

Migrate NativeWind React Native projects to Uniwind with Tailwind 4.

1.7k|46|Updated Jul 29, 2025
One-click install
npx skills add https://github.com/uni-stack/uniwind --skill migrate-nativewind-to-uniwind-uni-stack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-nativewind-to-uniwind
Source: https://github.com/uni-stack/uniwind/tree/main/skills/migrate-nativewind-to-uniwind
Command: npx skills add https://github.com/uni-stack/uniwind --skill migrate-nativewind-to-uniwind-uni-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrating from NativeWind to Uniwind is complex and error-prone without a clear, structured plan. This guide provides a comprehensive migration workflow that minimizes downtime and preserves project stability during the transition.

Core Features & Use Cases

  • Comprehensive upgrade path: removes NativeWind dependencies, migrates Tailwind-driven configurations to CSS-based theming, and aligns Metro/Babel settings for Uniwind.
  • Thorough scope coverage: handles package removal, config migration, Tailwind 4 upgrade, and removal of cssInterop and remapProps usages.
  • Use case: for a React Native project currently using NativeWind, this guide ensures all references, themes, and tooling are migrated cohesively to Uniwind.

Quick Start

Run the migration by removing NativeWind, installing Uniwind and Tailwind 4, and updating the project configuration per the steps above.

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 existing NativeWind dependencies, install Uniwind and Tailwind 4, and update your Metro and Babel configurations to align with the new CSS-based theming structure.

What is the process for upgrading NativeWind to Tailwind 4?

Upgrading NativeWind to Tailwind 4 involves migrating your Tailwind-driven configurations to CSS-based theming, updating your CSS entry points, and replacing any existing cssInterop usage with the withUniwind function.

Can I use Uniwind with my existing Metro and Babel configs?

Yes, but you must update your Metro and Babel configurations during the Uniwind migration to ensure they properly support the new CSS entry points and Tailwind 4 settings instead of the old NativeWind setup.

What do I need to replace when moving from NativeWind to Uniwind?

When moving from NativeWind to Uniwind, you need to replace cssInterop and remapProps usages with withUniwind, remove old dependencies, and migrate your theming structure to CSS-based configurations.

Why is migrating NativeWind to Uniwind complex?

Migrating NativeWind to Uniwind is complex because it requires cohesive updates across package removal, Metro and Babel configuration alignment, Tailwind 4 upgrades, and CSS entry point migration to preserve project stability.

Does Uniwind support CSS-based theming for React Native?

Yes, Uniwind supports CSS-based theming for React Native by replacing the old NativeWind Tailwind-driven configurations, requiring you to migrate CSS entry points and update your project tooling accordingly.