migrate-to-v5

Upgrade gluestack-ui projects from v2/v3/v4 to v5 via CLI and manual steps.

1|Updated Mar 25, 2025
One-click install
npx skills add https://github.com/jeius/LactaLink --skill migrate-to-v5
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-to-v5
Source: https://github.com/jeius/LactaLink/tree/main/.agents/skills/gluestack-ui-v4/migrate-to-v5
Command: npx skills add https://github.com/jeius/LactaLink --skill migrate-to-v5

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrating gluestack-ui projects to v5, across NativeWind and UniWind, is automated and standardized to reduce manual toil and errors.

Core Features & Use Cases

  • Automated CLI upgrade detection and execution for v2/v3/v4 to v5.
  • Step-by-step manual migration paths for sources not yet supported by automation.
  • Platform-specific configuration rewrites for NativeWind v5 and UniWind, including package updates, metro/build changes, and provider re-addition.

Quick Start

Run the upgrade wizard to migrate your project to gluestack-ui v5 using the appropriate engine path.

Frequently Asked Questions about migrate-to-v5

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

FAQPage Schema
How do I migrate a gluestack-ui project to v5?

To migrate a gluestack-ui project to v5, run the automated CLI upgrade wizard to detect your current version and execute the transition. It covers package changes, config rewrites, and platform-specific adjustments for NativeWind v5 and UniWind.

Can I upgrade gluestack-ui from v2 or v3 directly to v5?

Yes, you can upgrade gluestack-ui from v2, v3, or v4 directly to v5. The upgrade wizard supports automated detection and execution for these older versions, while providing step-by-step manual migration paths for sources not yet supported by automation.

What manual steps are required for a NativeWind v5 migration?

Manual steps for a NativeWind v5 migration include platform-specific configuration rewrites, package updates, metro/build changes, and provider re-addition. The process enforces safe practices and provides step-by-step guidance for sources not supported by automated CLI upgrades.

Does the gluestack-ui v5 upgrade support UniWind platform adjustments?

Yes, the gluestack-ui v5 upgrade supports UniWind platform adjustments. It handles platform-specific configuration rewrites, package updates, and tooling updates required to align your project with UniWind and NativeWind v5 standards.

What post-migration checks are needed after upgrading gluestack-ui?

After upgrading gluestack-ui, you must perform post-migration checks to verify that platform-specific adjustments for NativeWind v5 and UniWind are correctly applied. The skill enforces safe practices and notes prerequisites to ensure a seamless transition.

Why is my automated CLI upgrade not working for gluestack-ui?

Automated CLI upgrades for gluestack-ui may not work if your source version or configuration is not yet supported by automation. In these cases, you must follow the provided step-by-step manual migration paths to complete the v5 transition safely.