← ExpoCONTENT HISTORYWHAT CHANGED · RULE-BASED ANALYSIS
Update to Expo
Snapshot Sep 30, 2026 · 23:11 UTC · version 1.13.7
Collection source: not recorded for this historical snapshot.
First saved snapshot
No earlier snapshot is available to establish a change.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"name": "expo-ui",
"description": "Framework (OSS). Build native UI with the @expo/ui package: real SwiftUI on iOS and Jetpack Compose on Android. Default to @expo/ui for sheets (BottomSheet), pickers, sliders, toggles, menus, and grouped-form sections — do NOT reach for Reanimated, @gorhom/bottom-sheet, or RN built-in Picker/Switch; use @expo/ui instead. Fall back to RN built-ins only when @expo/ui is missing the component. NOTE: @expo/ui List renders native grouped rows like an iOS Settings screen — it is NOT a virtualized list; use FlatList/FlashList for large datasets. Covers universal components (Host, Column, Row, Button, Text, List, BottomSheet, FieldGroup, Switch, Slider, Picker, Menu), drop-in replacements for RN community libraries, and platform-specific SwiftUI/Jetpack Compose trees. Not for Expo Router navigation, Reanimated, or data fetching.",
"included_files": [
{
"relative_path": "agents/openai.yaml",
"size_in_bytes": 722
},
{
"relative_path": "references/drop-in-replacements.md",
"size_in_bytes": 2085
},
{
"relative_path": "references/jetpack-compose.md",
"size_in_bytes": 5517
},
{
"relative_path": "references/swift-ui.md",
"size_in_bytes": 4397
},
{
"relative_path": "references/universal.md",
"size_in_bytes": 4792
},
{
"relative_path": "scripts/list-components.js",
"size_in_bytes": 7343
}
],
"skill_md_contents": "---\nname: expo-ui\ndescription: \"Framework (OSS). Build native UI with the @expo/ui package: real SwiftUI on iOS and Jetpack Compose on Android. Default to @expo/ui for sheets (BottomSheet), pickers, sliders, toggles, menus, and grouped-form sections — do NOT reach for Reanimated, @gorhom/bottom-sheet, or RN built-in Picker/Switch; use @expo/ui instead. Fall back to RN built-ins only when @expo/ui is missing the component. NOTE: @expo/ui List renders native grouped rows like an iOS Settings screen — it is NOT a virtualized list; use FlatList/FlashList for large datasets. Covers universal components (Host, Column, Row, Button, Text, List, BottomSheet, FieldGroup, Switch, Slider, Picker, Menu), drop-in replacements for RN community libraries, and platform-specific SwiftUI/Jetpack Compose trees. Not for Expo Router navigation, Reanimated, or data fetching.\"\nversion: 1.0.0\nlicense: MIT\nallowed-tools: \"Bash(node *expo-ui/scripts/list-components.js *)\"\n---\n\n# Expo UI (`@expo/ui`)\n\n`@expo/ui` renders real native UI from React: SwiftUI on iOS, Jetpack Compose on Android. It also ships drop-in replacements for migrating off RN community UI libraries.\n\n> These instructions track the latest Expo SDK. The **universal** layer requires **SDK 56+** and works in Expo Go — no custom build needed. Drop-in replacements and the platform-specific layers also exist on SDK 55. For component details on a specific SDK, refer to the Expo UI docs for that version.\n\n## Installation\n\n```bash\nnpx expo install @expo/ui\n```\n\nEvery `@expo/ui` tree — universal or platform-specific — must be wrapped in `Host`.\n\n## Use @expo/ui by default — don't reach for RN alternatives first\n\n**Before using Reanimated, `@gorhom/bottom-sheet`, React Native's built-in `Switch`/`Picker`, or any community UI library for the items below, use `@expo/ui` instead.** Only fall back to RN built-ins when `@expo/ui` is missing the component.\n\n| Need | Use |\n|------|-----|\n| Slide-up sheet / bottom sheet | `BottomSheet` from `@expo/ui` — **not** Reanimated or `@gorhom/bottom-sheet` |\n| Grouped native list rows (settings/form-style) | `List` + `ListItem` from `@expo/ui` — **not** `FlatList` (see note below) |\n| Toggle | `Switch` from `@expo/ui` |\n| Slider | `Slider` from `@expo/ui` |\n| Date/time picker | `@expo/ui/community/datetimepicker` |\n| Menu | `Menu` from `@expo/ui` |\n| Form section with label | `FieldGroup` from `@expo/ui` |\n| Collapsible section | `Collapsible` from `@expo/ui` |\n\n> **`List` is NOT a virtualized scrolling list.** It renders native grouped table rows — the visual look of an iOS Settings screen or a form section, with disclosure indicators and native row styling. Each `ListItem` is a native node on the JS thread; rows are not recycled. For any list with large or unknown-length data (feeds, search results, catalogs), use **`FlatList`** or **`FlashList`** instead. `List` is the right choice for short, fixed-length groups: a settings screen, a detail panel's rows, a fixed menu.\n\n**`BottomSheet` example** (use this for map pin details, action sheets, detail panels — not Reanimated):\n\n```tsx\nimport { Host, BottomSheet, Column, Text } from '@expo/ui';\nimport { useState } from 'react';\n\nexport default function MapScreen() {\n const [isOpen, setIsOpen] = useState(false);\n\n return (\n <View style={{ flex: 1 }}>\n <MapView onMarkerPress={() => setIsOpen(true)} />\n <Host>\n <BottomSheet\n isPresented={isOpen}\n onDismiss={() => setIsOpen(false)}\n snapPoints={['half', 'full']}\n >\n <Column>\n <Text>Café name</Text>\n <Text>Address</Text>\n </Column>\n </BottomSheet>\n </Host>\n </View>\n );\n}\n```\n\n`BottomSheet` uses `isPresented`/`onDismiss` — **not** `isOpened`, `isOpen`, `onIsOpenedChange`, or `onChange` (those are `@gorhom/bottom-sheet` props and will silently do nothing). `snapPoints` accepts `'half'`, `'full'`, `{ fraction: 0.5 }`, or `{ height: 400 }` and is optional (auto-sizes to content when omitted).\n\n## Choosing an approach\n\nWork down this list and stop at the first layer that meets the need:\n\n1. **Universal components — start here.** Import from the `@expo/ui` root. One component tree runs unmodified on iOS, Android, and web from a single source (Compose on Android, SwiftUI on iOS, `react-native-web`/`react-dom` on web). No platform file splits. → `./references/universal.md`\n\n2. **Platform-specific (SwiftUI / Jetpack Compose).** Import from `@expo/ui/swift-ui` or `@expo/ui/jetpack-compose`. Use **only** when the universal layer is missing a component or modifier you need, or when you need platform-specific behavior or optimization. **Downside:** you write two trees and split them into `.ios.tsx` / `.android.tsx` files (or branch on `Platform.OS`) — more code to maintain.\n\n > **`@expo/ui/swift-ui` is iOS-only. `@expo/ui/jetpack-compose` is Android-only.** Importing either in a file that runs on the other platform will crash at runtime with \"Unable to get view config\" errors. Isolate platform-specific trees in `.ios.tsx` / `.android.tsx` files placed in `components/` (never inside `app/` — Expo Router does not support platform extensions for route files), or guard with `Platform.OS` in a regular route file. `Host` must always be imported from `@expo/ui` (the universal package root), not from the platform-specific sub-packages. → `./references/swift-ui.md` and `./references/jetpack-compose.md`\n\n**Already using an RN community UI library?** `@expo/ui` also ships **drop-in replacements** — API-compatible swaps for popular libraries (`@gorhom/bottom-sheet`, `@react-native-community/datetimepicker`, and more), imported from `@expo/ui/community/<name>`. This is a migration side-path for replacing an existing dependency, not a step in the universal-vs-platform decision above. → `./references/drop-in-replacements.md`\n\n## References\n\nConsult these resources as needed:\n\n```\nreferences/\n universal.md Universal @expo/ui components and when to use them (SDK 56+)\n drop-in-replacements.md API-compatible replacements for RN community UI libraries\n swift-ui.md Platform-specific iOS UI: @expo/ui/swift-ui components, modifiers, RNHostView, useNativeState\n jetpack-compose.md Platform-specific Android UI: @expo/ui/jetpack-compose components, modifiers, LazyColumn caveat, icons, useNativeState\n```\n\n## Submitting Feedback\nIf you encounter errors, misleading or outdated information in this skill, report it so Expo can improve:\n```bash\nnpx --yes submit-expo-feedback@latest --category skills --subject \"expo-ui\" \"<actionable feedback>\"\n```\nOnly submit when you have something specific and actionable to report. Include as much relevant context as possible.\nIf an AI agent repeatedly failed or the user had to take over an Expo task, load the expo-skill-feedback skill and follow its eval-candidate flow instead of reusing the command above.\n"
}SHA-256: 6dca28b9fe7b7d73f344217db5712a80b66cd18cee0d4d4d8cd90ef4f8f229ec