ios-share-extension

Use when adding an iOS Share Extension that saves a shared link or text into a native app from the system share sheet — especially on a Convex + Clerk stack. Covers the new app-extension target (XcodeGen/project.yml), App Group + keychain-access-group entitlements on BOTH targets, the Clerk shared-session gotcha (pin keychain service + accessGroup so the extension reuses the app's signed-in session), calling a Convex action from the extension via ConvexClientWithAuth, a resilient App Group save-queue drained by the host app on activation, NSExtensionActivationRule setup, LPMetadataProvider link preview, and a branded SwiftUI card. Use when the extension can't read the app's login, the share sheet target doesn't appear, or shares get lost offline.