skills.rest
gaomingzhao666
gaomingzhao666COMMUNITY
Explore all skills by this author →
WebsiteGitHub

debugging-capacitor

Diagnose WebView, native, network, and crash issues in Capacitor iOS and Android apps.

2|1|Updated Aug 14, 2026
Search Tags:#debugging#ios#mobile development#android#webview#crash analysis#capacitor
One-click install
npx skills add https://github.com/gaomingzhao666/capacitor-native-navigation-bar --skill debugging-capacitor-gaomingzhao666
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debugging-capacitor
Source: https://github.com/gaomingzhao666/capacitor-native-navigation-bar/tree/main/.claude/skills/debugging-capacitor
Command: npx skills add https://github.com/gaomingzhao666/capacitor-native-navigation-bar --skill debugging-capacitor-gaomingzhao666

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging Capacitor apps requires switching between WebView tools, native debuggers, and log streams across iOS and Android, and developers often don't know which tool to reach for or how to interpret common failures like white screens, missing plugins, or blocked network requests. ## Core Features & Use Cases - WebView Debugging: Step-by-step setup for Safari Web Inspector on iOS and Chrome DevTools on Android, including the webContentsDebuggingEnabled config required on iOS 16.4+. - Native Debugging & Crash Analysis: Xcode LLDB commands, Android Studio debugger attach, logcat filtering, and crash log retrieval for both platforms. - Common Issue Playbooks: Diagnosis and fixes for startup crashes, "plugin not implemented" errors, ATS/cleartext network blocks, permission denials, white screens, and broken deep links. - Use Case: A user reports the app shows a white screen after launch. The skill walks through checking the WebView console, verifying the webDir build output, and re-running npx cap sync to resolve it. ## Quick Start Ask the assistant to help debug why your Capacitor app crashes on startup on Android, and it will walk you through logcat inspection and the fix checklist.

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 WebView on iOS and Android?▼

On iOS, enable Web Inspector in Safari settings on the device, set webContentsDebuggingEnabled in capacitor.config, then use Safari's Develop menu. On Android, enable the same config flag and inspect via chrome://inspect in Chrome.

Why does my Capacitor app show a white screen on launch?▼

A white screen usually means the web assets failed to load. Check the WebView console for JavaScript errors, verify the dist folder exists and webDir in capacitor.config.ts points to it, then rebuild and run npx cap sync.

How do I fix the 'plugin is not implemented' error in Capacitor?▼

This error means the native side of the plugin is missing. Confirm the plugin is installed via npm, run npx cap sync to copy it into the native projects, and verify it appears in Capacitor.Plugins at runtime.

Why are network requests failing in my Capacitor app?▼

iOS App Transport Security blocks plain HTTP unless NSAllowsArbitraryLoads is set in Info.plist, and Android blocks cleartext traffic unless cleartext is enabled in the server config. CORS issues can be bypassed using CapacitorHttp for native requests.

How do I view native crash logs for a Capacitor app?▼

On iOS, open Xcode's Devices and Simulators window and select View Device Logs, or stream logs with xcrun simctl. On Android, run adb logcat and filter for fatal or crash entries to find the stack trace.

Can I detect memory leaks in a Capacitor app?▼

Yes. Use Chrome DevTools heap snapshots for JavaScript leaks, Xcode Instruments with the Leaks template for iOS native memory, and LeakCanary added as a debug dependency for Android.

Related Skills

Explore More Software Engineering Skills→
hamza-sahinhamza-sahin

capacitor-app-upgrades

Upgrade Capacitor app projects across major versions with validated migration steps.

Community
Advanced
ajianazajianaz
4

mobile-devops

Orchestrate mobile DevOps workflows for iOS and Android builds, tests, and deployments.

Community
Advanced
chicanoandres702chicanoandres702

error-diagnostics-error-trace

Implement error tracking and observability across web apps, APIs, and background jobs.

Community
Advanced
AbsolutelySkilledAbsolutelySkilled
207

debugging-tools

Diagnoses multi-software bugs across browsers, servers, and native apps using Chrome DevTools, strace, lldb, curl, and memory profiling.

Official
Advanced