capacitor-app-development

Guides Capacitor app development across configuration, platforms, storage, security, and troubleshooting.

1|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/involvex/ionic-everywhere --skill capacitor-app-development-involvex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: capacitor-app-development
Source: https://github.com/involvex/ionic-everywhere/tree/main/.agents/skills/capacitor-app-development
Command: npx skills add https://github.com/involvex/ionic-everywhere --skill capacitor-app-development-involvex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Developing cross-platform apps with Capacitor involves many moving parts—native bridge concepts, CLI commands, platform-specific configuration, safe area handling, and platform-specific build failures. This Skill routes each question to the correct reference guide and applies concrete, project-aware instructions instead of generic advice. ## Core Features & Use Cases - Topic-Routed Guidance: Matches user questions to 18 reference files covering core concepts, CLI usage, app configuration, splash screens, deep links, edge-to-edge, live reload, storage, file handling, security, CI/CD, testing, and troubleshooting. - Project Auto-Detection: Inspects package.json, platform directories, and config files to detect Capacitor version, installed platforms, framework, and iOS dependency manager (SPM vs CocoaPods) before answering. - Actionable Fixes: Provides exact file paths, commands, and diff blocks for issues like Gradle sync failures, blank screens, plugin-not-found errors, and iOS signing problems. - Use Case: An Android build fails after changing capacitor.config.ts—the Skill detects the Capacitor version, reads the Android troubleshooting reference, and walks through cleaning the Gradle build and verifying JDK versions. ## Quick Start Ask the agent how to configure deep links, fix an Android build error, or set up live reload in your existing Capacitor project.

Frequently Asked Questions about capacitor-app-development

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

FAQPage Schema
How do I set up deep links in a Capacitor app?

Deep links use Universal Links on iOS and App Links on Android, both requiring HTTPS domain verification files. Host an apple-app-site-association file and assetlinks.json on your domain, add the associated domain entitlement in Xcode, add an autoVerify intent filter in AndroidManifest.xml, and listen for the appUrlOpen event from @capacitor/app.

How do I enable live reload on a physical device with Capacitor?

Run npx cap run android --live-reload or npx cap run ios --live-reload with the device on the same Wi-Fi network as your machine. Alternatively, set server.url in capacitor.config.ts to your LAN IP with cleartext enabled, then run npx cap copy and deploy.

Should I use SPM or CocoaPods for Capacitor iOS dependencies?

SPM is the default for new Capacitor 8 projects and requires no extra tooling, while CocoaPods is the legacy default for Capacitor 7 and earlier. Check whether all your plugins support SPM by looking for a Package.swift file; if any dependency lacks SPM support, stay on CocoaPods.

Why does my Capacitor app show a blank screen on Android?

A blank screen usually means web assets were not synced, webDir in capacitor.config.ts does not match your build output, or a JavaScript error occurred at runtime. Run npx cap sync android, verify webDir, and inspect the WebView console via chrome://inspect.

What storage should I use instead of localStorage in Capacitor?

Use @capacitor/preferences for small key-value data, since localStorage can be evicted by the OS, especially on iOS. For sensitive data like tokens use encrypted storage such as @capawesome-team/capacitor-secure-preferences, and use SQLite plugins for large relational datasets.

When should I not use this Capacitor development guidance?

This guidance does not cover creating new Capacitor apps, building custom plugins, in-app purchases, version upgrades, Cordova migration, or framework-specific patterns for Angular, React, or Vue. Those topics are handled by separate dedicated skills.