Troubleshooting
Auto-discovery never finds the debugger
Check the desktop terminal for `[Inspector] mDNS service published`. Make sure phone and computer are on the same Wi-Fi. Corporate / guest Wi-Fi networks often block mDNS — fall back to manual wsUrl. Disable VPN. Verify the config plugin ran and the iOS Local Network permission dialog was accepted.
Module react-native-zeroconf not found
You're using auto-discovery without installing the native module. Run `npx expo install react-native-zeroconf`, then `npx expo prebuild` and rebuild the dev client. If you don't want a native rebuild, switch to manual wsUrl.
Connection refused
Make sure the desktop app is running. Confirm the device is on the same Wi-Fi. For manual mode, copy the IP from the desktop's header chip. Check the firewall for port 5051.
Requests not showing up
Enable debug: true on the agent. Look for `[NetworkAgent] Connected to inspector` in your app logs. Ensure you're in __DEV__. For custom axios instances, call `addAxiosInstance(yourClient)`.
Not working on emulator
For Android Emulator in manual mode, use 10.0.2.2 as the host. For iOS Simulator, localhost works. Auto-discovery is unreliable on some Android emulator host setups — prefer manual wsUrl there.