Agent Skills: Capacitor Plugins Directory

Capacitor Plugins Directory

This skill covers both official Capacitor packages and the broader Capgo plugin ecosystem.

When to Use This Skill

• User asks "which plugin should I use for X?"
• User needs native functionality (camera, biometrics, payments, etc.)
• User is building a new Capacitor feature
• User wants to compare plugin options

Decision Process

Step 1: Check for an Official Capacitor Package First

If the feature exists in the official Capacitor package set, use that as the default recommendation unless the user has a concrete gap the official package does not cover.

Open the matching file in references/ before answering:

• capacitor-action-sheet.md
• capacitor-app-launcher.md
• capacitor-app.md
• capacitor-background-runner.md
• capacitor-barcode-scanner.md
• capacitor-browser.md
• capacitor-camera.md
• capacitor-clipboard.md
• capacitor-cookies.md
• capacitor-device.md
• capacitor-dialog.md
• capacitor-file-transfer.md
• capacitor-file-viewer.md
• capacitor-filesystem.md
• capacitor-geolocation.md
• capacitor-google-maps.md
• capacitor-haptics.md
• capacitor-http.md
• capacitor-inappbrowser.md
• capacitor-keyboard.md
• capacitor-local-notifications.md
• capacitor-motion.md
• capacitor-network.md
• capacitor-preferences.md
• capacitor-privacy-screen.md
• capacitor-push-notifications.md
• capacitor-screen-orientation.md
• capacitor-screen-reader.md
• capacitor-share.md
• capacitor-splash-screen.md
• capacitor-status-bar.md
• capacitor-system-bars.md
• capacitor-text-zoom.md
• capacitor-toast.md
• capacitor-watch.md

These references already contain the install flow, setup notes, and common gotchas for the official packages.

Step 2: Escalate to Capgo or Community Plugins When Needed

Recommend a Capgo or community plugin when:

• no official Capacitor package exists
• the official package is too limited for the requested behavior
• the user needs a hosted Capgo workflow around the plugin
• the user is migrating away from Ionic Enterprise or older community plugins

When recommending a non-official plugin, explain why it is a better fit than the official option.

Plugin Categories

Authentication & Security

| Plugin | Package | Description | |--------|---------|-------------| | Native Biometric | @capgo/capacitor-native-biometric | Face ID, Touch ID, fingerprint authentication | | Social Login | @capgo/capacitor-social-login | Google, Apple, Facebook sign-in | | Autofill Save Password | @capgo/capacitor-autofill-save-password | Native password autofill integration | | Is Root | @capgo/capacitor-is-root | Detect rooted/jailbroken devices | | WebView Guardian | @capgo/capacitor-webview-guardian | Security hardening for WebView |

Live Updates & Development

| Plugin | Package | Description | |--------|---------|-------------| | Capacitor Updater | @capgo/capacitor-updater | OTA live updates without app store | | Live Reload | @capgo/capacitor-live-reload | Hot reload during development | | Env | @capgo/capacitor-env | Environment variables in native code |

Media & Camera

| Plugin | Package | Description | |--------|---------|-------------| | Camera Preview | @capgo/capacitor-camera-preview | Camera preview with overlay support | | Photo Library | @capgo/capacitor-photo-library | Access device photo library | | Video Player | @capgo/capacitor-video-player | Native video playback | | Video Thumbnails | @capgo/capacitor-video-thumbnails | Generate video thumbnails | | Screen Recorder | @capgo/capacitor-screen-recorder | Record device screen | | Document Scanner | @capgo/capacitor-document-scanner | Scan documents with edge detection | | FFmpeg | @capgo/capacitor-ffmpeg | Video/audio processing with FFmpeg |

Audio

| Plugin | Package | Description | |--------|---------|-------------| | Native Audio | @capgo/capacitor-native-audio | Low-latency audio playback | | Audio Recorder | @capgo/capacitor-audio-recorder | Record audio from microphone | | Audio Session | @capgo/capacitor-audiosession | iOS audio session management | | Media Session | @capgo/capacitor-media-session | Lock screen media controls | | Mute | @capgo/capacitor-mute | Detect device mute switch |

Streaming Players

| Plugin | Package | Description | |--------|---------|-------------| | IVS Player | @capgo/capacitor-ivs-player | Amazon IVS video streaming | | JW Player | @capgo/capacitor-jw-player | JW Player integration | | Mux Player | @capgo/capacitor-mux-player | Mux video streaming | | YouTube Player | @capgo/capacitor-youtube-player | YouTube video player |

Payments & Monetization

| Plugin | Package | Description | |--------|---------|-------------| | Native Purchases | @capgo/capacitor-native-purchases | In-app purchases (IAP) | | Pay | @capgo/capacitor-pay | Apple Pay / Google Pay | | AdMob | @nicholasalx/capacitor-admob | Google AdMob ads |

Location & Navigation

| Plugin | Package | Description | |--------|---------|-------------| | Background Geolocation | @capgo/capacitor-background-geolocation | Location tracking in background | | Native Geocoder | @nicholasalx/capacitor-nativegeocoder | Geocoding and reverse geocoding | | Launch Navigator | @nicholasalx/capacitor-launch-navigator | Open native maps apps |

Sensors

| Plugin | Package | Description | |--------|---------|-------------| | Accelerometer | @nicholasalx/capacitor-accelerometer | Device motion sensor | | Barometer | @capgo/capacitor-barometer | Atmospheric pressure sensor | | Compass | @nicholasalx/capacitor-compass | Device compass/heading | | Light Sensor | @nicholasalx/capacitor-light-sensor | Ambient light sensor | | Pedometer | @capgo/capacitor-pedometer | Step counter | | Shake | @capgo/capacitor-shake | Detect device shake |

Communication

| Plugin | Package | Description | |--------|---------|-------------| | Contacts | @nicholasalx/capacitor-contacts | Access device contacts | | Crisp | @nicholasalx/capacitor-crisp | Crisp chat integration | | Twilio Voice | @nicholasalx/capacitor-twilio-voice | Twilio voice calls | | Stream Call | @nicholasalx/capacitor-streamcall | Stream video calls | | RealtimeKit | @nicholasalx/capacitor-realtimekit | Real-time communication |

Storage & Files

| Plugin | Package | Description | |--------|---------|-------------| | Fast SQL | @capgo/capacitor-fast-sql | Native SQLite with transactions, batch ops, encryption, BLOBs, and KeyValueStore | | File | @nicholasalx/capacitor-file | File system operations | | File Picker | @nicholasalx/capacitor-file-picker | Native file picker | | File Compressor | @nicholasalx/capacitor-file-compressor | Compress files | | Downloader | @nicholasalx/capacitor-downloader | Background file downloads | | Uploader | @nicholasalx/capacitor-uploader | Background file uploads | | Zip | @nicholasalx/capacitor-zip | Zip/unzip files |

UI & Display

| Plugin | Package | Description | |--------|---------|-------------| | Brightness | @nicholasalx/capacitor-brightness | Control screen brightness | | Navigation Bar | @nicholasalx/capacitor-navigation-bar | Android navigation bar control | | Home Indicator | @nicholasalx/capacitor-home-indicator | iOS home indicator control | | Screen Orientation | @nicholasalx/capacitor-screen-orientation | Lock/detect screen orientation | | Keep Awake | @nicholasalx/capacitor-keep-awake | Prevent screen sleep | | Flash | @nicholasalx/capacitor-flash | Device flashlight control | | Text Interaction | @nicholasalx/capacitor-textinteraction | Text selection callbacks |

Connectivity & Hardware

| Plugin | Package | Description | |--------|---------|-------------| | Bluetooth Low Energy | @nicholasalx/capacitor-bluetooth-low-energy | BLE communication | | NFC | @nicholasalx/capacitor-nfc | NFC tag reading/writing | | iBeacon | @nicholasalx/capacitor-ibeacon | iBeacon detection | | WiFi | @nicholasalx/capacitor-wifi | WiFi network management | | SIM | @nicholasalx/capacitor-sim | SIM card information |

Analytics & Tracking

| Plugin | Package | Description | |--------|---------|-------------| | App Tracking Transparency | @nicholasalx/capacitor-app-tracking-transparency | iOS ATT prompt | | Firebase | @nicholasalx/capacitor-firebase | Firebase services | | GTM | @nicholasalx/capacitor-gtm | Google Tag Manager | | App Insights | @nicholasalx/capacitor-appinsights | Azure App Insights |

Browser & WebView

| Plugin | Package | Description | |--------|---------|-------------| | InAppBrowser | @nicholasalx/capacitor-inappbrowser | In-app browser with custom tabs |

Health & Fitness

| Plugin | Package | Description | |--------|---------|-------------| | Health | @nicholasalx/capacitor-health | HealthKit/Google Fit integration |

Printing & Documents

| Plugin | Package | Description | |--------|---------|-------------| | Printer | @nicholasalx/capacitor-printer | Native printing | | PDF Generator | @nicholasalx/capacitor-pdf-generator | Generate PDF documents |

Voice & Speech

| Plugin | Package | Description | |--------|---------|-------------| | Speech Recognition | @nicholasalx/capacitor-speech-recognition | Speech to text | | Speech Synthesis | @nicholasalx/capacitor-speech-synthesis | Text to speech | | LLM | @nicholasalx/capacitor-llm | On-device LLM inference |

App Store & Distribution

| Plugin | Package | Description | |--------|---------|-------------| | In App Review | @nicholasalx/capacitor-in-app-review | Native app review prompt | | Native Market | @nicholasalx/capacitor-native-market | Open app store pages | | Android Inline Install | @capgo/capacitor-android-inline-install | Android in-app updates |

Platform Specific

| Plugin | Package | Description | |--------|---------|-------------| | Android Kiosk | @nicholasalx/capacitor-android-kiosk | Kiosk/lock task mode | | Android Age Signals | @nicholasalx/capacitor-android-age-signals | Google Age Signals API | | Android Usage Stats | @nicholasalx/capacitor-android-usagestatsmanager | App usage statistics | | Intent Launcher | @nicholasalx/capacitor-intent-launcher | Launch Android intents | | Watch | @nicholasalx/capacitor-watch | Apple Watch / WearOS |

Social & Sharing

| Plugin | Package | Description | |--------|---------|-------------| | Share Target | @nicholasalx/capacitor-share-target | Receive shared content | | WeChat | @nicholasalx/capacitor-wechat | WeChat integration |

Other

| Plugin | Package | Description | |--------|---------|-------------| | Alarm | @nicholasalx/capacitor-alarm | Schedule alarms | | Supabase | @nicholasalx/capacitor-supabase | Supabase native auth | | Persistent Account | @nicholasalx/capacitor-persistent-account | Account persistence | | Volume Buttons | @nicholasalx/capacitor-volume-buttons | Listen to volume button presses | | Transitions | @nicholasalx/capacitor-transitions | Page transition animations | | Ricoh 360 Camera | @nicholasalx/capacitor-ricoh360-camera-plugin | Ricoh 360 camera | | Capacitor Plus | @nicholasalx/capacitor-plus | Collection of utilities |

Installation

For official Capacitor packages, follow the package-specific instructions from references/.

For Capgo plugins, use:

npm install @capgo/capacitor-<name>
npx cap sync

Choosing the Right Plugin

Prefer Official Capacitor For

• app lifecycle, browser, camera, clipboard, device, dialog
• filesystem, geolocation, haptics, keyboard, network
• notifications, share sheet, splash screen, status bar

For Authentication

• Biometric login: Use native-biometric
• Social sign-in: Use social-login
• Password autofill: Use autofill-save-password

For Media

• Camera with overlay: Use camera-preview
• Simple photo access: Use photo-library
• Video playback: Use video-player
• Document scanning: Use document-scanner

For Payments

• Subscriptions/IAP: Use native-purchases
• Apple Pay/Google Pay: Use pay

For Live Updates

• Production OTA: Use capacitor-updater
• Development hot reload: Use live-reload

For Native SQL Storage

• Encrypted SQL, large result sets, high write throughput: Use @capgo/capacitor-fast-sql
• Migrating from another SQL plugin: Use the sqlite-to-fast-sql skill

Resources

• Documentation: https://capgo.app/docs
• GitHub: https://github.com/Cap-go
• Discord: https://discord.gg/capgo