Claude MarketplacesSubmit
cap-go avatar

Debugging Capacitor

cap-go/capgo-skills

This is the debugging reference you'll want when your Capacitor app is misbehaving. It covers the full stack: Safari Web Inspector and Chrome DevTools for WebView debugging, Xcode and Android Studio for native code, and practical solutions for the usual suspects like startup crashes, missing plugins, and permission errors. The quick reference tables are handy, and the logging examples for both JavaScript and native sides save you from searching docs mid-debug. What I appreciate is it doesn't just list tools, it shows you the actual LLDB commands, logcat filters, and config tweaks you need. The network debugging section alone, with ATS and cleartext setup, will save you an hour of head-scratching.

skills.sh installs
1.4K
GitHub stars
77
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add cap-go/capgo-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".
SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/cap-go/capgo-skills
Categories
Documentation, Debugging, Mobile Development
First seen
Jun 3, 2026

More from cap-go/capgo-skills

All 41

Recommended

More Documentation
1jezweb avatarsocial-media-postsjezweb/claude-skillsCreate platform-specific social media posts for LinkedIn, Facebook, Instagram, and Reddit. Handles character limits, hashtag strategies, hook placement, and ima1.4Kskills.sh installs
2mapbox avatarmapbox-maplibre-migrationmapbox/mapbox-agent-skillsGuide for migrating from MapLibre GL JS to Mapbox GL JS, covering API compatibility, token setup, style configuration, and the benefits of Mapbox's official sup1.4Kskills.sh installs
3ant-design avatarantdant-design/antd-skillUse when the user's task involves Ant Design (antd) — writing antd components, debugging antd issues, querying antd APIs/props/tokens/demos, migrating between a1.4Kskills.sh installs
4huggingface avatarhuggingface-zerogpuhuggingface/skillsAI demos and GPU compute with Gradio Spaces and Hugging Face Spaces ZeroGPU. Use when writing or reviewing code that uses `@spaces.GPU`, configuring `python_ver1.4Kskills.sh installs
5vercel-labs avatarskill-creatorvercel-labs/json-renderGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabil1.4Kskills.sh installs
6charleswiltgen avataraxiom-testingcharleswiltgen/axiomUse when writing ANY test, debugging flaky tests, making tests faster, or choosing Swift Testing vs XCTest. Covers unit tests, UI tests, async testing, test arc1.4Kskills.sh installs