Cap-go avatar

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-skills

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Cap-go/capgo-skills.

Contents

Discovered from source

Skills 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|json review: 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)
Node22+24+
iOS min / XcodeiOS 15 / Xcode 26 (8.5 adopts UIScene so Xcode 27 builds work)iOS 16 / Xcode 27+
AndroidminSdk 24, compile/target 36, AGP 8.13, Gradle 8.14.3minSdk 26, compile/target 37, AGP 9.2.1, Gradle 9.5.1
iOS depsSPM default for new projectsSPM 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

  1. 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
    
  2. 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.
  3. 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).
  4. Fix, loading the matching reference.
  5. Run Verification.

Rules that matter most

  1. Keep Capacitor packages on one version. @capacitor/core, cli, ios, android must match. Plugin majors must match the Capacitor major (official and @capgo/* plugins follow it: v8 plugins for Capacitor 8).
  2. npx cap sync after every plugin install/removal and every config change. Missing sync produces "<Plugin>" plugin is not implemented on <platform>.
  3. Never edit generated web assets. android/app/src/main/assets/public/ and ios/App/App/public/ are overwritten by cap copy/sync. Edit src/ and rebuild.
  4. Commit ios/ and android/. They are source code with your native customizations, not build output. Do commit capacitor.config.*; do not commit node_modules, Pods/, build dirs.
  5. No dev settings in release config. server.url, server.cleartext, allowNavigation to dev hosts, webContentsDebuggingEnabled: true. Gate them on an env var (see references/config-and-project.md). On Capacitor 9, use npx cap run <platform> --url <dev-url> for live reload.
  6. Feature-detect before calling plugins. Capacitor.isNativePlatform(), Capacitor.getPlatform(), Capacitor.isPluginAvailable('Name'). Provide a web fallback or hide the feature.
  7. Use the permission API. Call checkPermissions() then requestPermissions() for official plugins that expose them, and handle denied with a path to Settings. Add the matching NS*UsageDescription keys / Android permissions.
  8. Branch on error.code, not error.message. Messages change between versions and platforms. Official plugins expose structured codes (for example OS-PLUG-CAMR-0006 for a cancelled camera capture in @capacitor/camera 8.1+ new APIs); Capacitor core uses UNIMPLEMENTED / UNAVAILABLE.
  9. Move large binary data as files, not base64. Pass file paths/URIs across the bridge and render with Capacitor.convertFileSrc().
  10. 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 to SceneDelegate (capacitor-uiscene-migration). Avoid UIScreen.main and idiom-based layout for resizable windows.
  11. Live updates: call CapacitorUpdater.notifyAppReady() on every launch, and apply manual updates with next() (on background/relaunch) rather than set() mid-session. Details in capgo-live-updates.
  12. Secrets never go in the app. Anything in the bundle or capacitor.config is extractable. Hand off to capacitor-security for anything beyond this rule.

References

Only load a reference when its topic is in play.

ReferenceLoad when
references/config-and-project.mdReviewing capacitor.config, env-specific builds, repo layout, .gitignore, version alignment
references/plugins.mdPlugin install/sync, availability checks, permissions, error codes, web fallbacks, lazy loading, mocking
references/native-projects.mdiOS SPM vs CocoaPods, UIScene, deployment targets; Android variables.gradle, R8, Capacitor 9 Gradle changes
references/release-checklist.mdPreparing 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

ErrorCauseFix
"<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 Capacitornpx cap sync; check npx cap ls; install the plugin version matching your Capacitor major; rebuild the native app
"<Plugin>.<method>()" is not implemented on webCalling a native-only method in the browserGuard with Capacitor.isNativePlatform() or isPluginAvailable, provide a web fallback
Could not find the web assets directory: ./dist.webDir wrong or web app not builtBuild first; set webDir to the real output folder (dist, www, build, out)
ios platform has not been added yet.Native project missingnpx cap add ios (SPM default) or restore the committed ios/ folder
Invalid App ID "<id>"appId not reverse-domain or contains invalid charactersUse com.company.app style; changing it on a published app creates a new store listing
App loads a LAN IP or blank screen in productionserver.url shipped from a dev configRemove it, rebuild, npx cap sync, rebuild the native app
net::ERR_CLEARTEXT_NOT_PERMITTEDHTTP request on AndroidUse HTTPS; cleartext only in dev config (see capacitor-security)
pod install fails / CocoaPods spec errorsCocoaPods trunk deprecation, outdated specsMigrate with cocoapods-to-spm
Deep links or resume handling stopped on iOS after 8.5Custom code still in AppDelegate after UIScene adoptionMove it to SceneDelegate (capacitor-uiscene-migration)

Resources

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

NeedServerTransport
Ionic component APIs/demos, Capacitor plugin docs, run ionic/cap commandsawesome-ionic-mcp (community, npm)stdio via npx
Capgo account: apps, bundles, channels, rollouts, devices, stats, build status/logs, webhooks, pushCapgo hosted MCP https://api.capgo.app/mcpstreamable HTTP, OAuth or API key
Upload a bundle from dist/, request a native build, doctor, probe, compatibility checkCapgo local CLI MCP npx @capgo/cli@latest mcpstdio
Build/run the iOS project, read Xcode issues, Xcode toolsXcode 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

  1. 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.

  2. 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.

  3. 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 mcpbridge
    

    Other clients: load the matching reference below.

  4. Authenticate:

    • Capgo hosted: run /mcp in Claude Code and pick capgo to sign in (OAuth 2.1). Clients without OAuth send Authorization: Bearer <Capgo API key>.
    • Capgo local: npx @capgo/cli@latest login once 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_TOKEN env var for plugin catalog fetches.
  5. Restart or reload the client, then run Verification.

Traps

  • Secrets: if the user already has a GITHUB_TOKEN or 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 /mcp when it expires; revoke by deleting that key in the console.
  • awesome-ionic-mcp runs ionic/npx commands in project_directory (defaults to the nearest project root, then cwd). Only ionic, @ionic/cli, @capacitor/cli and cap* packages are allowed, and arguments containing ; & | $ ( ) { } [ ] < > are rejected.
  • ionic_serve and capacitor_run block or need a device; prefer running them in a terminal the user controls.
  • awesome-ionic-mcp parameters are html_tag (not tag), repo_name for Capgo/community plugins, plugin_name for official plugins, slug for the third-party catalog. Call the get_all_* tool first to get exact names.
  • xcrun mcpbridge resolves Xcode via xcode-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 mcpbridge connects 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_definition with html_tag: "ion-button", or get_all_capgo_plugins
  • Capgo hosted: "List my Capgo apps"
  • Capgo local: capgo_list_apps or capgo_doctor
  • Xcode: ask the agent to build the iOS app (ios/App/App.xcodeproj or App.xcworkspace open 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 / symptomFix
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 charactersThe 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 PATHsudo xcode-select -s /Applications/Xcode.app/Contents/Developer, or update Xcode to 26.3+.
Xcode server connected but zero toolsEnable 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 errorsRun npx @capgo/cli@latest login on that machine.
Server starts then exits in Claude DesktopNode/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, headless mcp-server commands, Capacitor iOS workflow.

Resources

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 an OS-PLUG-* code.
  • User needs the right Info.plist / AndroidManifest.xml / variables.gradle entries 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 (and capacitor-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 is 9.0.0-alpha on the next dist-tag. Official plugins follow: most v8 plugins are 8.x on latest and 9.0.0-alpha on next.
  • 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> peerDependencies instead of matching the number.
  • @capgo/* plugins use the Capacitor major as their own major (8.x for Capacitor 8). LTS tags such as lts-v7 exist 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

  1. Inspect first. Read package.json (@capacitor/core version), capacitor.config.*, and check whether iOS uses SPM (ios/App/CapApp-SPM/Package.swift) or CocoaPods (ios/App/Podfile). Run npx cap ls to see what is already linked.

  2. 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.md and 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> version first.
  3. Install with the matching major:

    npm install @capacitor/<name>        # or @capgo/<name>
    npx cap sync
    
  4. Add native config from the reference: usage-description keys, manifest permissions, variables.gradle minSdk/library versions, capabilities/entitlements, AppDelegate hooks. Missing iOS usage strings crash the app on first access.

  5. Ask the user before raising minSdkVersion, adding entitlements (HealthKit, Push), or enabling exact alarms: these affect store review and device reach.

  6. 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.gradle contains implementation project(':capacitor-<name>') and android/capacitor.settings.gradle has the matching include. Then cd android && ./gradlew assembleDebug.
  • iOS SPM: ios/App/CapApp-SPM/Package.swift lists the plugin package. iOS CocoaPods: ios/App/Podfile has the pod and pod install succeeded. Build in Xcode or npx 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') and Capacitor.getPlatform().

Error Handling

ErrorCauseFix
"Camera" plugin is not implemented on ios (or android/web)Native side not linked, or no web implementationnpx 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 iosPlugin linked but JS and native versions differ, or method is platform-specificAlign JS and native versions, npx cap sync, clean build. Check the reference for platform-only methods.
UNIMPLEMENTED error codeMethod not available on this platform/OS versionBranch on platform; see reference "Notes".
Android log unable to find plugin : XPlugin class not registered/includedConfirm capacitor.build.gradle entry, re-sync, Gradle sync in Android Studio.
iOS log Error loading plugin X for call. Check that the pluginId is correctPlugin not in the iOS buildRe-sync; check Package.swift (SPM) or Podfile; clean build folder.
App crashes on first camera/contacts/calendar/location access (iOS)Missing NS*UsageDescription keyAdd 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 minSdkRaise 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 pluginsLook up the code in the plugin reference (camera, file-transfer, calendar, contacts list the common ones).
npm ERESOLVE peer @capacitor/core conflictPlugin major does not match app majorInstall 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):

NeedReference
Action sheetreferences/capacitor-action-sheet.md
Open other apps / check installedreferences/capacitor-app-launcher.md
App state, back button, URL open eventsreferences/capacitor-app.md
JS tasks in backgroundreferences/capacitor-background-runner.md
Barcode / QR scanreferences/capacitor-barcode-scanner.md
OAuth-safe in-app browser (SFSafariViewController / Custom Tabs)references/capacitor-browser.md
Calendar eventsreferences/capacitor-calendar.md
Camera, gallery, video (8.1+ API, getPhoto migration)references/capacitor-camera.md
Clipboardreferences/capacitor-clipboard.md
Contactsreferences/capacitor-contacts.md
Native cookies (core)references/capacitor-cookies.md
Device info / id / batteryreferences/capacitor-device.md
Native alert/confirm/promptreferences/capacitor-dialog.md
Upload/download with progressreferences/capacitor-file-transfer.md
Open/preview documentsreferences/capacitor-file-viewer.md
File read/writereferences/capacitor-filesystem.md
Location (foreground)references/capacitor-geolocation.md
Google Mapsreferences/capacitor-google-maps.md
HealthKit / Health Connectreferences/capacitor-health-fitness.md
Hapticsreferences/capacitor-haptics.md
Native HTTP (core, CORS bypass)references/capacitor-http.md
WebView / system / external browserreferences/capacitor-inappbrowser.md
Keyboard API basicsreferences/capacitor-keyboard.md
On-device LLM (experimental)references/capacitor-local-llm.md
Local notificationsreferences/capacitor-local-notifications.md
Accelerometer / orientationreferences/capacitor-motion.md
Connectivityreferences/capacitor-network.md
Key/value storagereferences/capacitor-preferences.md
Hide app switcher snapshot / block screenshotsreferences/capacitor-privacy-screen.md
Push API summaryreferences/capacitor-push-notifications.md
Orientation lockreferences/capacitor-screen-orientation.md
TalkBack / VoiceOver state, TTSreferences/capacitor-screen-reader.md
Share sheetreferences/capacitor-share.md
Splash API summaryreferences/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 zoomreferences/capacitor-text-zoom.md
Toastreferences/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):

NeedReference
Playlist queue, playback state, audio routereferences/capgo-native-audio.md
Zebra DataWedge diagnostics and scan intentsreferences/capgo-zebra-datawedge.md
iOS geofence queuereferences/capgo-background-geolocation.md
PDF underWebView and layoutreferences/capgo-pdf-viewer.md
IAP configure and finishTransactionreferences/capgo-native-purchases.md
Live Activities upgrade notesreferences/capgo-live-activities.md
OAuth openAuthSessionreferences/capgo-social-login.md
Apple Watch and Wear OSreferences/capgo-watch.md
Capgo in-app browser fullscreen and scriptingreferences/capgo-inappbrowser.md

Capgo Quick Picks

NeedPackage
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-firebase package 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

Sponsors

Details

Marketplace
Cap-go/capgo-skills
Source
plugins/capacitor-core
Author
Capgo
Category
Development
License
MIT
Keywords
capacitor, mobile, plugins, best-practices, mcp

More from Cap-go/capgo-skills

All 11