capacitor-plugins

What this skill does

# 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-ib