Introduction

Welcome to the migration guide for Gluestack-UI v2. This document will guide you through the process of upgrading from v1 to v2. It covers breaking changes, new features, improvements, deprecated features, installation steps, and dependencies. Please read through this guide carefully to ensure a smooth transition.

Table of Contents

1. Installation
2. Dependencies
3. Breaking Changes
4. New Features
5. Improvements
6. Deprecated Features
7. Code Examples
8. FAQ
9. Additional Resources
10. Support

Installation

To upgrade to the latest version of Gluestack-UI (ie..,v2), follow these steps:

Initializing v2 ( nativewind ) in an existing project :

npx gluestack-ui@latest init

If not installed, cli will prompt you to install the following package: gluestack-ui@latest

Overriding Files :

Let us consider if it is a next js project we need to update certain files (init command will do the neccessary changes for us we just need to allow it ).