react-native-expo

React Native Expo

Expo SDK 52～56、Expo Router v4、EAS を対象としています。エコシステムライブラリ（state、Reanimated、React Navigation）については、react-native スキルを参照してください。shadcn/ui スタイルのコンポーネントについては、react-native-reusables スキルを参照してください。

Expo は React Native の上にフルスタックのツールチェーンを提供します。Expo Router によるファイルベースのルーティング、EAS によるクラウドビルド／デプロイのインフラストラクチャ、ネイティブモジュールを作成するための API、ファーストパーティライブラリを厳選した SDK が含まれます。このスキルでは、Expo レイヤーのみを扱います。

コアリファレンス

トピック	説明	リファレンス
Expo Router	ファイルベースのルーティング、レイアウト、ルートグループ、API ルート、SDK 56 への移行	core-expo-router
EAS の概要	EAS Build／Update／Submit／Deploy、eas.json の構造、バージョン管理	core-eas

機能

トピック	説明	リファレンス
EAS Build と Dev Client	ビルドプロファイル、Dev Client のセットアップ、ローカルビルド、デバイスへのインストール	features-eas-build
EAS Update と Deploy	OTA アップデート、EAS Hosting、CI/CD の YAML ワークフロー	features-eas-update-deploy
Expo Modules	create-expo-module、モジュール DSL、設定プラグイン	features-expo-modules
Expo SDK のアップグレード	アップグレードの流れ、キャッシュのクリア、SDK 53～56 の破壊的変更、モジュールの移行	features-upgrading

ベストプラクティス

トピック	説明	リファレンス
UI の構築	コードスタイル、expo-image、レスポンシブ対応、NativeTabs、ナビゲーションパターン	best-practices-ui
データ取得	fetch と React Query の使い分け、expo-secure-store、オフライン対応、環境変数	best-practices-data

主な推奨事項

• まず Expo Go を使う — Dev Client をビルドする前に npx expo start を使ってください。カスタムビルドが必要なのは、カスタムのネイティブコードを使う場合のみです。
• バージョンは EAS で管理する — 手動でのバージョン更新を避けるため、eas.json で appVersionSource: "remote" を設定してください。
• ファイルベースのルーティングを使う — ルートは app/ に配置します。コンポーネント、型、ユーティリティを app/ に同居させないでください。
• API ルートのシークレット — シークレットには eas env:create を使ってください。クライアント側の環境変数には EXPO_PUBLIC_ プレフィックスを使用します（ビルド時にインライン化されます）。
• SDK のアップグレード — アップグレード後は必ず npx expo install --fix、続けて npx expo-doctor を実行してください。デバッグの前にキャッシュをクリアしてください。