capawesome-team/capacitor-app-development
skills/capacitor-app-development/SKILL.md
Guides the agent through general Capacitor app development topics. Covers core concepts (native bridge, plugins, web layer), Capacitor CLI usage, app configuration (capacitor.config.ts, splash screens, app icons, deep links), platform management (Android, iOS, Electron, PWA), edge-to-edge and safe area handling on Android, live reload setup, storage solutions, file handling, security best practices, CI/CD references, iOS package managers (SPM, CocoaPods), and troubleshooting for Android and iOS. Do not use for creating new Capacitor apps, Capacitor plugin APIs, creating Capacitor plugins, in-app purchases, upgrading Capacitor versions, Cordova or PhoneGap migration, or framework-specific patterns (Angular, React, Vue).
$ install --global
skillsauthnpx skillsauth add capawesome-team/skills capacitor-app-developmentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 4:19 AM129.7s19 files scanned
SKILL.md
- name:
- capacitor-app-development
- description:
- Guides the agent through general Capacitor app development topics. Covers core concepts (native bridge, plugins, web layer), Capacitor CLI usage, app configuration (capacitor.config.ts, splash screens, app icons, deep links), platform management (Android, iOS, Electron, PWA), edge-to-edge and safe area handling on Android, live reload setup, storage solutions, file handling, security best practices, CI/CD references, iOS package managers (SPM, CocoaPods), and troubleshooting for Android and iOS. Do not use for creating new Capacitor apps, Capacitor plugin APIs, creating Capacitor plugins, in-app purchases, upgrading Capacitor versions, Cordova or PhoneGap migration, or framework-specific patterns (Angular, React, Vue).
- author:
- capawesome-team
- source:
- https://github.com/capawesome-team/skills/tree/main/skills/capacitor-app-development
Capacitor App Development
General guidance for developing cross-platform apps with Capacitor, covering core concepts, CLI usage, app configuration, platform management, and troubleshooting.
Prerequisites
- Capacitor 6, 7, or 8 app already created and initialized.
- Node.js and npm installed (Node 18+ for Cap 6, Node 20+ for Cap 7, Node 22+ for Cap 8).
- For Android: Android Studio installed.
- For iOS: Xcode installed on macOS.
Agent Behavior
- Auto-detect before asking. Inspect the project for platforms (
android/,ios/), framework (vite.config.ts,angular.json,webpack.config.js,next.config.js), Capacitor version (@capacitor/coreinpackage.json), and iOS dependency manager (ios/App/Podfilefor CocoaPods vs. SPM). - Route to the right reference file. Use the topic index below to identify the correct reference file and read it before providing guidance.
- One topic at a time. Address the user's specific question. Do not provide a general overview unless explicitly requested.
- Prefer actionable instructions. Provide exact file paths, commands, and diff blocks rather than conceptual explanations.
Procedures
Step 1: Identify the Topic
Match the user's request to a topic from the index below. If the request spans multiple topics, address them sequentially.
If the request matches a topic covered by a different skill, redirect the user to that skill (see Related Skills at the bottom).
Step 2: Analyze the Project
Auto-detect the following by reading project files:
- Capacitor version: Read
@capacitor/coreversion frompackage.json. - Platforms: Check which directories exist (
android/,ios/). - Framework: Check for build tool config files.
- Capacitor config format: Check for
capacitor.config.tsorcapacitor.config.json. - iOS dependency manager: Check for
ios/App/Podfile(CocoaPods) or SPM usage.
Step 3: Read the Reference File and Apply Guidance
Read the reference file for the matched topic and apply the instructions to the user's project.
Topic Index
| Topic | Reference |
| ----- | --------- |
| Core concepts (native bridge, how Capacitor works) | references/core-concepts.md |
| Capacitor platforms (Android, iOS, Electron, PWA) | references/platforms.md |
| Capacitor CLI commands | references/cli.md |
| App configuration (capacitor.config.ts) | references/app-configuration.md |
| Splash screens and app icons | references/splash-screens-and-icons.md |
| Deep links and universal links | references/deep-links.md |
| Android edge-to-edge support | references/edge-to-edge.md |
| Android safe area handling | references/safe-area.md |
| Live reload setup | references/live-reload.md |
| Storage solutions | references/storage.md |
| File handling best practices | references/file-handling.md |
| Security best practices | references/security.md |
| iOS package managers (SPM, CocoaPods) | references/ios-package-managers.md |
| CI/CD for Capacitor apps | references/ci-cd.md |
| Testing (unit and E2E) | references/testing.md |
| Cross-platform best practices | references/cross-platform-best-practices.md |
| Android troubleshooting | references/troubleshooting-android.md |
| iOS troubleshooting | references/troubleshooting-ios.md |
Error Handling
npx cap syncfails: Verify@capacitor/coreand@capacitor/cliversions match. On iOS with CocoaPods, runcd ios/App && pod install. On Android, sync Gradle files in Android Studio.- Android build fails after configuration changes: Clean the build with
cd android && ./gradlew clean, then rebuild. - iOS build fails after configuration changes: Clean the build folder in Xcode (Product > Clean Build Folder) or delete
ios/App/Podsand runcd ios/App && pod install. - Plugin not found at runtime: Run
npx cap syncafter any plugin installation. Verify the plugin appears incapacitor.configor the native project. - Live reload not connecting: Verify the device and development machine are on the same network. Check that the server URL in
capacitor.configuses the correct LAN IP address. - Deep links not working: Verify the site association file is accessible at
https://<domain>/.well-known/apple-app-site-association(iOS) orhttps://<domain>/.well-known/assetlinks.json(Android). Verify the app is signed with the correct certificate.
Related Skills
capacitor-app-creation— Create a new Capacitor app.capacitor-angular— Angular-specific Capacitor development.capacitor-react— React-specific Capacitor development.capacitor-vue— Vue-specific Capacitor development.capacitor-plugins— Install and configure Capacitor plugins.capacitor-plugin-development— Create custom Capacitor plugins.capacitor-app-upgrades— Upgrade Capacitor to a newer major version.capacitor-in-app-purchases— Set up in-app purchases.capawesome-cloud— Cloud builds, live updates, and app store publishing.
Related Skills
capawesome-team/ionic-expert
tools
VerifiedTrustedCommunity
A comprehensive starting point for AI agents to work with the Ionic Framework. Covers core concepts, components, CLI, theming, layout, lifecycle, navigation, and framework-specific patterns for Angular, React, and Vue. Pair with the other Ionic skills in this collection for deeper topic-specific guidance like app creation, framework integration, and upgrades.
27SKILL.mdUpdated May 2, 2026
capawesome-team/capawesome-cloud
tools
VerifiedTrustedCommunity
Guides the agent through setting up and using Capawesome Cloud for Capacitor and Cordova apps. Covers three core workflows: (1) Native Builds — cloud builds for iOS and Android (Capacitor, Cordova, or native projects), signing certificates, environments, Trapeze configuration, and build artifacts; (2) Live Updates — OTA updates via the @capawesome/capacitor-live-update or @capawesome/cordova-live-update plugin, channels, versioning, rollbacks, and code signing; (3) App Store Publishing — automated submissions to Apple App Store (TestFlight) and Google Play Store. Includes CI/CD integration for all workflows. Do not use for non-Capacitor, non-Cordova mobile frameworks such as React Native or Flutter.
27SKILL.mdUpdated May 2, 2026
capawesome-team/capawesome-cli
tools
VerifiedTrustedCommunity
Guides the agent through installing, authenticating, configuring, and using the Capawesome CLI (@capawesome/cli). Covers installation, interactive and token-based authentication, project linking via capawesome.config.json, the full command reference (app management, native builds, live updates, certificates, environments, channels, deployments, destinations, devices), CI/CD integration with token auth and JSON output, and diagnostics via the doctor command. Do not use for Capawesome Cloud feature setup (native builds workflow, live updates workflow, app store publishing) — use the capawesome-cloud skill instead.
27SKILL.mdUpdated May 2, 2026
capawesome-team/capacitor-expert
tools
VerifiedTrustedCommunity
A comprehensive starting point for AI agents to work with Capacitor. Covers core concepts, CLI, app creation, plugins, framework integration, best practices, storage, security, testing, troubleshooting, upgrading, and Capawesome Cloud (live updates, native builds, app store publishing). Pair with the other Capacitor skills in this collection for deeper topic-specific guidance.
27SKILL.mdUpdated May 1, 2026