gluestack v5 is here!
Our biggest release yet is live today — with support for NativeWind v5 (Tailwind v4), optimized CLI performance, Expo Router first, and state-of-the-art native components.
# gluestack-ui: React Native & Expo Components & Patterns

gluestack-ui is a library of copy-pasteable components & patterns crafted with Tailwind CSS (NativeWind).

[![GitHub stars](https://img.shields.io/github/stars/gluestack/gluestack-ui)](https://github.com/gluestack/gluestack-ui)

[![NPM downloads](https://img.shields.io/npm/dw/@gluestack-ui/utils?logo=npm&label=NPM%20downloads&cacheSeconds=3600)](https://www.npmjs.com/package/@gluestack-ui/utils) [![Commits per month](https://img.shields.io/github/commit-activity/m/gluestack/gluestack-ui?label=Commits&logo=git)](https://github.com/gluestack/gluestack-ui/commits)

[![Expo Latest](https://github.com/gluestack/gluestack-ui/actions/workflows/expo-latest.yml/badge.svg)](https://github.com/gluestack/gluestack-ui/actions/workflows/expo-latest.yml)

<h3 align="center">
  <a href="https://github.com/gluestack/gluestack-ui">
    <img src="https://raw.githubusercontent.com/gluestack/gluestack-ui/main/apps/website/public/images/og-image.png" alt="gluestack-ui logo" >
  </a>
  <br>
  <br>
 </h3>

## Introduction

**gluestack-ui v5** offers customizable, beautifully designed components for your native projects. Unlike traditional libraries, it's not a pre-packaged dependency. Choose the components you need and copy-paste them directly into your Expo and React Native projects.

## Documentation

You can find detailed documentation for each component, including a list of props and examples, in https://gluestack.io/ui/docs website.

## Features

- **NativeWind v5 / Tailwind v4 Integration:** Tailwind CSS support for seamless styling across native platforms.
- **Modular Architecture:** Pick and choose the components you need without unnecessary bloat.
- **Expo Router First:** Out-of-the-box integration with the latest Expo Router.
- **Flexible Theming:** Customize your components with ease using theming tokens and configuration.
- **Accessibility:** Built with robust accessibility features to ensure inclusivity.
- **Frequent updates:** We are constantly working on improving the library and adding new components. Follow us on GitHub to stay up-to-date on the latest releases and features.
- **Community support:** Need help using the library or have a suggestion for a new feature? Join our [Discord](https://discord.com/invite/95qQ84nf6f) channel to connect with the community and get support.

## Installing **gluestack-ui v5**

To get started with **gluestack-ui v5**, you must have an existing Expo or React Native project. Then, simply run the following command:

```bash
npx gluestack-ui init
```

For detailed installation instructions, visit the [gluestack-ui v5 installation guide](https://gluestack.io/ui/docs/home/getting-started/installation).

## Tech Stack

TypeScript, React Native, Expo, Tailwind CSS, NativeWind

## Getting Started

- **Install gluestack-ui:** Follow the [installation guide](https://gluestack.io/ui/docs/home/getting-started/installation).
- **Add Components:** Use our CLI to add components to your project, or simply copy-paste from our documentation.
- **Customize:** Tailor the components to fit your project's needs using theming tokens and configuration.
- **Build:** Start building your app with a consistent, accessible, and high-performance UI.

## Migration from gluestack-ui v3 / v4

If you're migrating from earlier versions, check our [migration guide](https://gluestack.io/ui/docs) to upgrade to v5.

## Created By GeekyAnts

GeekyAnts is a team of React Native experts who love open-source and solving developer problems. We’ve been working on React Native since 2015 and have designed and built React Native apps for almost 200+ clients across the globe. Our clients include startups to big enterprises! Need help with your React Native app?

[Contact Us](https://geekyants.com/?utm_source=gluestack_github&utm_medium=read_me&utm_campaign=gluestack_integration)

## Contributing

We welcome contributions to the `gluestack-ui`. If you have an idea for a new component or a bug fix, please read our [contributing guide](./CONTRIBUTING.md) instructions on how to submit a pull request.

## License

Licensed under the MIT License, Copyright © 2026 GeekyAnts. See [LICENSE](https://github.com/gluestack/gluestack-ui/blob/main/LICENSE) for more information.