Debugging Capacitor

This is the debugging reference you'll want open when your Capacitor app crashes or behaves strangely. It covers WebView debugging with Safari and Chrome DevTools, native debugging in Xcode and Android Studio, and walks through common failures like white screens, permission denials, and network issues. The quick reference table alone saves time when you forget which tool inspects what. What I appreciate is the diagnostic approach: it doesn't just list commands, it shows you how to trace crashes with adb logcat, intercept network requests to find CORS problems, and verify plugin registration when methods mysteriously disappear. The logging examples for both JavaScript and native code are ready to copy, and the troubleshooting section tackles real problems like ATS blocking HTTP requests on iOS.

skills.sh installs: 214
GitHub stars: 43
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add cap-go/capacitor-skills --skill debugging-capacitor --agent claude-code

Installs into .claude/skills of the current project.

Files

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".