simiancraft/simiancraft-skills / skills/expo-ios-simulator
expo-ios-simulator
VerifiedRun and drive an Expo / React Native app on the iOS Simulator. Pick an execution mode (Expo Go, dev client, Storybook-mobile, web-on-mobile), build and install a dev client, and clear the recurring Expo/RN prompts that block automation: the push-token alert that stacks until the overlay darkens the screen, the "Open in app?" deep-link dialog, the dev menu, and the element-inspector trap. Sits ON TOP of ios-simulator; failures route to ios-simulator-triage. Project-agnostic; discovers bundle id and scheme from the app config. Use for "run my Expo app on the simulator", "load a dev client", or "drive Storybook on iOS".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.8 KB |
| references/development-builds.md | markdown | 4.4 KB |
| references/execution-modes.md | markdown | 2.1 KB |
| references/expo-go.md | markdown | 3.2 KB |
| references/known-prompts.md | markdown | 5.3 KB |
references/execution-modes.md
View on GitHub---
title: Execution modes
summary: the four ways to run an Expo app on the simulator (Expo Go, a dev client, Storybook-mobile, web-on-mobile), what each is, and when to use it
status: complete
sources:
- https://docs.expo.dev/guides/local-app-development/ (npx expo run:ios; local dev builds)
- "xcrun simctl help openurl (web-on-mobile) and the STORYBOOK_ENABLED env gate (observed; project-defined)"
- https://docs.expo.dev/develop/development-builds/introduction/ (development builds vs Expo Go)
---
# Execution modes
Reference for **expo-ios-simulator**. There are four ways to put an Expo app in front
of you on the simulator. Pick by what the app needs, then follow the linked file.
## Expo Go
The prebuilt Expo client app from the App Store, driven by `npx expo start` (no
`--dev-client`). It runs only the Expo SDK; an app with **custom native modules cannot
run in Expo Go**. Use it for a pure-JS prototype. Details and limits: `expo-go.md`.
## Development build (dev client)
A custom build of the app with its own native modules; the normal mode for a real
app. Build and install it, then serve Metro with `npx expo start --dev-client`. The
build path, Metro, and the connect deep link are in `development-builds.md`.
## Storybook for mobile
The React Native Storybook UI rendered inside the dev client, for working on a
component in isolation. When the project wires RN Storybook behind an env flag (often
`STORYBOOK_ENABLED`), start Metro with that flag set and reload the dev client; it
loads the Storybook UI instead of the app. The flag and entry are project-defined, so
check the project's `metro.config`/`app.config`.
## Web on mobile
Not the native app: a URL opened in mobile Safari with
`xcrun simctl openurl booted https://...`. Use it to view a web build on the device or
to confirm a universal link; deep links into the app use the app's scheme instead. See
**ios-simulator** `references/simulator-ui.md`.
## See also
- `expo-go.md`: the Expo Go path and its native-module limits.
- `development-builds.md`: building and connecting a dev client.
- **ios-simulator** `references/simulator-ui.md`: opening a URL on the device.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |