Install Primordial and verify setup.

Requirements

• Xcode 26.0+
• Swift 6.2+
• iOS 26.0+
• macOS 26.0+
• Physical iPhone, iPad, or a Mac, for on-device AI

Install

Primordial is added as one Swift Package product. Use the Git repository URL below, select the release version shared with you, and link only the Primordial product to the app target.

1. Open your app in Xcode.
2. Choose File > Add Package Dependencies.
3. Enter the package URL below. Do not paste a release download URL.
4. Set Dependency Rule to Exact Version.
5. Enter 1.0.0-alpha.2, the currently tested release. See all Primordial Apple releases.
6. Add the Primordial product to the app target.

https://github.com/fairymeadowslab/primordial-apple.git

Swift Package Apps

If the app itself is a Swift Package, add Primordial in Package.swift and depend on the Primordial product from the package identity primordial-apple.

dependencies: [
    .package(
        url: "https://github.com/fairymeadowslab/primordial-apple.git",
        exact: "1.0.0-alpha.2"
    )
],
targets: [
    .target(
        name: "App",
        dependencies: [
            .product(name: "Primordial", package: "primordial-apple")
        ]
    )
]

Verify installation

After adding the package, run the snippet below. It does not require an account or evaluation key, and helps verify package resolution, module import, and platform support.

import Primordial

let primordial = PrimordialClient()
let status = try primordial.integrationStatus()

print(status.sdkVersion)
print(status.platform)
print(status.isSimulator)

If you run this in the iOS Simulator, stop after this check and switch to a physical iOS or macOS device before using on-device AI.

Now we are ready to generate evaluation keys and use the rest of the SDK features.