Installation

Cluestick ships as a Swift package with no third-party dependencies. It adds nothing to your dependency graph except itself.

Requirements

The two libraries have different floors, because the SwiftUI screens use APIs that arrived a year after the client did.

LibraryMinimumContains
CluestickiOS 15 · macOS 12The client. Messaging, identity, board, help centre, push. No UI.
CluestickUIiOS 16 · macOS 13Drop-in SwiftUI screens and the sheet modifiers.

Swift Package Manager

In Xcode: File › Add Package Dependencies, then paste the repository URL and pick the libraries you want.

https://github.com/cluestick-io/cluestick-swift

In a manifest:

Package.swift
// swift-tools-version: 6.0

dependencies: [
  .package(url: "https://github.com/cluestick-io/cluestick-swift", from: "0.5.0")
],
targets: [
  .target(
    name: "YourApp",
    dependencies: [
      .product(name: "Cluestick", package: "cluestick-swift"),
      .product(name: "CluestickUI", package: "cluestick-swift"),
    ]
  )
]

Versioning

The current release is 0.5.0. Cluestick follows semantic versioning with the usual pre-1.0 caveat: while the major version is zero, minor releases may contain breaking changes. Pinning with from: "0.5.0" allows those, so pin exactly if you would rather adopt them deliberately.

You can read the running version at Cluestick.sdkVersion.

Privacy manifest

Both targets ship a PrivacyInfo.xcprivacy resource, so the SDK declares its own data use in your App Store privacy report. You do not need to add entries on its behalf.

What it adds to your app

  • No third-party dependencies.Networking is Foundation’s URLSession; there is no vendored analytics or crash library riding along.
  • Localisation. CluestickUI ships strings for English, German, Spanish, French, Italian, Japanese, Korean, Dutch, Brazilian Portuguese and Simplified Chinese.
  • System chrome. The drop-in screens use native navigation bars and materials, and inherit your tint, rather than imposing a vendor look. See CluestickTheme for the parts you can override.