expo-ui
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.
pproenca · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add pproenca/dot-skills --skill expo-ui技能说明
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-uior@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
useNativeStateand worklet writes
When NOT to Use This Skill
- Android Jetpack Compose — this skill covers iOS SwiftUI only. The
@expo/ui/jetpack-composesurface has its own conventions - Universal (cross-platform) components —
@expo/uiexposes a small set; this skill scopes to the platform-specific iOS surface - Navigation routing — for stack/tab routing, use
expo-routerandexpo-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- |
| 7 | Display & Feedback | MEDIUM-HIGH | display- |
| 8 | State & Cross-Cutting Patterns | MEDIUM | state- |
Quick Reference
1. Setup & Host Boundaries (CRITICAL)
host-wrap-all-swiftui-roots— Wrap every SwiftUI subtree in a Hosthost-match-contents— Size Host to its SwiftUI content with matchContentshost-viewport-size-for-form— Use useViewportSizeMeasurement for Form and Listhost-color-scheme-explicit— Pass explicit colorScheme when overriding the systemhost-ignore-safe-area— Use ignoreSafeArea only for full-bleed surfaces
2. iOS 26 HIG Composition Rules (CRITICAL)
hig-glass-effect-container— Group glass siblings inside GlassEffectContainerhig-no-glass-on-glass— Avoid nesting glassEffect on glass surfaceshig-no-stacked-modals— Resolve a sheet before presenting anotherhig-popover-iphone-fallback— Don't use Popover on iPhone — use BottomSheethig-sheet-detents-partial— Include a partial detent for Liquid Glass appearancehig-confirmation-dialog-destructive— ConfirmationDialog + destructive rolehig-tint-only-for-brand— Reserve tint for brand surfaces, not destructive
3. Modifiers System (CRITICAL)
mod-prop-not-style— Modifiers go through themodifiersprop, not RN stylemod-composition-order— Modifier order is meaningful — each wraps the previousmod-import-from-modifiers-subpath— Import from@expo/ui/swift-ui/modifiersmod-frame-vs-fixedsize— frame proposes a size, fixedSize opts out of flexmod-padding-vs-frame— padding for inner space, frame for outer boundsmod-presentation-on-sheet-content— Presentation modifiers attach to sheet contentmod-disabled-prop— Use disabled modifier, don't conditionally rendermod-animation-wraps-trigger— withAnimation wraps state-driven prop changes
4. Layout Components (HIGH)
layout-hstack-vs-vstack— Pick stack direction by content flowlayout-lazy-stack-for-long-lists— LazyVStack inside ScrollView for long listslayout-form-for-settings— Form adopts iOS grouped chrome automatically- [
layout-section-with-header-footer](references/layout-section-with-h