debugging-capacitor

Guide WebView, native, and network debugging for Capacitor apps.

58|5|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/Cap-go/capgo-skills --skill debugging-capacitor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-capacitor
Source: https://github.com/Cap-go/capgo-skills/tree/main/skills/debugging-capacitor
Command: npx skills add https://github.com/Cap-go/capgo-skills --skill debugging-capacitor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers struggle to quickly diagnose issues across WebView, native, and network layers in Capacitor apps. This guide consolidates debugging workflows to reduce time-to-resolution and improve app stability.

Core Features & Use Cases

  • WebView inspection and live debugging on iOS and Android.
  • Native debugging with Xcode and Android Studio, plus crash analysis and log collection.
  • Network inspection and issue reproduction across environments for reliable fixes.

Quick Start

Open the debugging-capacitor skill and follow the step-by-step guide to attach the appropriate debuggers and gather logs to diagnose issues.

Frequently Asked Questions about debugging-capacitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a Capacitor app that crashes on iOS or Android?

To debug a native Capacitor crash, you must configure native debugging environments like Xcode or Android Studio to set breakpoints and collect crash logs. This allows you to isolate the exact native code causing the failure.

What is the best way to inspect a WebView in a Capacitor app?

Inspecting a WebView in a Capacitor app involves using browser developer tools to attach to the running application on iOS or Android. This provides live debugging capabilities for JavaScript and DOM elements within the WebView layer.

How do I troubleshoot network issues in a Capacitor application?

Troubleshooting network issues in Capacitor requires performing network inspection to monitor requests and reproduce issues across different environments. This ensures you can reliably replicate the behavior and apply a deterministic fix.

Can I use Xcode and Android Studio for Capacitor live debugging?

Yes, you can use Xcode and Android Studio for live debugging in Capacitor apps to analyze native crashes and collect logs. These environments support native breakpoints, allowing you to step through native code execution directly.

Why does my Capacitor app show unexpected behavior across different layers?

Unexpected behavior in Capacitor often stems from issues spanning the WebView, native, and network layers. You must perform structured end-to-end debugging and log analysis across these layers to identify the root cause.

What are the limitations of debugging a Capacitor app without structured logs?

Debugging a Capacitor app without structured logs limits your ability to reliably replicate and resolve crashes or performance issues. It prevents deterministic step-by-step analysis, increasing the time-to-resolution for app instability.