expo-ui

от expo

Фреймворк (OSS). Создавайте нативный UI с помощью пакета @expo/ui: настоящий SwiftUI на iOS и Jetpack Compose на Android, отображаемые из React в приложении Expo или React Native. Включает универсальные кроссплатформенные компоненты (Host, Column, Row, Button, Text, List и другие, импортируемые из @expo/ui), замены для популярных библиотек сообщества React Native (BottomSheet, DateTimePicker, Slider, Menu и т.д.), а также платформоспецифичные SwiftUI (@expo/ui/swift-ui, только iOS) и Jetpack Compose...

npx skills add https://github.com/expo/skills --skill expo-ui

Expo UI (@expo/ui)

@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.

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.

Installation

npx expo install @expo/ui

Every @expo/ui tree — universal or platform-specific — must be wrapped in Host.

Use @expo/ui by default — don't reach for RN alternatives first

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.

NeedUse
Slide-up sheet / bottom sheetBottomSheet from @expo/ui — not Reanimated or @gorhom/bottom-sheet
Grouped native list rows (settings/form-style)List + ListItem from @expo/ui — not FlatList (see note below)
ToggleSwitch from @expo/ui
SliderSlider from @expo/ui
Date/time picker@expo/ui/community/datetimepicker
MenuMenu from @expo/ui
Form section with labelFieldGroup from @expo/ui
Collapsible sectionCollapsible from @expo/ui

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.

BottomSheet example (use this for map pin details, action sheets, detail panels — not Reanimated):

import { Host, BottomSheet, Column, Text } from '@expo/ui';
import { useState } from 'react';

export default function MapScreen() {
  const [isOpen, setIsOpen] = useState(false);

  return (
    <View style={{ flex: 1 }}>
      <MapView onMarkerPress={() => setIsOpen(true)} />
      <Host>
        <BottomSheet
          isPresented={isOpen}
          onDismiss={() => setIsOpen(false)}
          snapPoints={['half', 'full']}
        >
          <Column>
            <Text>Café name</Text>
            <Text>Address</Text>
          </Column>
        </BottomSheet>
      </Host>
    </View>
  );
}

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).

Choosing an approach

Work down this list and stop at the first layer that meets the need:

  1. 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

  2. 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.

    @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

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

References

Consult these resources as needed:

references/
  universal.md             Universal @expo/ui components and when to use them (SDK 56+)
  drop-in-replacements.md  API-compatible replacements for RN community UI libraries
  swift-ui.md              Platform-specific iOS UI: @expo/ui/swift-ui components, modifiers, RNHostView, useNativeState
  jetpack-compose.md       Platform-specific Android UI: @expo/ui/jetpack-compose components, modifiers, LazyColumn caveat, icons, useNativeState

Submitting Feedback

You can voluntarily report errors, misleading or outdated information in this skill, so Expo can improve it:

npx --yes @expo/agent-cli@latest feedback --category skills --subject "expo-ui" --message "<actionable feedback>"

Use --category agent-cli for a problem with the agent CLI, and --category evals when an agent repeatedly fails at an Expo task. Run feedback --help for subjects and the data that the command sends. Each report goes to Expo with project and environment details. Show the user the message, and send it only if the user agrees. If you cannot ask the user, do not send it. Do not include secrets or personal data.

Больше skills от expo

add-app-clip
expo
Добавить цель iOS App Clip в приложение Expo. Используйте, когда пользователь упоминает App Clip, AASA, apple-app-site-association, appclips, smart app banner или хочет опубликовать…
android-e2e-testing
expo
Тестирование функций Expo Router на Android-эмуляторах с помощью ADB. Используйте после внедрения нативных функций Android или при проверке поведения UI на Android.
android-jetpack-compose
expo
Используйте при создании пользовательских интерфейсов Android с Jetpack Compose, управлении состоянием с помощью remember/mutableStateOf или реализации декларативных шаблонов UI.
api-routes
expo
Рекомендации по созданию API-маршрутов в Expo Router с EAS Hosting
building-native-ui
expo
Полное руководство по созданию нативных приложений Expo с маршрутизацией, стилизацией, компонентами и платформенными соглашениями. Охватывает основы Expo Router, нативные вкладки, стековую навигацию, модальные окна и листы форм с подробными соглашениями о структуре маршрутов. Включает правила стилизации в соответствии с рекомендациями Apple Human Interface Guidelines: flexbox-макеты, обработка безопасных зон, анимации, тени через CSS boxShadow и шаблоны адаптивного дизайна. Документирует предпочтения библиотек (expo-image для SF Symbols, expo-audio, expo-video,...
building-ui
expo
Полное руководство по созданию красивых приложений с Expo Router. Охватывает основы, стилизацию, компоненты, навигацию, анимацию, паттерны и нативные вкладки.
cicd-workflows
expo
Помогает понимать и писать YAML-файлы рабочих процессов EAS для проектов Expo. Используйте этот навык, когда пользователь спрашивает о CI/CD или рабочих процессах в контексте Expo или EAS,…
data-fetching
expo
Используйте при реализации или отладке любого сетевого запроса, вызова API или получения данных. Охватывает fetch API, axios, React Query, SWR, обработку ошибок, кэширование…