Skip to content

gluestack UI v3 released for React and React Native

updated

The gluestack team has released gluestack UI v3, a new major version of its component library for React Native and React, which was formerly known as NativeBase. The release covers performance, accessibility, developer experience and a new internal architecture for contributors.

Performance

According to the announcement, v3 reduces the default CSS/JS footprint and improves initial render times. It adds support for Next.js Turbopack, described as producing smaller production bundles and faster rebuilds, and continues support for React Server Components (RSC).

Source-to-Destination architecture

A new Source-to-Destination architecture is aimed at contributors and maintainers. All components live in a single src/ directory, and one command syncs them to starter kits, docs and examples. The team says nothing changes for developers using the library: components are still copied, pasted and owned by the app.

Compatibility and tooling

gluestack v3 targets:

  • Next.js 15 + React Server Components
  • Expo SDK 53 + React Native CLI
  • Monorepo setups out of the box

Developer experience updates include TypeScript-first tooling with full type definitions, new CLI commands for initialization, upgrading and file synchronization, hot reloading, and reworked docs with faster navigation and better search.

Theming and accessibility

The default theme has been updated for better contrast. Theming supports light, dark or fully custom modes, uses Tailwind via NativeWind v4.1, and propagates themes through CSS variables on web and context on native. Accessibility features listed include ARIA roles and WCAG compliance, keyboard navigation, screen reader optimizations, and accessible defaults across form controls, menus and modals.

Components and migration

More than 30 components have been updated, including Buttons, Inputs, Avatars, Select and Toasts, with a new Accordion and expanded IconButton variants. For v2 users, APIs and theming remain the same, and only import paths and configs change. Existing projects can be upgraded with:

npx gluestack-ui@latest upgrade

This command updates components and configuration files such as Tailwind and Next.js configs. New projects can start with:

npx gluestack-ui@latest init
npx gluestack-ui@latest add --all

Source: gluestack.io