gluestack v3 is here!
Our biggest release yet is live today — with a new Source-to-Destination architecture for contributors, Next.js 15 + RSC support, Expo SDK 53, TypeScript-first tooling, performance upgrades, and more.
# gluestack-ui: React & React Native 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)

[![Next.js Latest](https://github.com/gluestack/gluestack-ui/actions/workflows/next-latest.yml/badge.svg)](https://github.com/gluestack/gluestack-ui/actions/workflows/next-latest.yml)
[![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 v3** offers customizable, beautifully designed components for your projects. Unlike traditional libraries, it's not a pre-packaged dependency. Choose the components you need and copy-paste them directly into your React, Next.js & 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

- **Modular Architecture:** Pick and choose the components you need without unnecessary bloat.
- **NativeWind Integration:** Tailwind CSS support for seamless styling across web and mobile.
- **RSC Compatible:** Optimized for React Server Components to enhance performance.
- **Universal Design:** Consistent design across web and mobile platforms.
- **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 v3**

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

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

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

## Tech Stack

JavaScript, React, React Native, Styled System

## 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 v1

If you're migrating from gluestack-ui v1, we've got you covered with a detailed [migration guide](https://gluestack.io/ui/docs/home/overview/upgrade-to-v2) with codemod.

## 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 © 2024 GeekyAnts. See [LICENSE](https://github.com/gluestack/gluestack-ui/blob/main/LICENSE) for more information.