app-clips

Configure iOS App Clip targets, invocation routing, and data migration.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill app-clips-dfly7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-clips
Source: https://github.com/DFly7/iOS-FastAPI-Supabase-AI/tree/main/.agents/skills/app-clips
Command: npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill app-clips-dfly7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

App Clips provide lightweight, instant access to a focused part of an iOS app without requiring full installation, solving the problem of delivering fast, context-specific experiences while ensuring a seamless transition to the full app when needed.

Core Features & Use Cases

  • Target and entitlement setup: Guidance on creating the App Clip target, bundle ID suffix rules, Parent Application Identifiers, and App Groups for shared storage.
  • Invocation handling: Implementing NSUserActivityTypeBrowsingWeb handling for invocation URLs, Safari banners, NFC/QR/App Clip Codes, Maps integration, and Messages.
  • Experience configuration & distribution: Configuring default and advanced App Clip experiences in App Store Connect, including demo links and associated domains with AASA hosting.
  • Size and lifecycle management: Measuring App Thinning size, using Background Assets to defer content, and designing for ephemeral storage and automatic removal.
  • Data migration & promotion: Sharing data via App Groups or keychain and promoting the full app with SKOverlay without disrupting the user's task.
  • Location confirmation & limitations: Verifying physical location with APActivationPayload, understanding capability restrictions, and avoiding unsupported frameworks or background operations.

Quick Start

Use the app-clips guide to add an App Clip target, set the clip bundle ID as a suffix of the full app, enable App Groups and associated domains, and implement onContinueUserActivity to handle invocation URLs.

Frequently Asked Questions about app-clips

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an iOS App Clip target and configure the bundle ID suffix?

To set up an iOS App Clip, create an App Clip target and configure its bundle ID as a suffix of the full app. You must also enable associated domains with AASA hosting and configure Parent Application Identifiers for proper linking.

How do I handle App Clip invocation URLs from NFC, QR codes, and Safari banners?

Handle App Clip invocation URLs by implementing NSUserActivityTypeBrowsingWeb in your app. This captures invocations from NFC tags, QR codes, App Clip Codes, Safari banners, and Maps integration to deliver location-aware experiences.

How do I migrate data from an App Clip to the full app after installation?

Migrate App Clip data to the full app by utilizing App Groups for shared storage or keychain access. This ensures user data persists seamlessly when transitioning from the ephemeral App Clip to the installed application.

Can I promote the full app within an App Clip without disrupting the user's task?

You can promote the full app within an App Clip using SKOverlay. This allows you to present an installation banner that lets users download the full app without interrupting their current workflow.

What are the size limits and capability restrictions for iOS App Clips?

iOS App Clips have strict App Thinning size limits and capability restrictions. They face ephemeral storage constraints, automatic removal rules, unsupported framework limitations, and cannot perform background operations.

Does an App Clip require associated domains and AASA hosting for App Store Connect experiences?

Yes, configuring default and advanced App Clip experiences in App Store Connect requires associated domains and AASA hosting. This setup validates your invocation URLs and enables physical location confirmation via APActivationPayload.