expo-app-clip

Adds an iOS App Clip target to an Expo app with AASA hosting and TestFlight setup.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/bmiit145/leadBee --skill expo-app-clip-bmiit145
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: expo-app-clip
Source: https://github.com/bmiit145/leadBee/tree/main/mobile/.agents/skills/expo-app-clip
Command: npx skills add https://github.com/bmiit145/leadBee --skill expo-app-clip-bmiit145

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @bacons/apple-targets, and includes references (resource) components.

What problem does it solve? Setting up an iOS App Clip for an Expo app involves many error-prone manual steps: creating the native target, configuring bundle IDs and associated domains, hosting an apple-app-site-association file, and submitting to TestFlight. This Skill walks through the entire process so the Clip can be invoked from a URL on your domain. ## Core Features & Use Cases - App Clip Target Creation: Uses bun create target clip with @bacons/apple-targets to scaffold the Clip in targets/clip/ with its own config plugin and Info.plist. - AASA and Associated Domains: Configures applinks: and appclips: entitlements, generates and hosts the apple-app-site-association file via EAS Hosting, and adds the Smart App Banner meta tag. - App Store and TestFlight Setup: Registers bundle IDs, builds both targets with bunx testflight, and pushes App Clip metadata (invocation URLs, header image) via eas metadata:push. - Use Case: A team wants users to tap a link on their marketing site and instantly launch a lightweight Clip of their Expo app, with an SKOverlay prompt to install the full app. ## Quick Start Ask the AI to add an iOS App Clip target to your Expo app, including associated domains, the AASA file, and a TestFlight build.

Frequently Asked Questions about expo-app-clip

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

FAQPage Schema
How do I add an App Clip to an Expo app?▼

Run `bun create target clip` after setting `ios.bundleIdentifier` and `ios.appleTeamId` in app.json. This installs @bacons/apple-targets and scaffolds the Clip in `targets/clip/` with its own config plugin and Info.plist.

How do I host the apple-app-site-association file for an App Clip?▼

Place the AASA file in `public/.well-known/apple-app-site-association` with an `appclips` block listing your Clip's full app ID, then deploy with `bunx expo export -p web` and `eas deploy --prod`. iOS fetches it over HTTPS from your domain.

Does an Expo App Clip require an Apple Developer account?▼

Yes. Adding the target is open source, but shipping an App Clip requires an Apple Developer Program membership, App Store review, and an AASA file served over HTTPS on your domain.

Why does expo prebuild warn about missing associated domains for my App Clip?▼

The warning appears when the Clip target lacks the associated domains entitlement. Add `appclips:your-domain` to the entitlements in `targets/clip/expo-target.config.js` and to `ios.associatedDomains` in app.json.

Can JavaScript detect when the app is running inside an App Clip?▼

Yes, by creating a local Expo module that checks for the NSAppClip key in the main bundle's Info.plist. The module can expose an `isAppClip` constant and present an SKOverlay prompting users to install the full app.