gluestack-ui-v5:components

Enforces gluestack-ui v5 component usage patterns, compound structures, and semantic tokens in React Native.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers building React Native apps with gluestack-ui v5 often misuse components by importing React Native primitives, skipping required compound sub-components, or applying hardcoded color classes that break theming. This Skill provides the exact rules and correct/incorrect code patterns to write consistent, theme-aware gluestack-ui v5 code. ## Core Features & Use Cases - Component Selection Rules: Maps React Native primitives (View, Text, TouchableOpacity) to their gluestack equivalents (Box, Text, Pressable) and mandates props like space, variant, and size over className utilities. - Compound Component Patterns: Documents required sub-component structures for Input, Button, FormControl, Card, Checkbox, and Select, including the mandatory InputSlot wrapper for InputIcon. - Theming & Icons: Covers GluestackUIProvider setup, NativeWind v5 vs UniWind theme switching, icon resolution via pre-built exports, Lucide, or createIcon, and strict semantic token usage (bg-background, text-foreground). - Use Case: When building a login screen with email and password inputs, use this Skill to correctly structure FormControl with InputSlot-wrapped icons, error states, and semantic color tokens that adapt to light and dark themes. ## Quick Start Ask the AI to build a login form with email and password inputs using gluestack-ui v5 components with proper icons and error handling.

Frequently Asked Questions about gluestack-ui-v5:components

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

FAQPage Schema
How do I use gluestack-ui v5 components in React Native?

Import components from your local components/ui directory, such as Box, Text, and Pressable, instead of React Native primitives. Wrap your app in GluestackUIProvider and prefer component props like space, variant, and size over className utilities.

How to add icons to gluestack Input components?

InputIcon must always be wrapped inside InputSlot, whether placed on the left or right of InputField. For interactive icons like a password visibility toggle, attach onPress to the InputSlot itself.

Does gluestack-ui v5 support dark mode with NativeWind and UniWind?

Yes, but the APIs differ. NativeWind v5 uses Appearance.setColorScheme with prefers-color-scheme media queries, while UniWind uses Uniwind.setTheme('light' | 'dark' | 'system'). The GluestackUIProvider handles switching for your chosen engine.

Should I use className or props for gluestack component styling?

Use built-in props when available, such as space on VStack/HStack, variant and size on Button, and size on Text and Heading. Reserve className for layout utilities and custom styling that has no prop equivalent.

Why is my gluestack Button text not rendering correctly?

Button requires text content to be wrapped in ButtonText and icons in ButtonIcon. Placing raw text or icon components directly as Button children breaks styling and rendering.

Can I use Tailwind color classes like bg-gray-100 with gluestack-ui v5?

No, generic and numbered tokens like bg-gray-100, text-typography-900, or bg-blue-600 are prohibited. Use semantic tokens such as bg-background, bg-card, text-foreground, and text-muted-foreground so themes swap correctly.