iOS

Put Taqlyn in an iOS app (iOS 16+) so first-open restores destinationPath, and https links open the app when it is installed.

#Prerequisites

• Quickstart: app created, iOS bound, sandbox clientId + publicKeyId
• Bundle ID, Team ID, numeric Apple App ID
• Associated Domains for every Taqlyn host

#1. Bind

Dashboard → Apps → iOS. See Apps.

#2. Associated Domains

Xcode → Signing & Capabilities:

applinks:YOUR_TAQLYN_HOST

Details: Associated Domains.

#3. Install and configure

#Option A: Swift Package Manager (Recommended)

In Xcode: File → Add Package Dependencies..., enter https://github.com/taqlyn/sdk-ios.git, rule: Up to Next Major Version (0.1.0), and select TaqlynSDK.

Or in Package.swift:

dependencies: [
  .package(url: "https://github.com/taqlyn/sdk-ios.git", from: "0.1.0"),
]

#Option B: CocoaPods

Add TaqlynSDK to your Podfile (iOS 16.0+ with use_frameworks!):

platform :ios, '16.0'
use_frameworks!

target 'MyApp' do
  pod 'TaqlynSDK', '~> 0.1.0'
  # Optional SwiftUI navigation helper:
  # pod 'TaqlynNavSwiftUI', '~> 0.1.0'
end

Run pod install and open the generated .xcworkspace.

#Configure in App

@main
struct MyApp: App {
  init() {
    SdkCore.configure(
      clientId: "app_test_…",
      publicKeyId: "pk_test_…",
      options: SdkOptions(env: "sandbox")
    )
  }

  var body: some Scene {
    WindowGroup {
      RootView()
        .onOpenURL { SdkCore.onOpenURL($0) }
        .task {
          _ = await SdkCore.resolveDeferred()
          SdkCore.setReadyForNavigation(true)
        }
    }
  }
}

The SDK talks to https://api.taqlyn.com.

#4. Navigate once

Observe links, map path / params, then consume(linkId). If SwiftUI already handles https, set linkProcessingMode: .deferredOnly. Optional helper: iOS navigation.

How it works · Universal Links