use-cases/react-native-expo-apps.md +105 −0 added
1---
2name: Build React Native apps with Expo
3tagline: Go from a mobile-app idea to a working Expo app with the dedicated plugin.
4summary: Use Codex with the Expo plugin to scaffold React Native apps, stay
5 inside Expo Router and Expo-native package conventions, test quickly with Expo
6 Go, and move to dev clients or EAS builds only when the app needs them.
7skills:
8 - token: expo
9 url: https://docs.expo.dev/skills/
10 description: Use Expo-authored skills for Expo Router UI, native-feeling
11 components, data fetching, dev clients, deployment, upgrades, modules, and
12 Codex Run action wiring.
13bestFor:
14 - Developers who want to prototype or ship a React Native app with Expo before
15 reaching for native IDE workflows.
16 - Expo Router projects where Codex should follow Expo conventions for routing,
17 UI, package installs, builds, and deployment.
18 - Developers that need to migrate a web app to a mobile app.
19starterPrompt:
20 title: Build the Expo App
21 body: >-
22 Use the Expo plugin to build a React Native app with Expo for this idea:
23
24
25 [describe the app idea, target users, and the main workflow]
26
27
28 Requirements:
29
30 - Start with Expo Router and Expo-native project conventions.
31
32 - Try `npx expo start` and Expo Go first before creating a custom build.
33
34 - Use `npx expo install` for Expo packages so dependencies stay compatible.
35
36 - Use native-feeling UI patterns for navigation, forms, lists, empty states,
37 and loading states.
38
39
40 Deliver:
41
42 - the working app slice
43
44 - the run command
45
46 - the verification path you used, including Expo Go, device, simulator, dev
47 client, or EAS
48 suggestedEffort: medium
49relatedLinks:
50 - label: Expo plugin
51 url: https://docs.expo.dev/skills/
52 - label: Expo MCP Server setup
53 url: https://docs.expo.dev/eas/ai/mcp/
54techStack:
55 - need: Mobile framework
56 goodDefault: "[Expo](https://expo.dev/) and [React Native](https://reactnative.dev/)"
57 why: Expo gives Codex a managed React Native path with fast iteration,
58 compatible packages, and deployment tooling.
59 - need: Routing
60 goodDefault: "[Expo Router](https://docs.expo.dev/router/introduction/)"
61 why: Expo Router keeps navigation file-based and predictable, which helps Codex
62 add screens and flows without inventing a custom routing layer.
63---
64
65## Start with Expo Go
66
67Expo is a strong default when you want Codex to move from a mobile-app idea to a
68tested React Native app. The useful loop is `expo start` first, Expo Go
69on a device next, and then a dev client or EAS build only when the app needs
70custom native code, store distribution, or a capability that Expo Go can't run.
71
72That keeps Codex focused on the app workflow instead of spending the first pass
73on native IDE setup, simulator setup, provisioning, or build configuration.
74
75## Use the Expo plugin
76
77Expo published an [Expo plugin](https://docs.expo.dev/skills/) that gives Codex Expo-native guidance for Expo Router, native UI, forms,
78navigation, animations, data fetching, NativeWind setup, Expo modules, dev
79clients, deployment, upgrades, and Codex Run action wiring.
80
81Use it when Codex is building new Expo screens, adding packages, wiring API
82calls, preparing a dev client, or getting an app ready for TestFlight, App
83Store, Play Store, or EAS Hosting.
84
85Optionally, add the [Expo MCP Server](https://docs.expo.dev/eas/ai/mcp/) when the task needs current
86Expo documentation lookup, compatible package installation, EAS build and
87workflow operations, screenshots, simulator interaction, React Native DevTools,
88or TestFlight data.
89
90## Iteration process
91
92
93
941. Ask Codex to inspect the repo and confirm whether it is a new Expo app or an
95 existing Expo project.
962. Start with Expo Router and Expo Go, and use `npx expo install` when adding
97 Expo packages.
983. Ask Codex to build one complete workflow with native-feeling navigation,
99 loading states, empty states, and error states.
1004. Verify on the fastest available path, such as Expo Go on a device or a
101 simulator, then move to a dev client or EAS only when needed.
102
103
104
105## Suggested follow-up prompt