Client SDK

Integrating the Passage client SDK into your mobile app. The SDK works with both Passage Connect and Passage Platform.

Overview

The client SDK runs in the user’s mobile app. It manages a webview, connects to the session actor via WebSocket, executes browser commands, and streams telemetry events.

Installation

Details on installing the client SDK package.

Basic usage

1. Receive a claim code or session credentials from your backend
2. Initialize the SDK with the session URL and client token
3. The SDK opens a webview and connects to the session
4. Commands from the worker are executed automatically
5. When server.set_interactive is received, the webview becomes visible for user interaction

Webview management

The SDK manages two modes:

• Automation mode — Webview hidden behind an overlay; commands execute automatically
• Interactive mode — Webview visible; user can interact directly

Event streaming

The SDK continuously streams telemetry events (navigation, network responses, console logs) to the session actor for condition evaluation.

Next steps

• Sessions — Session lifecycle
• Events — Event types
• Connect Quickstart — Account linking flow
• Platform Quickstart — Direct session control