gluestack-ui-v4:variants

Create type-safe UI component variants for Gluestack UI v4 using TVA.

Updated Jan 18, 2026
One-click install
npx skills add https://github.com/jia-wei-00/expense-tracker --skill gluestack-ui-v4-variants-jia-wei-00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gluestack-ui-v4:variants
Source: https://github.com/jia-wei-00/expense-tracker/tree/main/.agents/skills/gluestack-ui-v4/variants
Command: npx skills add https://github.com/jia-wei-00/expense-tracker --skill gluestack-ui-v4-variants-jia-wei-00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gluestack UI v4 variant creation is essential for extending components with project-specific patterns while preserving consistency and type-safety across a design system.

Core Features & Use Cases

  • Create and manage multi-dimensional variants for base components (Button, Card, Badge, etc.) using TVA.
  • Extend existing components with new, type-safe variants while preserving existing behavior and compound variants.
  • Support parent-child variant relationships, compound variants, and semantic token usage for consistent theming.
  • Real-world use case: add a gradient button variant that works across dark and light modes and automatically inherits typography from the design system.

Quick Start

Define a TVA-based style set for your target component and apply it with the variant and size props to render your first custom variant.

Frequently Asked Questions about gluestack-ui-v4:variants

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

FAQPage Schema
How do I create custom UI component variants for Gluestack UI v4?

To create UI component variants for Gluestack UI v4, define a TVA-based style set for your target component and apply it using variant and size props. This enables project-specific styling while preserving design-system consistency.

How do I add a new variant to an existing Gluestack component without breaking compound variants?

You can extend existing Gluestack UI components with new type-safe variants using TVA. This approach preserves existing behavior, compound variants, and parent-child relationships while adding your custom styling patterns.

Does Gluestack UI v4 support parent-child relationships and multi-dimensional variants?

Yes, Gluestack UI v4 supports multi-dimensional variants across base components like Button, Card, and Badge. It handles parent-child relationships and compound variants for complex states using TVA.

How do I ensure my custom UI variants maintain type safety and semantic token usage?

TVA enforces type-safe variant definitions for Gluestack UI components. It includes semantic token usage and defaults, ensuring consistent theming across light and dark modes while maintaining strict type safety.

Can I build a gradient button variant that automatically inherits typography and supports dark mode?

Yes, you can add a gradient button variant that works across dark and light modes and automatically inherits typography from the design system. This is achieved by applying TVA with semantic token usage and defaults.

What is the best way to manage complex component states in a React design system?

Using TVA with Gluestack UI v4 is an effective way to manage complex component states. It allows you to define multi-dimensional variants and compound variants, ensuring robust and consistent design-system styling.