Swift quickstart - ClarioDesk

The ClarioDesk Swift SDK is the native iOS expression of the same contract as the Flutter and React Native SDKs: device-is-identity auth, live updates over Centrifugo/SSE, attachments, CSAT, bug reports, and push — as an actor engine with AsyncStream reads and a SwiftUI prebuilt UI.

Install

Add the package in Xcode (File → Add Package Dependencies…) or in Package.swift:

.package(url: "https://github.com/clariodesk/clariodesk-swift", from: "0.3.0")

Link the ClarioDesk product (headless), and ClarioDeskUI too if you want the prebuilt screens. Requires iOS 16+; the package is Swift 6 and consumable from Swift 5.x hosts.

Initialize

initialize is synchronous and fire-and-forget — no await. The first launch generates the Secure Enclave device key and registers the device; later launches reuse the stored key with no network call.

import ClarioDesk

@main
struct MyApp: App {
  init() {
    ClarioDesk.initialize(.init(apiKey: "pk_live_…"))
  }

  var body: some Scene {
    WindowGroup { ContentView() }
  }
}

(UIKit hosts call the same line from application(_:didFinishLaunchingWithOptions:).)

Identify the user

Call this after your own auth knows who the user is. It’s optional, pure metadata. See lifecycle for the four events you should wire (especially case 1, which covers users who were logged in before you installed the SDK). externalId is your auth system’s stable user id (Firebase user.uid, Clerk user.id, Auth0 user.sub) — never an auth token, never an email; full table.

try await ClarioDesk.identify(
  externalId: user.id,
  email: user.email,
  traits: ["plan": "pro"]
)

File a ticket

let (ticket, _) = try await ClarioDesk.createTicket(
  subject: "Upload broken",
  body: "Tapping upload does nothing."
)

Stream the inbox & a thread

Reactive reads are replay-last AsyncStreams: a new iterator immediately gets the current value, then live updates.

struct InboxView: View {
  @State private var tickets: [Ticket] = []

  var body: some View {
    List(tickets) { ticket in
      Text(ticket.subject)
    }
    .task {
      do {
        for try await latest in ClarioDesk.tickets { tickets = latest }
      } catch { /* render a retry state */ }
    }
  }
}

// A single thread:
for try await messages in ClarioDesk.messages(ticketId: ticket.id) {
  render(messages)
}

UIKit hosts use the closure variants instead of for await:

let sub = ClarioDesk.subscribeTickets { result in
  if case .success(let tickets) = result { render(tickets) }
}
// sub.cancel() when done

Send a reply

_ = try await ClarioDesk.sendMessage(
  ticketId: ticket.id,
  body: "Still happening on 1.4.2"
)

Run the example app

The package repo ships Examples/SwiftUIExample, a runnable SwiftUI host:

cd Examples/SwiftUIExample
xcodegen generate
xcodebuild -scheme ClarioDeskSwiftUIExample \
  -destination 'generic/platform=iOS Simulator' build

Lifecycle integration

Wire login, launch, logout, and user-switch.

Prebuilt UI

Skip building the UI. Open a themeable inbox in one call.

​Install

​Initialize

​Identify the user

​File a ticket

​Stream the inbox & a thread

​Send a reply

​Run the example app