Debugging Capacitor Apps

Find which layer is broken (web, bridge, native, OS config), prove it with the right inspector, then fix the smallest thing.

When to Use

TRIGGER when:

• App shows a white/blank screen, crashes on launch, or freezes after a native call.
• Error "<Name>" plugin is not implemented on ios|android or "<Name>.<method>()" is not implemented on ....
• Network calls fail on device only: net::ERR_CLEARTEXT_NOT_PERMITTED, ATS "requires the use of a secure connection", CORS errors.
• Permission prompts never appear or always deny.
• Live reload (cap run --url, server.url) shows a blank page or "Webpage not available".
• After updating to Capacitor 8.5+ / Xcode 27: appUrlOpen silent, universal links open the app but do nothing, JS pause/resume or custom AppDelegate code no longer runs.
• User asks "how do I debug / inspect my Capacitor app".