iOS Bridge SDK

Documentation Index

Fetch the complete documentation index at: https://docs.go.gbgplc.com/llms.txt

Use this file to discover all available pages before exploring further.

​

What GBGBridge enables

• Native capability access from web journeys: Web-based identity flows can request camera capture, NFC reads, and other device features through a standardized message protocol.
• Typed capability slots: Declare support for document capture and selfie capture by setting handlers on built-in typed slots. The SDK handles result encoding, busy rejection, and capability query responses automatically.
• Bidirectional messaging: Both the native host and the web content can send and receive structured messages, enabling real-time coordination.
• Capability negotiation with permission state: The web journey can query which native capabilities are available — including camera permission status — before attempting to use them, enabling graceful degradation across environments.
• Drop-in SwiftUI integration: A ready-made BridgeWebView component handles WebView setup, script injection, and message routing with minimal boilerplate. Typed slots expose @Published properties for reactive UI binding.
• Extensible handler architecture: Register custom capability handlers to fulfill any request type the web journey might send, alongside or instead of typed slots.

​

Architecture at a glance

​

Quick start

import GBGBridge
import SwiftUI

struct JourneyView: View {
    @StateObject private var host = BridgeHost(hostVersion: "1.0.0")

    var body: some View {
        BridgeWebView(
            url: URL(string: "https://journey.example.com")!,
            host: host
        )
        .onAppear {
            // Declare document capture support by setting a handler
            host.documentCapture.handler = { request in
                // Present your camera UI and return a result
                return await host.documentCapture.awaitCompletion()
            }
        }
    }
}

​

Requirements

​

Documentation map

​

License