What problem does it solve?
This Skill helps you get a React Native app running and keeps it running by providing a reliable workflow for starting Metro, building/installing on simulators/emulators, and diagnosing common build and runtime failures.
Core Features & Use Cases
- Metro-first workflow: Prevents port conflicts and ensures the app connects to the correct running Metro instance before launching the app.
- Build and runtime troubleshooting: Guides cleanup steps for common failures (e.g., xcodebuild exit code 65, CocoaPods issues, cache resets) and tells you when to stop guessing and ask for clarification.
- Runtime debugging and testing: Directs you to the right tools to inspect logs, component trees, screenshots, evaluate JS, and run unit/E2E tests (when configured).
Use Case: You changed native iOS dependencies and the app fails to build; follow the workflow to reset caches, reinstall pods correctly, rebuild using the right iOS workspace, and then use the provided runtime debugging tools if the build succeeds but the app crashes.
Quick Start
Follow the workflow to start Metro safely, then run the iOS simulator or Android emulator from the project root using the repo’s custom npm/yarn scripts and tool-assisted checks.