debugging-expo-simulators

Diagnose Expo Go and React Native failures on iOS Simulator and Android Emulator.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/shoshoavi/agentic_worflows --skill debugging-expo-simulators-shoshoavi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debugging-expo-simulators
Source: https://github.com/shoshoavi/agentic_worflows/tree/main/cursor/skills/debugging-expo-simulators
Command: npx skills add https://github.com/shoshoavi/agentic_worflows --skill debugging-expo-simulators-shoshoavi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? React Native apps often work on real devices but fail in iOS Simulator or Android Emulator due to corporate proxies, Zscaler TLS inspection, stale Expo Go state, or flaky emulator images, and this Skill provides a structured triage flow to isolate the environment as the root cause instead of rewriting app code. ## Core Features & Use Cases - Environment-first triage: Separates app-code bugs from simulator, proxy, and TLS issues by comparing real-device behavior against simulator behavior. - Corporate proxy and Zscaler handling: Walks through checking macOS proxy state with scutil and trusting the Zscaler root CA inside the iOS Simulator keychain. - Safe network diagnostics: Shows how to wrap global.fetch around a Supabase client to log method, host, status, and errors without leaking tokens or headers. - Use Case: Your Expo app logs in fine on a physical iPhone but throws "TypeError: Network request failed" on the iOS Simulator behind a corporate Zscaler network; this Skill guides you to trust the root CA in the simulator and request a no-inspect rule for *.supabase.co. ## Quick Start Ask the assistant to debug why your Expo app fails with a network request error on the iOS Simulator while working on a real device.

Frequently Asked Questions about debugging-expo-simulators

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Network request failed in Expo on iOS Simulator?▼

Network request failed on iOS Simulator usually indicates a transport or TLS problem, not bad credentials. Check macOS proxy state with scutil --proxy, then trust your corporate root CA in the simulator using xcrun simctl keychain booted add-root-cert and reboot the simulator.

How to trust a Zscaler root certificate in iOS Simulator?▼

Export the Zscaler Root CA from the macOS System keychain with security find-certificate, then add it to the booted simulator with xcrun simctl keychain booted add-root-cert. Shut down all simulators afterward and retest the app.

Why does my Expo app work on a real device but fail on the simulator?▼

Real devices and simulators use different network and trust paths, so simulator-only failures point to the environment: Expo Go state, device image, proxy, or TLS trust. Treat the simulator stack as the suspect before changing app code or environment variables.

Does NODE_TLS_REJECT_UNAUTHORIZED=0 fix Expo Go network errors?▼

No, NODE_TLS_REJECT_UNAUTHORIZED=0 only affects Node.js processes running on the Mac. It does not change TLS behavior inside Expo Go, the iOS Simulator, or other native mobile traffic.

Which Android emulator image is best for Expo network testing?▼

Prefer stable Google Play ARM64 images on API 35 or 36 for Expo testing. Android preview emulator images are flaky for TLS and networking and can produce misleading failures.

Why do taps stop responding in Expo Go on iOS Simulator?▼

Stuck taps that wake up after pressing m indicate stale Expo Go or simulator input state, sometimes related to RTL settings. Fully restart Expo Go and the Simulator, and avoid forcing global RTL at app startup on iOS.