Design and implement App Intents, app entities, and App Shortcuts for iOS apps so useful actions and content are available to Shortcuts, Siri, Spotlight, widgets, controls, and other intent-driven system surfaces. Use when exposing app actions outside the UI, adding `AppEntity` and `EntityQuery` types, shaping shortcut phrases and display representations, or routing intent execution back into the main app.
Expose the smallest useful action and entity surface to the system. Start with the verbs and objects people would actually want outside the app, then implement a narrow App Intents layer that can deep-link or hand off cleanly into the main app when needed.
Read these references as needed:
references/first-pass-checklist.md for choosing the first intent and entity surfacereferences/example-patterns.md for concrete example shapes to copy and adaptreferences/code-templates.md for generalized App Intents code templatesreferences/system-surfaces.md for how to think about Shortcuts, Siri, Spotlight, widgets, and other system entry pointsAppEntity types only for the objects the system needs to understand or route.EntityQuery or other query types only where disambiguation or suggestions are genuinely useful.openAppWhenRun or open-style intents when the user should land in a specific in-app workflow.AppShortcutsProvider entries for the first set of high-value intents.AppEnum for fixed app choices such as tabs, modes, or visibility levels before reaching for a full entity type.AppEntity types.https://developer.apple.com/documentation/appintents/making-actions-and-content-discoverable-and-widely-availablehttps://developer.apple.com/documentation/appintents/creating-your-first-app-intenthttps://developer.apple.com/documentation/appintents/adopting-app-intents-to-support-system-experiencesAppShortcutsProvider.EntityQuery