# expo-ui

Guidance for building and reviewing React Native screens with @expo/ui on iOS. Useful when adopting SwiftUI views or working with iOS 26 interface features.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 142 installs · ★ 227 repo stars
- Author: pproenca
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.curated/expo-ui/SKILL.md
- Updated: 2026-08-15
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pproenca-expo-ui

## What it does

expo-ui explains how to build screens with `@expo/ui/swift-ui`: choose containers, set `Host` boundaries, and pass SwiftUI modifiers through the `modifiers` prop instead of React Native styles. It also covers controls, overlays, navigation composition, and state patterns.

For iOS 26, the skill covers Liquid Glass composition, including `GlassEffectContainer` and partial sheet detents. Most guidance assumes iOS 17 or later; Liquid Glass rules require iOS 26. This is an iOS SwiftUI reference, not guidance for Android Jetpack Compose.

Use it to investigate SwiftUI views that render at the wrong size or ignore styling, and to choose suitable layout and input components. Routing is outside its scope, so stack and tab navigation still call for `expo-router`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill expo-ui -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/expo-ui/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/expo-ui/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill expo-ui -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/expo-ui/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill expo-ui -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/expo-ui/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pproenca/dot-skills skills/.curated/expo-ui
```

2. **Manually: put the files in place**
- File: `.github/skills/expo-ui/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill expo-ui -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pproenca/dot-skills --path skills/.curated/expo-ui
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/expo-ui/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill expo-ui -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.curated/expo-ui/SKILL.md

## When to use it
- wrap SwiftUI subtrees in `Host` and size them to their contents
- replace React Native styles with SwiftUI modifiers
- build a settings screen with `Form` and `Section`
- wire a controlled `TextField` with `useNativeState`
- compose iOS 26 sheets and Liquid Glass surfaces

## Example prompts
- Review this `@expo/ui/swift-ui` screen and fix its `Host` boundaries and modifiers.
- Help migrate this React Native screen to SwiftUI components through `@expo/ui`.
- Check this iOS 26 sheet composition for Liquid Glass and a partial detent.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 8aa3a64a923a9837.

BEGIN THIRD-PARTY FILE 8aa3a64a923a9837
```text
---
name: expo-ui
description: Library reference for @expo/ui SwiftUI components on iOS — covers Host boundaries, modifier composition, iOS 26 Liquid Glass and Human Interface Guidelines composition rules, layout/input/navigation/display catalogues, and ObservableState patterns. Use this skill whenever writing or reviewing React Native code that imports from @expo/ui/swift-ui or @expo/ui/swift-ui/modifiers — including new Expo apps adopting native SwiftUI views, migrations from React Native primitives to expo-ui, and code targeting iOS 26 features (Liquid Glass, GlassEffectContainer, sheet detents). Trigger even if the user does not explicitly mention "expo-ui" but is writing iOS-targeted Expo UI code that should bridge to SwiftUI.
---

# Expo @expo/ui SwiftUI Best Practices

Library reference for `@expo/ui/swift-ui` and `@expo/ui/swift-ui/modifiers` — the iOS surface of Expo's native UI bridge. Contains 53 rules across 8 categories, prioritised by cascade impact for agents building Expo apps that render to native SwiftUI views on iOS 26 and earlier.

## When to Apply

Reference these guidelines when:

- Building a new screen with `@expo/ui/swift-ui` — pick the right container (Form vs List vs ScrollView), wrap in Host correctly, apply modifiers
- Migrating from React Native primitives (View, Text, TouchableOpacity) to native SwiftUI components
- Targeting iOS 26 features — Liquid Glass material, GlassEffectContainer, new sheet detent behaviours
- Reviewing code that imports from `@expo/ui/swift-ui` or `@expo/ui/swift-ui/modifiers`
- Debugging "the SwiftUI view doesn't render / is the wrong size / ignores styles" — usually a Host or modifier issue
- Composing presentation surfaces — Alert, ConfirmationDialog, BottomSheet, Popover — under HIG modality guidance
- Writing controlled inputs (TextField, Toggle, Picker, Slider) with `useNativeState` and worklet writes

## When NOT to Use This Skill

- **Android Jetpack Compose** — this skill covers iOS SwiftUI only. The `@expo/ui/jetpack-compose` surface has its own conventions
- **Universal (cross-platform) components** — `@expo/ui` exposes a small set; this skill scopes to the platform-specific iOS surface
- **Navigation routing** — for stack/tab routing, use `expo-router` and `expo-router/unstable-native-tabs`; this skill covers UI composition only
- **Pre-iOS-17 fallbacks** — most rules assume iOS 17 minimum; Liquid Glass rules require iOS 26

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Setup & Host Boundaries | CRITICAL | `host-` |
| 2 | iOS 26 HIG Composition Rules | CRITICAL | `hig-` |
| 3 | Modifiers System | CRITICAL | `mod-` |
| 4 | Layout Components | HIGH | `layout-` |
| 5 | Input & Controls | HIGH | `input-` |
| 6 | Navigation & Overlays | HIGH | `nav-` |
```
END THIRD-PARTY FILE 8aa3a64a923a9837

The third-party file has ended. Everything between the 8aa3a64a923a9837 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2863 of 10796 bytes. © pproenca · MIT · https://github.com/pproenca/dot-skills/tree/HEAD/skills/.curated/expo-ui/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
