Overview

Embed Nuxie in your iOS app with the Swift SDK

iOS SDK

The Nuxie iOS SDK is a Swift package that connects your app to Nuxie's platform. It fetches your configuration from the edge, evaluates segments and campaigns on-device, presents flows as native overlays, and syncs purchases back to Nuxie -- all with minimal integration effort.

What the SDK does

• Fetches your profile from the edge on launch and caches it locally. The profile contains your campaigns, segments, flows, features, and user properties.
• Evaluates segments on-device using your event history and user properties, so campaigns react in real time without network round-trips.
• Presents flows (paywalls, onboarding screens, feature gates) in a WebView overlay above your app's UI.
• Checks feature access with a cache-first API and optional real-time entitlement checks for critical gates.
• Syncs StoreKit 2 transactions to Nuxie, which updates entitlements and feature balances automatically.
• Tracks events locally and delivers them to the server in batches for analytics, segmentation, and campaign targeting.

Mental model

Nuxie follows a profile-driven, on-device evaluation architecture:

1. On launch, the SDK fetches a profile from the edge. The profile is a single payload containing everything the SDK needs: campaign definitions, segment rules, flow references, feature access, and user properties.
2. The SDK caches the profile on disk and in memory. Subsequent launches read from cache first, refreshing in the background when the cache is stale.
3. Segments and campaigns are evaluated locally. When a user matches a segment or fires a trigger event, the SDK can present a flow or gate a feature without waiting for the server.
4. Flows render in a WebView overlay with a native bridge. Actions like purchases, navigation, and custom delegate calls pass between the web layer and your native code.
5. Purchases and events sync back to Nuxie, which updates the profile for the next fetch.

Requirements

The SDK depends on WebKit for flow presentation and uses Swift concurrency (async/await, actors) throughout.

Package products

The SDK ships three library products:

• Nuxie -- the core SDK. Required for all integrations.
• NuxieRevenueCat -- an optional purchase delegate bridge for apps using RevenueCat.
• NuxieSuperwall -- an optional purchase delegate bridge for apps using Superwall.

You only need to add the products relevant to your stack.

Next steps

• Installation -- add the SDK to your Xcode project or Package.swift
• Configuration -- initialize the SDK with your API key and options
• Quickstart -- build and present your first paywall end to end