gluestack-ui-v5

Enforces opinionated styling patterns for gluestack-ui v5 with Tailwind CSS v4 and NativeWind or UniWind.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/aadilmallick/myfitness-pal-clone --skill gluestack-ui-v5-aadilmallick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gluestack-ui-v5
Source: https://github.com/aadilmallick/myfitness-pal-clone/tree/main/.agents/skills/gluestack-ui-v5
Command: npx skills add https://github.com/aadilmallick/myfitness-pal-clone --skill gluestack-ui-v5-aadilmallick

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @gluestack-ui/core, @gluestack-ui/utils, nativewind, react-native-css, uniwind, tailwindcss.

What problem does it solve? Styling React Native apps with gluestack-ui v5 involves many decisions—component props vs className, semantic tokens vs raw colors, NativeWind vs UniWind setup—which leads to inconsistent, unmaintainable UI code. This Skill constrains the solution space to canonical patterns so every component follows the same design system rules. ## Core Features & Use Cases - Opinionated styling rules: Enforces semantic color tokens only (no numbered colors like red-500), component props over className utilities, and compound component patterns such as InputIcon inside InputSlot. - Setup guidance for both engines: Covers CLI-based installation and manual configuration for NativeWind v5 (Expo and RN CLI) and UniWind (Expo only), including global.css token definitions and metro config. - Component creation and variants: Provides templates for simple, compound, form, and loading-state components plus tva-based variant patterns with parent-child relationships and compound variants. - Use Case: When building a new screen in an Expo app, invoke this Skill to generate a profile card or form that uses only semantic tokens, correct compound components, and dark-mode-compatible styling that passes code review. ## Quick Start Ask the assistant to create a new gluestack-ui v5 component, such as a status badge with variants, following the semantic token and compound component rules.

Frequently Asked Questions about gluestack-ui-v5

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

FAQPage Schema
How do I set up gluestack-ui v5 in an Expo project?

Run npx gluestack-ui@latest init from your project root, then add components with npx gluestack-ui@latest add --all. Choose NativeWind v5 for Expo and RN CLI, or UniWind for a simpler Expo-only setup without PostCSS.

NativeWind v5 vs UniWind for gluestack-ui v5?

NativeWind v5 supports Expo and React Native CLI but requires PostCSS and a pinned lightningcss 1.30.1. UniWind is Expo-only, skips PostCSS entirely, and uses Uniwind.setTheme() for theme switching instead of Appearance.setColorScheme().

How do I create custom variants for gluestack-ui components?

Use tva (Tailwind Variant Authority) to define base styles plus variant dimensions like variant, size, and state, with defaultVariants specified. For child components, share parent state via React context and apply parentVariants.

Why must InputIcon be wrapped in InputSlot?

InputIcon requires InputSlot for correct styling, positioning, and press interaction handling in gluestack-ui v5. Placing InputIcon directly inside Input without InputSlot breaks layout and interactive behavior.

Can I use Tailwind color classes like bg-blue-600 with gluestack-ui v5?

No, numbered colors, neutral, gray, slate, and typography tokens are prohibited because they break dark mode and the design system. Use only semantic tokens like bg-primary, text-foreground, and border-border with optional alpha values.

Does gluestack-ui v5 support Next.js?

Next.js support is pending NativeWind v5 web support. For Next.js projects, use gluestack-ui v4 until v5 web support lands.