Skip to content

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

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

PlatformSupportNotes
iOSYesiOS 16 and later
AndroidNoMethods reject with a clear error
WebNoGuard with Capacitor.getPlatform()
  • 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).
MethodDescription
getPendingInvocationsReturn invocations queued before JavaScript was ready.
removePendingInvocationRemove one pending invocation after your handler processes it.
setEntityCatalogPersist an entity catalog for a given type string.
setHomeScreenShortcutItemsReplace Home Screen quick actions (UIApplicationShortcutItems).
indexSpotlightEntitiesIndex Spotlight items for your app domain.
removeSpotlightEntitiesRemove Spotlight items by id.
performAppleSchemaTemplateQueue a JavaScript handler for an alpha Apple schema template.
addListenerListen for appIntentInvoked when a new invocation is queued.
removeAllListenersRemove all listeners for this plugin.
getPluginVersionNative plugin version string.

This reference is synced from src/definitions.ts in capacitor-app-intents.