К основному содержанию
скилл CX Codex

expo-ios-hig — скилл для Claude Code: что делает и как установить

Скилл expo-ios-hig для Claude Code содержит правила Apple Human Interface Guidelines для экранов, списков и навигации в Expo и React Native.

MIT 169 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill expo-ios-hig -a claude-code
Открыть на GitHub

Что делает expo-ios-hig

Скилл содержит 46 правил в 8 категориях, отсортированных по силе влияния на нативное ощущение приложения под iOS. Все примеры кода ориентированы на React Native и TypeScript без погружения в Swift. Инструкции объясняют, когда задействовать нативный стек Expo Router, системные Alert и ActionSheetIOS, иконки SF Symbols через expo-symbols, тактильный отклик и жесты.

Вместо переписывания интерфейсных элементов на чистом JavaScript скилл направляет агента к возможностям самой системы: безопасным зонам, динамическим шрифтам, тёмной теме и нативным контроллерам переходов. Правила прямо запрещают тащить компоненты в стиле Material Design в интерфейс для iOS.

Скилл не обучает низкоуровневому API библиотеки @expo/ui и не подходит для проектов на чистом Swift или кодовой базы под Android. Если проект кроссплатформенный, интерфейс под Android придётся адаптировать отдельно.

Какие задачи решает

  • настроить нативную навигацию через Expo Router со стеком и вкладками
  • заменить самодельные диалоги на системные Alert и ActionSheetIOS
  • подключить системные иконки SF Symbols вместо сторонних шрифтов
  • выставить размеры кликабельных зон от 44pt и добавить тактильный отклик
  • настроить отступы Safe Area и поведение списков под системными панелями

Примеры запросов агенту

  • Собери экран настроек на Expo Router с нативными переключателями Switch и секциями под iOS HIG
  • Проверь этот TSX-компонент формы на соблюдение гайдлайнов Apple: Safe Area, отклики на нажатия и шрифты
  • Перепиши кастомное модальное окно на системный ActionSheetIOS с поддержкой тёмной темы

Как установить expo-ios-hig

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill expo-ios-hig -a claude-code

2Вручную: положить файлы

~/.claude/skills/expo-ios-hig/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/expo-ios-hig/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об expo-ios-hig

Как установить expo-ios-hig в Claude Code?

Выполните в терминале команду npx skills add pproenca/dot-skills --skill expo-ios-hig -a claude-code.

Что делает скилл expo-ios-hig?

Он задаёт правила вёрстки экранов и навигации в Expo, чтобы интерфейс на TypeScript соответствовал рекомендациям Apple HIG и вёл себя как нативное приложение iOS.

Подойдёт ли этот скилл для нативной разработки на Swift?

Нет, он рассчитан строго на React Native и Expo с кодом на TypeScript; для нативного Swift автор рекомендует использовать скилл ios-hig.

Исходный текст

SKILL.md · MIT
---
name: expo-ios-hig
description: Expo / React Native iOS interface conforming to Apple Human Interface Guidelines (iOS 26) — native navigation (Expo Router native stack and tabs), platform controls (Alert, ActionSheetIOS, SF Symbols via expo-symbols), safe areas, dark mode, Dynamic Type, haptics, Liquid Glass, accessibility, and 60fps motion. Covers architecture and styling decisions made in React Native/TypeScript; for the @expo/ui SwiftUI component API use the expo-ui skill, and for native Swift use ios-hig. Trigger when building, reviewing, or refactoring such an app — even when the user does not say "HIG" or "native feel" but is writing TSX screens, navigation, lists, forms, or styling for iOS in Expo.
---
# Expo iOS HIG Best Practices

Design rules for building iOS 26 apps in **Expo (React Native)** that feel genuinely native under Apple's Human Interface Guidelines. Contains **46 rules across 8 categories**, prioritized by how much each decision affects native feel and HIG compliance. Every example is **TSX/Expo** — the decisions you make in React Native and TypeScript, not Swift.

The core idea: a React Native app feels native when it *reaches for the platform* — the system navigation controller, system controls, semantic colors, SF Symbols, real haptics, the system share sheet — instead of re-implementing iOS in JavaScript. These rules say which decision earns the native feel and which one quietly forfeits it.

## When to Apply

Reference these guidelines when:

- Building or reviewing iOS screens, navigation, lists, or forms in an Expo app
- Choosing navigation: Expo Router native stack vs JS stack, native tabs, sheets, modals, large titles
- Picking controls: when to use the native `Alert`, `ActionSheetIOS`, date picker, `Switch`, SF Symbols, or drop to `@expo/ui`
- Styling for the platform: safe areas, dark mode, semantic colors, the iOS type scale, spacing, Liquid Glass
- Making interaction feel native: touch targets, press feedback, swipe actions, pull-to-refresh, gestures, haptics
- Adding motion, loading/empty states, accessibility, permissions, and launch polish

## When NOT to Use This Skill

- **The `@expo/ui` component API** — for how to use `@expo/ui/swift-ui` components, Host boundaries, and modifiers, use the **`expo-ui`** skill. This skill says *which decisions* make an app native and points to `@expo/ui` when dropping to SwiftUI is the right call; it does not re-document that API.
- **The cross-platform design system itself** — for the shared Unistyles theme, design tokens, variant-driven component APIs, and making components feel native on **web** as well as iOS, use the **`expo-design-system`** skill. This skill governs iOS native feel; that one governs the token and component architecture that the two frontends share.
- **Native Swift / SwiftUI** — for HIG in a native Swift codebase, use **`ios-hig`** or **`ios-design`**. This skill's examples are all React Native/TSX.
- **Android** — these rules target iOS conventions. Use platform-adaptive code so Android gets Material; don't apply iOS idioms there.

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Native Navigation Architecture | CRITICAL | `nav-` |
| 2 | Native Component Fidelity | CRITICAL | `native-` |
| 3 | Layout & Adaptivity | HIGH | `layout-` |
| 4 | Touch, Gestures & Haptics | HIGH | `touch-` |
| 5 | Visual System & Liquid Glass | HIGH | `visual-` |
| 6 | Motion & Feedback | MEDIUM-HIGH | `motion-` |
| 7 | Accessibility | MEDIUM-HIGH | `acc-` |
| 8 | System Integration & Polish | MEDIUM | `system-` |

## Quick Reference

### 1. Native Navigation Architecture (CRITICAL)

- [`nav-native-stack`](references/nav-native-stack.md) — Use Expo Router's native Stack for screen hierarchy
- [`nav-native-tabs`](references/nav-native-tabs.md) — Adopt native tabs for top-level sections
- [`nav-large-titles`](references/nav-large-titles.md) — Enable large titles on top-level screens
- [`nav-sheet-detents`](references/nav-sheet-detents.md) — Present secondary tasks as sheets with detents
- [`nav-push-vs-present`](references/nav-push-vs-present.md) — Push for hierarchy and present for self-contained tasks
- [`nav-search-in-header`](references/nav-search-in-header.md) — Place search in the navigation bar
- [`nav-system-back`](references/nav-system-back.md) — Keep the system back button and swipe-back gesture

### 2. Native Component Fidelity (CRITICAL)

- [`native-avoid-material-ui`](references/native-avoid-material-ui.md) — Avoid Material Design component kits on iOS
- [`native-sf-symbols`](references/native-sf-symbols.md) — Use SF Symbols for iconography
- [`native-system-alert`](references/native-system-alert.md) — Use the native alert for confirmations
- [`native-action-sheet`](references/native-action-sheet.md) — Use an action sheet to choose among actions
- [`native-datetime-picker`](references/native-datetime-picker.md) — Use the native date and time picker
- [`native-switch-toggle`](references/native-switch-toggle.md) — Use the platform Switch for boolean settings

### 3. Layout & Adaptivity (HIGH)

- [`layout-safe-area-insets`](references/layout-safe-area-insets.md) — Respect safe-area insets with the safe-area context
- [`layout-edge-to-edge`](references/layout-edge-to-edge.md) — Extend scrollable content under translucent bars
- [`layout-keyboard-avoidance`](references/layout-keyboard-avoidance.md) — Keep inputs visible above the keyboard
- [`layout-dark-mode-semantic`](references/layout-dark-mode-semantic.md) — Drive colors from the active color scheme
- [`layout-content-inset-under-bars`](references/layout-content-inset-under-bars.md) — Inset list content past the tab bar and home indicator
- [`layout-readable-width-ipad`](references/layout-readable-width-ipad.md) — Constrain reading width on iPad and large screens

### 4. Touch, Gestures & Haptics (HIGH)

- [`touch-hit-target`](references/touch-hit-target.md) — Size touch targets to at least 44pt
- [`touch-pressable-feedback`](references/touch-pressable-feedback.md) — Give every control immediate press feedback
- [`touch-swipe-actions`](references/touch-swipe-actions.md) — Offer swipe actions on list rows
- [`touch-pull-to-refresh`](references/touch-pull-to-refresh.md) — Use RefreshControl for pull-to-refresh
- [`touch-gesture-handler-thread`](references/touch-gesture-handler-thread.md) — Drive interactive gestures with Gesture Handler
- [`touch-haptics-on-outcome`](references/touch-haptics-on-outcome.md) — Pair haptics with meaningful outcomes

### 5. Visual System & Liquid Glass (HIGH)

- [`visual-semantic-colors`](references/visual-semantic-colors.md) — Use semantic system colors instead of hardcoded hex
- [`visual-system-font`](references/visual-system-font.md) — Use the system font for interface text
- [`visual-type-scale`](references/visual-type-scale.md) — Map text styles to the iOS type scale
- [`visual-spacing-rhythm`](references/visual-spacing-rhythm.md) — Derive spacing from a single base unit
- [`visual-liquid-glass-gated`](references/visual-liquid-glass-gated.md) — Apply Liquid Glass through a version-gated native view
- [`visual-tint-discipline`](references/visual-tint-discipline.md) — Reserve the accent tint for interactive elements

### 6. Motion & Feedback (MEDIUM-HIGH)

- [`motion-ui-thread-animation`](references/motion-ui-thread-animation.md) — Run animations on the UI thread
- [`motion-virtualized-lists`](references/motion-virtualized-lists.md) — Render long lists with a virtualized list
- [`motion-loading-states`](references/motion-loading-states.md) — Show content-shaped placeholders while loading
- [`motion-empty-states`](references/motion-empty-states.md) — Design empty states that guide the next action
- [`motion-optimistic-updates`](references/motion-optimistic-updates.md) — Apply optimistic updates for user actions

### 7. Accessibility (MEDIUM-HIGH)

- [`acc-roles-labels`](references/acc-roles-labels.md) — Label interactive and icon-only controls for VoiceOver
- [`acc-dynamic-type`](references/acc-dynamic-type.md) — Let text scale with Dynamic Type
- [`acc-reduce-motion`](references/acc-reduce-motion.md) — Honor the Reduce Motion setting
- [`acc-state-and-hint`](references/acc-state-and-hint.md) — Expose control state to assistive technology
- [`acc-grouping-focus`](references/acc-grouping-focus.md) — Group related elements for a logical focus order

### 8. System Integration & Polish (MEDIUM)

- [`system-permissions-jit`](references/system-permissions-jit.md) — Request permissions just in time with a rationale
- [`system-status-bar`](references/system-status-bar.md) — Match the status bar style to the content behind it
- [`system-keyboard-type`](references/system-keyboard-type.md) — Configure each text field for its content
- [`system-share-sheet`](references/system-share-sheet.md) — Share through the system share sheet
- [`system-app-icon-launch`](references/system-app-icon-launch.md) — Configure a real app icon and launch screen

## How to Use

Read individual reference files for detailed explanations and code examples:

- [Section definitions](references/_sections.md) — Category structure and impact levels
- [Rule template](assets/templates/_template.md) — Template for adding new rules
- Reference files: `references/{prefix}-{slug}.md`

Each rule file contains a short explanation of *why* it matters for native feel, an **Incorrect** (non-native) TSX example, a **Correct** (native) example that is a minimal diff from it, and an authoritative reference URL. Where relevant, rules add a "When NOT to use this pattern" or "Alternative" section.

## Related Skills

- **`expo-ui`** — `@expo/ui/swift-ui` component API reference. Use it when the rules here point you to native SwiftUI components.
- **`ios-hig`** / **`ios-design`** — HIG and Apple design principles for native Swift/SwiftUI codebases.
- **`expo`** — Expo React Native performance optimization, complementary to the motion/list rules here.

© pproenca · MIT · pproenca/dot-skills

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →
expo-project-structure expo Скилл expo-project-structure для Claude Code задаёт структуру нового приложения Expo с Expo Router. Помогает разложить файлы по папкам при создании проекта. CX Codex +1 27 400установок expo sanjeed5 Задаёт стандарты разработки мобильных приложений на Expo: структуру папок, Expo Router, TypeScript и правила мемоизации. CX Codex +1 ★ 3 589звёзд репо ios-hig-design wondelai Скилл ios-hig-design для Claude Code и других платформ проектирует нативные iOS-интерфейсы по Human Interface Guidelines Apple. Покрывает Safe Areas, типографику, цвет, навигацию и SF Symbols. CX Codex +1 9 200установок expo-data-fetching expo Скилл expo-data-fetching настраивает сетевые запросы, кэширование и обработку ошибок в Expo. Помогает прописать состояния экранов и интеграцию с TanStack Query. CX Codex +1 34 300установок ios-hig-design-guide davepoon Скилл ios-hig-design-guide для Claude Code готовит спецификации интерфейсов iOS по Apple Human Interface Guidelines. Он включается для вопросов о компонентах, доступности и правилах взаимодействия. CX Codex +1 133установок expo-react-native-javascript-best-practices Mindrally Скилл expo-react-native-javascript-best-practices для Claude Code задаёт правила разработки на Expo и React Native с JavaScript: функциональные компоненты, Expo Router и ускорение рендеринга. CX Codex +1 821установок

Из того же набора139

Весь набор →
react-fetch-cache-patterns Скилл react-fetch-cache-patterns с 48 правилами для масштабируемой выборки и кеширования данных в React: от параллелизма запросов до защиты бэкенда, префетча и восстановления после ошибок. CX Codex +1 180установок react-19-component-scaffolder Скилл react-19-component-scaffolder для Claude Code создаёт TypeScript-файлы для компонентов и других частей React 19 по шаблонам. Задаёт структуру новой страницы, формы или хука. CX Codex +1 174установок web-rules Скилл web-rules задаёт 34 строгих правила вёрстки и UX для связки React 19, Next.js 16 и Tailwind CSS 4. Помогает строить доступные интерфейсы и проверять код на регрессии дизайна. CX Codex +1 173установок algorithmic-complexity-review Скилл algorithmic-complexity-review находит в коде причины роста времени и памяти: от вложенных циклов до N+1-запросов. Пригодится при ревью производительности и разборе медленных участков. CX Codex +1 171установок web-taste Скилл web-taste для ИИ-агента: сначала разобраться, кто пользователь и чего он хочет от экрана, и только потом писать JSX на React 19 и Next.js 16 с Tailwind. CX Codex +1 169установок typescript-advanced-patterns Скилл typescript-advanced-patterns для Claude Code содержит 40 правил по продвинутому TypeScript: type-level программированию, API библиотек и возможностям TS 5.x. Углубляет паттерны typescript-refactor. CX Codex +1 162установок react-hook-form-audit Скилл react-hook-form-audit ищет 16 антипаттернов React Hook Form в проекте Next.js на App Router и пишет markdown-отчёт с номерами строк. Только чтение, код не меняет. CX Codex +1 158установок codex-goals Скилл codex-goals для Codex помогает формулировать и проверять долгосрочные цели: задавать измеримый результат, способ проверки и условие остановки. Описывает постановку многошаговых задач с понятным финалом. CX Codex +1 158установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой