Debugging

Debug your WebView miniapp using browser DevTools.

Android: Chrome Remote Debugging

  1. Enable USB Debugging on your Android device
  2. Connect device via USB cable
  3. Open Chrome and navigate to chrome://inspect/#devices
  4. Find your WebView under "Remote Targets"
  5. Click "inspect" to open DevTools
chrome://inspect screenshot
adb reverse tcp:3000 tcp:3000
Forward local dev server to device

iOS: Safari WebInspector

  1. On iPhone: Settings → Safari → Advanced → Web Inspector → ON
  2. Connect to Mac via USB
  3. On Mac: Safari → Develop menu → [Your Device] → [WebView]
Make sure Safari's Develop menu is enabled: Safari → Settings → Advanced → Show features for web developers

Common Issues

IssueCauseFix
SDK not initializingNot in WebView contextTest in sandbox app
console.log not showingWrong target selectedRecheck Remote Targets
CORS errorDev server not forwardedRun adb reverse