| name | mobile-debugging |
| description | Use for React Native / Expo troubleshooting (Metro bundler, native modules, simulator/emulator issues). |
Workflow
- Capture the exact error and environment (RN/Expo version, platform, device).
- Separate concerns:
- bundler issues (Metro)
- native build issues (Xcode/Gradle)
- runtime issues (permissions, network, JS exceptions)
- Reproduce with the smallest command set (e.g., one
expo start/npx react-native run-*). - Validate configuration files and dependencies align with the chosen workflow.
- Apply minimal change; re-run the exact failing path.
Common checks
- Clear caches only after capturing logs (e.g., Metro/Gradle).
- Confirm environment variables and platform-specific config are consistent.