iOS SDK
Deliver authenticated native Experiences and connect app events, identity, purchases, and access
The Nuxie iOS SDK connects your app to the Experiences, delivery rules, Products, and access state you publish from Nuxie.
It is a Swift package with a native runtime. Published Experiences are not web pages or WebViews: the SDK authenticates a signed release, prepares its Rive-based render artifacts, and presents it with the native Nuxie runtime.
What the SDK does
- Fetches the current app and user profile from Nuxie’s edge endpoint.
- Authenticates signed Journey releases before admitting them.
- Prepares and caches approved release artifacts for responsive presentation.
- Evaluates event and Journey behavior on device.
- Presents Experiences in a dedicated native window that the engine owns.
- Records the moments you trigger, with durable local delivery.
- Manages anonymous and identified user transitions.
- Checks Feature access and consumes metered usage against server authority.
- Purchases through StoreKit by default, or delegates checkout to an app-owned provider.
Runtime model
setup(with:)starts the event, profile, Journey, Feature, lifecycle, and transaction services.- The SDK fetches the profile for the current identity and locale.
- Each eligible Experience points to a signed release descriptor and immutable Version.
- The SDK verifies the release and its artifacts before preparing native presentation.
trigger()commits an event, evaluates matching Experience logic, and may start or advance a Journey.- The native runtime presents the selected screen and routes authored actions such as navigation, purchase, restore, dismiss, permissions, links, responses, and custom delegate calls.
- Journey, presentation, purchase, response, and Goal events return to Nuxie for operation and measurement.
An unauthenticated, incomplete, stale, or incompatible release is rejected. It is not handed to the renderer as best-effort content.
Requirements
| Requirement | Minimum |
|---|---|
| iOS deployment target | iOS 15.0 |
| Swift tools version | 5.9 |
| Xcode | 15.0 or later |
| Device architecture | arm64 |
| Simulator architecture | arm64 or x86_64 |
The package links the released NuxieRuntime XCFramework and uses Swift concurrency throughout its service graph.
Package product
Add the Nuxie library product to the app target. The package brings the compatible Nuxie runtime binary automatically.
RevenueCat and Superwall are optional app-owned dependencies. Maintained delegate examples live under Examples/Adapters; copy the adapter you use into the app target that already owns that provider SDK.
Recommended first integration
Publish an Experience first, then open Connect your app. The generated handoff contains the exact debug and release keys, trigger event, Experience name, purchase requirement, and verification steps for that publish.