How do I install the Gluestack UI V4:setup skill?

Run npx skillmds@latest add gluestack/gluestack-ui-v4-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gluestack UI V4:setup safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gluestack UI V4:setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gluestack UI V4:setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gluestack UI V4:setup?

gluestack (@gluestack) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gluestack UI V4:setup by gluestack — Agent Skill

Name: Gluestack UI V4:setup
Rating: 4.2 (5 reviews)
Author: gluestack

File contents

Gluestack UI v4 - Setup & Installation

This sub-skill follows the official gluestack-ui v4 installation guide only. Nothing is followed from outside Installation | gluestack-ui v4.

Use either CLI or Manual as defined on that page.

v4 only – do not use v1/v2/v3 packages or docs

Never use or suggest: @gluestack/styled, @gluestack-ui/themed, or any packages/docs from gluestack.io (without the v4. subdomain). Those are for v1/v2/v3.
v4 uses: v4.gluestack.io docs only; packages such as @gluestack-ui/core, @gluestack-ui/utils, NativeWind, and components copied into your app (e.g. GluestackUIProvider, icon, overlay, toast). Manual installation for v4 is only the Manual tab on the v4 Installation page – not any other “manual” or “gluestack styled” guide.

CLI

Step 1: Setup your project

New project: Set up your project with Next.js or Expo.
Existing project: Skip this step.

Prerequisites

Ensure these prerequisites are satisfied to use the gluestack-ui CLI:

Package Name	Supported Versions	Upcoming Support
next	13 <= versions <= 15	-
react-native	versions >= 72.5	-
expo	versions >= 50	-
node	versions > 16	-

Step 2: Initialize (CLI only)

To initialize gluestack-ui v4 via CLI, use only this command (from your project root):

npx gluestack-ui@alpha init -y

This adds GluestackUIProvider and essential components (icon, overlay, toast). Do not use any other command or method for CLI initialization.

After init, your project is ready to use gluestack-ui components. To add more components via CLI, use the add command or the CLI guide. Example:

npx gluestack-ui@alpha add box

npx gluestack-ui@alpha add --all -y

If you run into issues during CLI installation, use the manual installation guide (Manual tab on the same Installation page).

Manual

For installation without the CLI, use only the Manual tab on the v4 Installation page:

Manual installation (v4 only): https://v4.gluestack.io/ui/docs/home/getting-started/installation → switch to the Manual tab on that page.

Do not:

Use manual steps from gluestack.io (without v4.), or from blog posts, Stack Overflow, or other guides that reference v1/v2/v3.
Install or suggest @gluestack/styled, @gluestack-ui/themed, or any v1/v2/v3 packages. v4 does not use those; v4 uses @gluestack-ui/core@alpha, @gluestack-ui/utils@alpha, NativeWind, and the provider/components from the v4 Manual tab only.

Common issues

Expo app stuck in tailwindcss(ios) rebuilding... while running expo start

Cause: Project directory name contains spaces (e.g. Expo App).
Fix: Rename the directory so it has no spaces (e.g. Expo-App).

Reference

Installation (v4): https://v4.gluestack.io/ui/docs/home/getting-started/installation — use CLI or Manual tab here only; ignore gluestack.io (non-v4) and any guides that mention @gluestack/styled or v1/v2/v3.
CLI guide: https://v4.gluestack.io/ui/docs/home/getting-started/cli

---name: gluestack-ui-v4-setupdescription: Guide for installing gluestack-ui v4 per the official Installation doc - CLI and Manual paths only. Follow https://v4.gluestack.io/ui/docs/home/getting-started/installation strictly.--- # Gluestack UI v4 - Setup & Installation This sub-skill follows the official **gluestack-ui v4** installation guide only. Nothing is followed from outside [Installation | gluestack-ui v4](https://v4.gluestack.io/ui/docs/home/getting-started/installation). Use either **CLI** or **Manual** as defined on that page. ## v4 only – do not use v1/v2/v3 packages or docs - **Never** use or suggest: `@gluestack/styled`, `@gluestack-ui/themed`, or any packages/docs from **gluestack.io** (without the `v4.` subdomain). Those are for v1/v2/v3. - **v4** uses: **v4.gluestack.io** docs only; packages such as `@gluestack-ui/core`, `@gluestack-ui/utils`, NativeWind, and components copied into your app (e.g. `GluestackUIProvider`, `icon`, `overlay`, `toast`). Manual installation for v4 is **only** the Manual tab on the v4 Installation page – not any other “manual” or “gluestack styled” guide. --- ## CLI ### Step 1: Setup your project - **New project:** Set up your project with [Next.js](https://nextjs.org/docs/getting-started/installation) or [Expo](https://docs.expo.dev/get-started/create-a-project/). - **Existing project:** Skip this step. ### Prerequisites Ensure these prerequisites are satisfied to use the gluestack-ui CLI: | Package Name | Supported Versions | Upcoming Support | |----------------|----------------------|------------------| | next | 13 <= versions <= 15 | - | | react-native | versions >= 72.5 | - | | expo | versions >= 50 | - | | node | versions > 16 | - | ### Step 2: Initialize (CLI only) To initialize gluestack-ui v4 via CLI, use **only** this command (from your project root): ```bash npx gluestack-ui@alpha init -y ``` This adds **GluestackUIProvider** and essential components (**icon**, **overlay**, **toast**). Do not use any other command or method for CLI initialization. After init, your project is ready to use gluestack-ui components. To add more components via CLI, use the **add** command or the [CLI guide](https://v4.gluestack.io/ui/docs/home/getting-started/cli). Example: ```bash npx gluestack-ui@alpha add box ``` or ```bash npx gluestack-ui@alpha add --all -y ``` If you run into issues during CLI installation, use the **manual installation guide** (Manual tab on the same Installation page). --- ## Manual For installation without the CLI, use **only** the **Manual** tab on the v4 Installation page: - **Manual installation (v4 only):** [https://v4.gluestack.io/ui/docs/home/getting-started/installation](https://v4.gluestack.io/ui/docs/home/getting-started/installation) → switch to the **Manual** tab on that page. **Do not:** - Use manual steps from gluestack.io (without `v4.`), or from blog posts, Stack Overflow, or other guides that reference **v1/v2/v3**. - Install or suggest **@gluestack/styled**, **@gluestack-ui/themed**, or any v1/v2/v3 packages. v4 does not use those; v4 uses `@gluestack-ui/core@alpha`, `@gluestack-ui/utils@alpha`, NativeWind, and the provider/components from the v4 Manual tab only. --- ## Common issues **Expo app stuck in `tailwindcss(ios) rebuilding...` while running `expo start`** - Cause: Project directory name contains spaces (e.g. `Expo App`). - Fix: Rename the directory so it has no spaces (e.g. `Expo-App`). --- ## Reference - **Installation (v4):** [https://v4.gluestack.io/ui/docs/home/getting-started/installation](https://v4.gluestack.io/ui/docs/home/getting-started/installation) — use **CLI** or **Manual** tab here only; ignore gluestack.io (non-v4) and any guides that mention `@gluestack/styled` or v1/v2/v3. - **CLI guide:** [https://v4.gluestack.io/ui/docs/home/getting-started/cli](https://v4.gluestack.io/ui/docs/home/getting-started/cli)

Frequently asked questions

Gluestack UI V4:setup