@capgo/capacitor-app-intents
Ship Siri phrases, Shortcuts, Spotlight, Home Screen quick actions, and entity catalogs from Capacitor with a cold start safe invocation queue.
Overview
Section titled “Overview”@capgo/capacitor-app-intents connects Apple App Intents to your Capacitor JavaScript layer: drain a pending queue on cold start, publish entity catalogs for Shortcuts parameters, index Spotlight content, set Home Screen quick actions, and listen for appIntentInvoked events. Siri shortcut phrases are compile time literals in generated Swift, not runtime strings.
Pair this plugin with Siri, Shortcuts, and widgets when you also use Widget Kit, Live Activities, Share Target, or Intent Launcher.
Platform support
Section titled “Platform support”| Platform | Support | Notes |
|---|---|---|
| iOS | Yes | iOS 16 and later |
| Android | No | Methods reject with a clear error |
| Web | No | Guard with Capacitor.getPlatform() |
Core Capabilities
Section titled “Core Capabilities”getPendingInvocations- Return invocations queued before JavaScript was ready.removePendingInvocation- Remove one pending invocation after your handler processes it.setEntityCatalog- Persist an entity catalog for a given type string.setHomeScreenShortcutItems- Replace Home Screen quick actions (UIApplicationShortcutItems).
Public API
Section titled “Public API”| Method | Description |
|---|---|
getPendingInvocations | Return invocations queued before JavaScript was ready. |
removePendingInvocation | Remove one pending invocation after your handler processes it. |
setEntityCatalog | Persist an entity catalog for a given type string. |
setHomeScreenShortcutItems | Replace Home Screen quick actions (UIApplicationShortcutItems). |
indexSpotlightEntities | Index Spotlight items for your app domain. |
removeSpotlightEntities | Remove Spotlight items by id. |
performAppleSchemaTemplate | Queue a JavaScript handler for an alpha Apple schema template. |
addListener | Listen for appIntentInvoked when a new invocation is queued. |
removeAllListeners | Remove all listeners for this plugin. |
getPluginVersion | Native plugin version string. |
Source Of Truth
Section titled “Source Of Truth”This reference is synced from src/definitions.ts in capacitor-app-intents.