
capacitor-core
Core Capacitor skills for best practices, plugin selection, and MCP automation.
- version
- 1.0.0
- GitHub stars
- 79
Install
/plugin install capacitor-core@capgo-skillsRun it inside Claude Code after adding the marketplace with /plugin marketplace add Cap-go/capgo-skills.
Contents
Discovered from sourceSkills 3
Capacitor Best Practices
Review a Capacitor app for structural mistakes that cause broken builds, lost edits, production leaks, and plugin crashes. Route deep topics to the sibling skill that owns them.
When to Use
Use the selected project and its installed dependencies. Package installation and migration tools execute code; limit them to the requested setup or upgrade, preserve the lockfile and existing changes, and review generated edits before running changed build scripts.
TRIGGER when:
- The user asks for a general code/architecture review of a Capacitor or Ionic + Capacitor app.
- Setting up a new Capacitor project or adding iOS/Android to an existing web app.
capacitor.config.ts|jsonreview:webDir,server.url,cleartext, plugin config, env-specific config.- Version drift between
@capacitor/core,@capacitor/cli,@capacitor/ios,@capacitor/android, or plugin majors that do not match Capacitor's major. - Plugin usage review: missing
npx cap sync, no availability check, no permission flow, matching on error message strings. - Errors such as
"<Plugin>" plugin is not implemented on ios,Could not find the web assets directory,ios platform has not been added yet. - Pre-release sanity checklist across config, native projects, and live updates.
Do not use:
- Security audit, secrets, storage, pinning, CSP ->
capacitor-security; Xcode hardening ->capacitor-ios-security-hardening. - Bundle size, startup time, memory, bridge profiling ->
capacitor-performance. - Unit/E2E test setup and plugin mocking ->
capacitor-testing. - Crashes, white screen, native logs ->
debugging-capacitor,ios-android-logs. - Major upgrades ->
capacitor-app-upgrades(8 -> 9:capacitor-app-upgrade-v8-to-v9). - CocoaPods -> SPM ->
cocoapods-to-spm; UIScene adoption ->capacitor-uiscene-migration. - Finding or installing a specific plugin ->
capacitor-plugins. - Store submission and review ->
capacitor-app-store,capacitor-apple-review-preflight; CI ->capacitor-ci-cd; live updates ->capgo-live-updates.
Current baseline (October 2026)
Capacitor 8 (stable, latest 8.5.x) | Capacitor 9 (next, alpha) | |
|---|---|---|
| Node | 22+ | 24+ |
| iOS min / Xcode | iOS 15 / Xcode 26 (8.5 adopts UIScene so Xcode 27 builds work) | iOS 16 / Xcode 27+ |
| Android | minSdk 24, compile/target 36, AGP 8.13, Gradle 8.14.3 | minSdk 26, compile/target 37, AGP 9.2.1, Gradle 9.5.1 |
| iOS deps | SPM default for new projects | SPM default |
CocoaPods Trunk is expected to go read-only on December 2, 2026. Recommend SPM for every app still on CocoaPods. Install Capacitor 9 only with @next until it reaches GA, and do not recommend it for production apps.
Review workflow
- Inventory (read-only).
npx cap doctor # installed vs latest Capacitor packages npx cap ls # plugins Capacitor detects per platform cat capacitor.config.ts 2>/dev/null || cat capacitor.config.json ls ios/App/Podfile ios/App/CapApp-SPM 2>/dev/null # CocoaPods or SPM grep -nE "minSdkVersion|compileSdkVersion|targetSdkVersion" android/variables.gradle - For large codebases, write a TODO list of areas (config, versions, plugins, native iOS, native Android, live updates, release) and review one at a time.
- Report findings before editing, grouped by severity, each with file:line and the fix. Ask before invasive changes (upgrading a major, migrating to SPM, enabling R8, changing
appId). - Fix, loading the matching reference.
- Run Verification.
Rules that matter most
- Keep Capacitor packages on one version.
@capacitor/core,cli,ios,androidmust match. Plugin majors must match the Capacitor major (official and@capgo/*plugins follow it: v8 plugins for Capacitor 8). npx cap syncafter every plugin install/removal and every config change. Missing sync produces"<Plugin>" plugin is not implemented on <platform>.- Never edit generated web assets.
android/app/src/main/assets/public/andios/App/App/public/are overwritten bycap copy/sync. Editsrc/and rebuild. - Commit
ios/andandroid/. They are source code with your native customizations, not build output. Do commitcapacitor.config.*; do not commitnode_modules,Pods/, build dirs. - No dev settings in release config.
server.url,server.cleartext,allowNavigationto dev hosts,webContentsDebuggingEnabled: true. Gate them on an env var (see references/config-and-project.md). On Capacitor 9, usenpx cap run <platform> --url <dev-url>for live reload. - Feature-detect before calling plugins.
Capacitor.isNativePlatform(),Capacitor.getPlatform(),Capacitor.isPluginAvailable('Name'). Provide a web fallback or hide the feature. - Use the permission API. Call
checkPermissions()thenrequestPermissions()for official plugins that expose them, and handledeniedwith a path to Settings. Add the matchingNS*UsageDescriptionkeys / Android permissions. - Branch on
error.code, noterror.message. Messages change between versions and platforms. Official plugins expose structured codes (for exampleOS-PLUG-CAMR-0006for a cancelled camera capture in@capacitor/camera8.1+ new APIs); Capacitor core usesUNIMPLEMENTED/UNAVAILABLE. - Move large binary data as files, not base64. Pass file paths/URIs across the bridge and render with
Capacitor.convertFileSrc(). - iOS lifecycle is scene-based from Capacitor 8.5. After adopting UIScene, AppDelegate
application(_:open:options:),continue userActivity, and foreground/background callbacks stop firing. Move custom native code toSceneDelegate(capacitor-uiscene-migration). AvoidUIScreen.mainand idiom-based layout for resizable windows. - Live updates: call
CapacitorUpdater.notifyAppReady()on every launch, and apply manual updates withnext()(on background/relaunch) rather thanset()mid-session. Details incapgo-live-updates. - Secrets never go in the app. Anything in the bundle or
capacitor.configis extractable. Hand off tocapacitor-securityfor anything beyond this rule.
References
Only load a reference when its topic is in play.
| Reference | Load when |
|---|---|
| references/config-and-project.md | Reviewing capacitor.config, env-specific builds, repo layout, .gitignore, version alignment |
| references/plugins.md | Plugin install/sync, availability checks, permissions, error codes, web fallbacks, lazy loading, mocking |
| references/native-projects.md | iOS SPM vs CocoaPods, UIScene, deployment targets; Android variables.gradle, R8, Capacitor 9 Gradle changes |
| references/release-checklist.md | Preparing a release build or reviewing release readiness |
Verification
# Versions aligned (all @capacitor/* core packages show the same version)
npm ls @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android
npx cap doctor
# Web build exists where webDir points, then sync succeeds without errors
npm run build && npx cap sync
# No dev server or debug flags in the synced native config
grep -nE "\"url\"|cleartext|webContentsDebuggingEnabled" \
android/app/src/main/assets/capacitor.config.json ios/App/App/capacitor.config.json
# No hand edits in generated web assets (should show nothing)
git status --porcelain android/app/src/main/assets/public ios/App/App/public
# Error handling does not depend on message text
grep -rnE "error\.message\s*(===|==|\.includes)" src/
# Native builds
cd android && ./gradlew assembleRelease && cd ..
xcodebuild -project ios/App/App.xcodeproj -scheme App -configuration Release -destination 'generic/platform=iOS' build CODE_SIGNING_ALLOWED=NO
With CocoaPods, build ios/App/App.xcworkspace with -workspace instead of -project. Finally run on a real device and exercise each plugin-backed feature, including permission denial.
Error handling
| Error | Cause | Fix |
|---|---|---|
"<Plugin>" plugin is not implemented on ios (or android) | Plugin installed but not synced, plugin has no implementation for that platform, or plugin major does not match Capacitor | npx cap sync; check npx cap ls; install the plugin version matching your Capacitor major; rebuild the native app |
"<Plugin>.<method>()" is not implemented on web | Calling a native-only method in the browser | Guard with Capacitor.isNativePlatform() or isPluginAvailable, provide a web fallback |
Could not find the web assets directory: ./dist. | webDir wrong or web app not built | Build first; set webDir to the real output folder (dist, www, build, out) |
ios platform has not been added yet. | Native project missing | npx cap add ios (SPM default) or restore the committed ios/ folder |
Invalid App ID "<id>" | appId not reverse-domain or contains invalid characters | Use com.company.app style; changing it on a published app creates a new store listing |
| App loads a LAN IP or blank screen in production | server.url shipped from a dev config | Remove it, rebuild, npx cap sync, rebuild the native app |
net::ERR_CLEARTEXT_NOT_PERMITTED | HTTP request on Android | Use HTTPS; cleartext only in dev config (see capacitor-security) |
pod install fails / CocoaPods spec errors | CocoaPods trunk deprecation, outdated specs | Migrate with cocoapods-to-spm |
Deep links or resume handling stopped on iOS after 8.5 | Custom code still in AppDelegate after UIScene adoption | Move it to SceneDelegate (capacitor-uiscene-migration) |
Resources
- Capacitor docs: https://capacitorjs.com/docs
- Config reference: https://capacitorjs.com/docs/config
- Environment-specific configurations: https://capacitorjs.com/docs/guides/environment-specific-configurations
- Updating to 8.5 (UIScene): https://capacitorjs.com/docs/updating/8-5
- Capgo docs: https://capgo.app/docs/
Capacitor MCP Servers
Wire MCP servers into an agent so it can read Ionic/Capacitor docs, run Capacitor CLI commands, manage Capgo, and drive Xcode.
When to Use
TRIGGER when the user:
- asks to "add an MCP server" / "connect Claude/Cursor to Capacitor, Ionic, Capgo or Xcode"
- mentions
awesome-ionic-mcp,api.capgo.app/mcp,@capgo/cli mcp,xcrun mcpbridge,claude mcp add,.cursor/mcp.json,.vscode/mcp.json,claude_desktop_config.json - has an MCP server that fails to start, shows no tools, asks to sign in, or hits a rate limit
Do not use for:
- uploading bundles, channels, rollouts, native builds as a task:
capgo-cloud,capgo-cli-usage,capgo-live-updates,capgo-native-builds - finding or installing a plugin:
capacitor-plugins - runtime bugs and crashes:
debugging-capacitor; device logs:ios-android-logs - Ionic component design and theming:
ionic-design
Pick the Server
| Need | Server | Transport |
|---|---|---|
Ionic component APIs/demos, Capacitor plugin docs, run ionic/cap commands | awesome-ionic-mcp (community, npm) | stdio via npx |
| Capgo account: apps, bundles, channels, rollouts, devices, stats, build status/logs, webhooks, push | Capgo hosted MCP https://api.capgo.app/mcp | streamable HTTP, OAuth or API key |
Upload a bundle from dist/, request a native build, doctor, probe, compatibility check | Capgo local CLI MCP npx @capgo/cli@latest mcp | stdio |
| Build/run the iOS project, read Xcode issues, Xcode tools | Xcode MCP xcrun mcpbridge (Xcode 26.3+, verified on Xcode 27.1) | stdio |
The Capgo hosted and local servers are complementary: hosted cannot read local files; local needs npx @capgo/cli@latest login first. Setup guide for both: https://capgo.app/mcp
Procedure
-
Inspect first: identify the client (Claude Code, Claude Desktop, Cursor, VS Code, Cline, Codex) and read its existing MCP config before editing. Do not overwrite other servers.
-
Choose scope: project config (
.cursor/mcp.json,.vscode/mcp.json,claude mcp add --scope project) when the team should share it; user/global config otherwise. Ask the user if unclear. -
Add the server. Claude Code one-liners:
claude mcp add --transport stdio awesome-ionic-mcp -- npx -y awesome-ionic-mcp@latest claude mcp add --transport http capgo https://api.capgo.app/mcp claude mcp add --transport stdio capgo-cli -- npx @capgo/cli@latest mcp claude mcp add --transport stdio xcode -- xcrun mcpbridgeOther clients: load the matching reference below.
-
Authenticate:
- Capgo hosted: run
/mcpin Claude Code and pickcapgoto sign in (OAuth 2.1). Clients without OAuth sendAuthorization: Bearer <Capgo API key>. - Capgo local:
npx @capgo/cli@latest loginonce on the machine. - Xcode: enable external agents in Xcode Settings > Intelligence, keep the project open, approve the agent in Xcode's prompt.
- awesome-ionic-mcp: optional
GITHUB_TOKENenv var for plugin catalog fetches.
- Capgo hosted: run
-
Restart or reload the client, then run Verification.
Traps
- Secrets: if the user already has a
GITHUB_TOKENor Capgo API key in config, keep it as is. Prefer OAuth for Capgo hosted; use a key with the smallest role needed (read-only for reporting). Never commit keys in project-scoped config; use env vars or user scope. - Capgo hosted tools include destructive ones (delete app, set channel bundle, roll back). Clients ask for confirmation; do not auto-approve them.
- OAuth sessions create a key named
MCP · <client name>that expires after at most 90 days. Reconnect via/mcpwhen it expires; revoke by deleting that key in the console. - awesome-ionic-mcp runs
ionic/npxcommands inproject_directory(defaults to the nearest project root, then cwd). Onlyionic,@ionic/cli,@capacitor/cliandcap*packages are allowed, and arguments containing; & | $ ( ) { } [ ] < >are rejected. ionic_serveandcapacitor_runblock or need a device; prefer running them in a terminal the user controls.- awesome-ionic-mcp parameters are
html_tag(nottag),repo_namefor Capgo/community plugins,plugin_namefor official plugins,slugfor the third-party catalog. Call theget_all_*tool first to get exact names. xcrun mcpbridgeresolves Xcode viaxcode-select. If the active developer dir is/Library/Developer/CommandLineTools, it is not found.- Xcode approves per process: restarting the agent triggers a new approval prompt.
- Without the Intelligence setting enabled,
xcrun mcpbridgeconnects but exposes no tools.
Verification
claude mcp list # each server shows connected / needs auth
claude mcp get capgo # shows transport and URL
xcrun --find mcpbridge # Xcode bridge resolvable
xcrun mcpbridge run-agent --dry-run claude # prints the resolved Claude command with Xcode config
Then make one read-only tool call per server and confirm a real result:
- awesome-ionic-mcp:
get_ionic_component_definitionwithhtml_tag: "ion-button", orget_all_capgo_plugins - Capgo hosted: "List my Capgo apps"
- Capgo local:
capgo_list_appsorcapgo_doctor - Xcode: ask the agent to build the iOS app (
ios/App/App.xcodeprojorApp.xcworkspaceopen in Xcode)
In Cursor/VS Code/Claude Desktop, check the MCP panel shows the server enabled with a tool count above zero.
Error Handling
| Error / symptom | Fix |
|---|---|
GitHub API rate limit exceeded. Set GITHUB_TOKEN environment variable to increase limits. | Add GITHUB_TOKEN (no scopes needed for public repos) to the server env, restart. |
Plugin not found: <name> (awesome-ionic-mcp) | Use the exact repo_name/slug returned by the matching get_all_* tool. |
Component not found: <tag> | Pass a real Ionic tag such as ion-modal; list with get_all_ionic_components. |
Command '<cmd>' is not allowed / NPX package '<pkg>' is not allowed / Argument contains dangerous characters | The server only runs Ionic/Capacitor CLIs with plain args; run other commands in a terminal. |
Failed to download core JSON data from Ionic. | Network issue at startup; check connectivity/proxy and restart the server. |
xcrun: error: unable to find utility "mcpbridge", not a developer tool or in PATH | sudo xcode-select -s /Applications/Xcode.app/Contents/Developer, or update Xcode to 26.3+. |
| Xcode server connected but zero tools | Enable external agents in Xcode Settings > Intelligence and open the project. |
| Capgo hosted shows "needs authentication" | Run /mcp (Claude Code) or click the client's login prompt; reconnect after the 90-day key expiry. |
| Capgo local tools fail with auth errors | Run npx @capgo/cli@latest login on that machine. |
| Server starts then exits in Claude Desktop | Node/npx not on the GUI PATH; use an absolute path to npx in command. |
References
Only load a reference when its topic is in play.
references/awesome-ionic-mcp.md: client configs (Claude Desktop, Cursor, Cline, VS Code), full tool list with verified parameters, live viewer.references/capgo-mcp.md: hosted vs local Capgo MCP, per-client setup (Claude.ai, ChatGPT, Cursor, VS Code, Lovable, API-key headers), tool coverage.references/xcode-mcp.md: Xcode MCP bridge setup for Claude Code and Codex,run-agent, headlessmcp-servercommands, Capacitor iOS workflow.
Resources
- awesome-ionic-mcp: https://github.com/Tommertom/awesome-ionic-mcp
- Capgo hosted MCP: https://capgo.app/docs/ai/mcp/
- Capgo CLI MCP: https://capgo.app/docs/cli/reference/mcp/
- Xcode external agents: https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode
- Claude Code MCP: https://docs.anthropic.com/en/docs/claude-code/mcp
- MCP spec: https://modelcontextprotocol.io
Capacitor Plugins
Choose the right plugin, install it correctly, and prove it is linked natively.
When to Use
TRIGGER when:
- User asks "which plugin should I use for X?" or compares plugin options.
- User needs a native capability (camera, files, location, biometrics, payments, auth, sensors, storage, media, calendar, contacts, health, on-device LLM).
- A plugin call fails after install:
"X" plugin is not implemented on ios|android|web,UNIMPLEMENTED,unable to find plugin, or anOS-PLUG-*code. - User needs the right
Info.plist/AndroidManifest.xml/variables.gradleentries for a plugin.
Do not use (load the sibling skill instead):
- Push notification setup, FCM/APNs keys:
capacitor-push-notifications - Splash screen assets and timing:
capacitor-splash-screen - Keyboard overlap, accessory bar, resize:
capacitor-keyboard - Universal Links / App Links:
capacitor-deep-linking - OTA live updates:
capgo-live-updates - Migrating plugin source code across Capacitor majors:
capacitor-plugin-upgrades(andcapacitor-plugin-upgrade-v8-to-v9) - Adding Swift Package Manager support to a plugin:
capacitor-plugin-spm-support; moving an app to SPM:cocoapods-to-spm - AppDelegate/SceneDelegate lifecycle changes:
capacitor-uiscene-migration - Upgrading the app's Capacitor major:
capacitor-app-upgrades - SQL storage migrations:
sqlite-to-fast-sql
Version Facts (November 2026)
- Capacitor stable: 8.5.x (
latest). Capacitor 9 is9.0.0-alphaon thenextdist-tag. Official plugins follow: most v8 plugins are8.xonlatestand9.0.0-alphaonnext. - Plugin major must match the app's Capacitor major. Plugins for older majors use
latest-<major>tags, e.g.npm install @capacitor/camera@latest-7. - Some official plugins have independent versions (file-transfer 2.x, file-viewer 2.x, inappbrowser 4.x, privacy-screen 2.x, barcode-scanner 3.x, background-runner 3.x, calendar/contacts/health-fitness 1.x). Check
npm view <pkg> peerDependenciesinstead of matching the number. @capgo/*plugins use the Capacitor major as their own major (8.x for Capacitor 8). LTS tags such aslts-v7exist on some packages.- Capacitor 9: iOS 16 min, Android minSdk 26. Plugins that previously needed
minSdkVersion = 26(inappbrowser, barcode-scanner) stop needing a bump.
Procedure
-
Inspect first. Read
package.json(@capacitor/coreversion),capacitor.config.*, and check whether iOS uses SPM (ios/App/CapApp-SPM/Package.swift) or CocoaPods (ios/App/Podfile). Runnpx cap lsto see what is already linked. -
Pick the package.
- An official
@capacitor/*package exists and covers the need: default to it. Load its reference from the index below. - No official package, or it lacks a required feature: load
references/capgo-plugin-index.mdand pick the exact@capgo/*name. State why it fits better. - Never recommend a package name that is not in a reference file without checking
npm view <pkg> versionfirst.
- An official
-
Install with the matching major:
npm install @capacitor/<name> # or @capgo/<name> npx cap sync -
Add native config from the reference: usage-description keys, manifest permissions,
variables.gradleminSdk/library versions, capabilities/entitlements, AppDelegate hooks. Missing iOS usage strings crash the app on first access. -
Ask the user before raising
minSdkVersion, adding entitlements (HealthKit, Push), or enabling exact alarms: these affect store review and device reach. -
Verify (next section), then run on a real device for anything involving camera, health, LLM, BLE, or push.
Capgo Plugin Index
references/capgo-plugin-index.md is the complete Capgo plugin source, generated from Cap-go GitHub package.json and src/definitions.ts: npm name, purpose, install command, platforms, key API methods, docs and repo links for every public non-archived package. references/capgo-plugin-catalog.md is the compact table of the same set. Load the index before recommending any @capgo/* package and use the exact name from it.
Use the bundled index for consumer projects. Index regeneration belongs to the capgo-skills maintainer workflow; do not extract GitHub credentials or run repository-maintenance scripts while selecting a plugin for an app.
Verification
npx cap sync # must finish without "[error]" lines
npx cap ls # lists "Found N Capacitor plugins for ios/android"; plugin must appear for each platform
- Android:
android/app/capacitor.build.gradlecontainsimplementation project(':capacitor-<name>')andandroid/capacitor.settings.gradlehas the matchinginclude. Thencd android && ./gradlew assembleDebug. - iOS SPM:
ios/App/CapApp-SPM/Package.swiftlists the plugin package. iOS CocoaPods:ios/App/Podfilehas the pod andpod installsucceeded. Build in Xcode ornpx cap run ios. - Grep for leftovers when replacing a plugin:
grep -rn "<old-package>" src android ios package.json. - Feature-detect at runtime:
Capacitor.isPluginAvailable('Camera')andCapacitor.getPlatform().
Error Handling
| Error | Cause | Fix |
|---|---|---|
"Camera" plugin is not implemented on ios (or android/web) | Native side not linked, or no web implementation | npx cap sync, rebuild the native app (live reload does not pick up new native code), check npx cap ls. On web, guard with Capacitor.isNativePlatform(). |
"Camera.takePhoto()" is not implemented on ios | Plugin linked but JS and native versions differ, or method is platform-specific | Align JS and native versions, npx cap sync, clean build. Check the reference for platform-only methods. |
UNIMPLEMENTED error code | Method not available on this platform/OS version | Branch on platform; see reference "Notes". |
Android log unable to find plugin : X | Plugin class not registered/included | Confirm capacitor.build.gradle entry, re-sync, Gradle sync in Android Studio. |
iOS log Error loading plugin X for call. Check that the pluginId is correct | Plugin not in the iOS build | Re-sync; check Package.swift (SPM) or Podfile; clean build folder. |
| App crashes on first camera/contacts/calendar/location access (iOS) | Missing NS*UsageDescription key | Add the key listed in the reference to Info.plist. |
Manifest merger failed : uses-sdk:minSdkVersion 24 cannot be smaller than version 26 declared in library [...] | Plugin needs higher minSdk | Raise minSdkVersion in android/variables.gradle (ask the user first). |
OS-PLUG-* codes (e.g. OS-PLUG-CAMR-0003) | Structured native errors in OutSystems-based official plugins | Look up the code in the plugin reference (camera, file-transfer, calendar, contacts list the common ones). |
npm ERESOLVE peer @capacitor/core conflict | Plugin major does not match app major | Install the matching tag (@latest-7, @next for v9 alpha) or upgrade the app with capacitor-app-upgrades. |
Reference Index
Only load a reference when its plugin is in play.
Official @capacitor/* packages (install, native config, usage, gotchas):
| Need | Reference |
|---|---|
| Action sheet | references/capacitor-action-sheet.md |
| Open other apps / check installed | references/capacitor-app-launcher.md |
| App state, back button, URL open events | references/capacitor-app.md |
| JS tasks in background | references/capacitor-background-runner.md |
| Barcode / QR scan | references/capacitor-barcode-scanner.md |
| OAuth-safe in-app browser (SFSafariViewController / Custom Tabs) | references/capacitor-browser.md |
| Calendar events | references/capacitor-calendar.md |
Camera, gallery, video (8.1+ API, getPhoto migration) | references/capacitor-camera.md |
| Clipboard | references/capacitor-clipboard.md |
| Contacts | references/capacitor-contacts.md |
| Native cookies (core) | references/capacitor-cookies.md |
| Device info / id / battery | references/capacitor-device.md |
| Native alert/confirm/prompt | references/capacitor-dialog.md |
| Upload/download with progress | references/capacitor-file-transfer.md |
| Open/preview documents | references/capacitor-file-viewer.md |
| File read/write | references/capacitor-filesystem.md |
| Location (foreground) | references/capacitor-geolocation.md |
| Google Maps | references/capacitor-google-maps.md |
| HealthKit / Health Connect | references/capacitor-health-fitness.md |
| Haptics | references/capacitor-haptics.md |
| Native HTTP (core, CORS bypass) | references/capacitor-http.md |
| WebView / system / external browser | references/capacitor-inappbrowser.md |
| Keyboard API basics | references/capacitor-keyboard.md |
| On-device LLM (experimental) | references/capacitor-local-llm.md |
| Local notifications | references/capacitor-local-notifications.md |
| Accelerometer / orientation | references/capacitor-motion.md |
| Connectivity | references/capacitor-network.md |
| Key/value storage | references/capacitor-preferences.md |
| Hide app switcher snapshot / block screenshots | references/capacitor-privacy-screen.md |
| Push API summary | references/capacitor-push-notifications.md |
| Orientation lock | references/capacitor-screen-orientation.md |
| TalkBack / VoiceOver state, TTS | references/capacitor-screen-reader.md |
| Share sheet | references/capacitor-share.md |
| Splash API summary | references/capacitor-splash-screen.md |
| Status bar (legacy) | references/capacitor-status-bar.md |
| Edge-to-edge system bars (core, preferred on Android 16+) | references/capacitor-system-bars.md |
| WebView text zoom | references/capacitor-text-zoom.md |
| Toast | references/capacitor-toast.md |
| Apple Watch UI (experimental) | references/capacitor-watch.md |
Capgo plugins: references/capgo-plugin-index.md (150 packages: full API methods, events, config keys, and per-release deltas since 2026-09-11) and references/capgo-plugin-catalog.md (compact table).
Capgo deep references (recent API changes):
| Need | Reference |
|---|---|
| Playlist queue, playback state, audio route | references/capgo-native-audio.md |
| Zebra DataWedge diagnostics and scan intents | references/capgo-zebra-datawedge.md |
| iOS geofence queue | references/capgo-background-geolocation.md |
PDF underWebView and layout | references/capgo-pdf-viewer.md |
| IAP configure and finishTransaction | references/capgo-native-purchases.md |
| Live Activities upgrade notes | references/capgo-live-activities.md |
OAuth openAuthSession | references/capgo-social-login.md |
| Apple Watch and Wear OS | references/capgo-watch.md |
| Capgo in-app browser fullscreen and scripting | references/capgo-inappbrowser.md |
Capgo Quick Picks
| Need | Package |
|---|---|
| Background geolocation, geofencing | @capgo/background-geolocation |
| Custom camera preview / overlays | @capgo/camera-preview |
| Biometric login + secure credentials | @capgo/capacitor-native-biometric |
| Apple/Google/Facebook sign-in | @capgo/capacitor-social-login |
| Subscriptions / IAP | @capgo/native-purchases (revenue strategy: subscription-app-revenue) |
| Apple Pay / Google Pay | @capgo/capacitor-pay |
| Fast native SQLite | @capgo/capacitor-fast-sql |
| Native file ops / picking | @capgo/capacitor-file, @capgo/capacitor-file-picker |
In-app browser with JS injection, postMessage, screenshots | @capgo/capacitor-inappbrowser |
| WebView killed in background, relaunch | @capgo/capacitor-webview-guardian |
| App Attest / Play Integrity | @capgo/capacitor-app-attest |
| OTA live updates | @capgo/capacitor-updater (setup: capgo-live-updates) |
| Dev live reload | @capgo/capacitor-live-reload |
Traps:
- Do not install two plugins that own the same native surface (e.g. two in-app browsers or two biometric plugins) without a reason; they can conflict on delegates and manifest entries.
- Firebase: install the individual
@capgo/capacitor-firebase-*packages; there is no umbrella@capgo/capacitor-firebasepackage on npm. - Cordova plugins still work but on Capacitor 9 they pull in the Cordova runtime; prefer a Capacitor-native equivalent (
cordova-to-capacitor).
Resources
- Official plugin docs: https://capacitorjs.com/docs/apis
- Capgo plugin docs: https://capgo.app/docs/plugins/
- Capgo GitHub: https://github.com/Cap-go
Sponsors
Details
- Marketplace
- Cap-go/capgo-skills
- Source
- plugins/capacitor-core
- Author
- Capgo
- Category
- Development
- License
- MIT
- Keywords
- capacitor, mobile, plugins, best-practices, mcp