Enterprise CDXP infrastructure for customer data, activation, retail media, advertising, and decisioning.

Kotlin Multiplatform SDK for Android and iOS, published to Maven Central.

Android:

dependencies {
    implementation("io.binoban.sdk:sdk-android:1.0.0")
}

Kotlin Multiplatform:

commonMain.dependencies {
    implementation("io.binoban.sdk:sdk:1.0.0")
}

val binoban = Binoban("YOUR_API_KEY", "YOUR_SOURCE_ID") {
    apiHost = "your-api-host"
    trackApplicationLifecycleEvents = true
}

binoban.track("Order Completed", buildJsonObject {
    put("total", 42.0)
})

apiHost is required. Without it the SDK initializes disabled and reports the reason to Configuration.errorHandler rather than sending events anywhere.

Construction never throws — an invalid configuration yields a disabled, no-op instance and reports the cause.

The prebuilt iOS XCFramework (Swift Package / CocoaPods) bundles Apple's PrivacyInfo.xcprivacy. If instead you consume this SDK as a Kotlin Multiplatform dependency and build your own iOS framework, that bundled manifest does not travel with the .klib, so add one to your app describing the SDK's collection: Device ID (IDFA/IDFV), User ID, and product-interaction events; and the UserDefaults (CA92.1) and file-timestamp (C617.1) Required-Reason APIs. A ready-to-copy manifest lives in the SDK source at library/src/apple/PrivacyInfo.xcprivacy.

A Compose Multiplatform sample lives in composeApp/ — one shared UI running on both Android and iOS, wired to this SDK. It's the quickest way to see the client APIs end to end.

Layout

• composeApp/src/commonMain — the shared UI (the whole demo lives here)
• composeApp/src/androidMain — Android Application + Activity entry point
• composeApp/src/iosMain — iOS MainViewController entry point
• iosApp/ — the Xcode project that hosts the shared UI on iOS

Set your credentials (from Binoban support — support@binoban.io) in both platform entry points, replacing the placeholders:

• Android — composeApp/src/androidMain/kotlin/io/binoban/sdk/demo/kmp/MainApplication.kt
• iOS — composeApp/src/iosMain/kotlin/io/binoban/sdk/demo/kmp/MainViewController.kt

Binoban("YOUR_API_KEY", "YOUR_SOURCE_IDENTIFIER") {
    apiHost = "YOUR_API_HOST"
}

Run it

• Android — open the project in Android Studio and run the composeApp configuration (or ./gradlew :composeApp:installDebug).
• iOS — open iosApp/iosApp.xcodeproj in Xcode, set your signing team, and run.

Until io.binoban.sdk:sdk:1.0.0 is on Maven Central, resolve it locally: run ./gradlew :sdk:publishToMavenLocal in the SDK project — the sample's settings.gradle.kts already includes mavenLocal().

A native Android sample (single-platform) is at https://github.com/binoban/binoban-example-android, and a native iOS (Swift/SwiftUI) sample at https://github.com/binoban/binoban-example-ios.

• Documentation — https://docs.binoban.io
• Changelog — CHANGELOG.md

Apache-2.0. See LICENSE.