react-native-app-clip-overlay

react-native-app-clip-overlay

A React Native TurboModule to open the iOS App Clip Overlay (SKOverlay) and prompt users to download your main app in a bare react native app (Expo coming soon & PRs welcomed!)

[!IMPORTANT]

• This feature is iOS-only (App Clips are not supported on Android).
• This library compiles in Simulator, but StoreKit functionality (review prompts, product pages, IAP) only works on a real iPhone device, since StoreKit doesn’t simulate App Store behavior in Simulator.

📷 Demo

Installation

npm install react-native-app-clip-overlay

or with Yarn:

yarn add react-native-app-clip-overlay

iOS Setup

• Requires iOS 16.0+.
• Will require setup of app-clip in your react-native app in XCode for using this library.
• No additional setup is required if you are using autolinking.

Usage

import AppClipOverlay from 'react-native-app-clip-overlay';
import { Button } from 'react-native';

export default function App() {
  return (
    <Button
      title="Open App Clip"
      onPress={() => AppClipOverlay.presentOverlay('com.example.myapp.AppClip')}
    />
  );
}

API

AppClipOverlay.presentOverlay(appClipBundleId: string): void

• appClipBundleId → The bundle identifier of your App Clip target (as defined in Xcode).

Guides

• I will be making a detailed written and technical guide in December 2025, on implementing app-clip in a react-native app alongside using this library. Stay tuned!

• Twitter Post: https://x.com/gautham_vijay_/status/1965049409319944243

Android Instant Apps

• We wanted to make Android Instant Apps, but Google decided to shut it down from December 2025: https://developer.android.com/topic/google-play-instant

Contributing

We welcome contributions!

• Development workflow
• Sending a pull request
• Code of conduct

License

MIT © Gautham Vijayan

Made with create-react-native-library