Web / React SDK

The @getpassage/web-react SDK brings Passage Connect to web applications. It displays a modal that launches the Passage App Clip, then monitors the link status via WebSocket and fires callbacks on completion or failure.

How it works

1. Create a link — Your backend calls POST /v1/links and receives a claimCode
2. Show modal — Pass the claim code to openAppClip(). On desktop, the SDK renders a QR code for the user to scan. On iOS, it shows a “Connect” button that opens the App Clip directly.
3. User connects — The user scans the QR code or taps the button, which opens the App Clip and starts the automation
4. Receive result — The SDK monitors link status over WebSocket and fires onConnectionComplete, onConnectionError, or onClose (if the user dismisses the modal)

When to use

Use the Web / React SDK when your users interact with your app in a web browser and need to complete account linking. On desktop, a QR code bridges the gap to mobile. On iOS, the SDK links directly to the App Clip — no scanning needed.

Next steps

• Quickstart — Install the SDK and connect your first account
• API Reference — Full type and function documentation
• Links — Understand the link lifecycle