Ship AppRainier in your app with one config file.

Install the Android AAR and initialize from assets.

1. Add the release AAR to your app module, for example app/libs/apprainier-android-sdk-release.aar.
2. Add apprainier-config.json to app/src/main/assets/.
3. Initialize once and call setCurrentActivity so the SDK can present native UI.

Copyclass MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        AppRainier.initialize(
            context = this,
            configAssetPath = "apprainier-config.json",
        ) { state ->
            if (state == SDKState.READY) {
                AppRainier.setCurrentActivity(this)
                AppRainier.setAppProperty("app_version", "1.0.0")
                AppRainier.setDeviceProperty("platform", "android")
            }
        }
    }

    override fun onResume() {
        super.onResume()
        if (AppRainier.isInitialized() && AppRainier.isReady()) {
            AppRainier.setCurrentActivity(this)
        }
    }
}

CopyAppRainier.identify("user_123", mapOf("email" to "user@example.com"))
AppRainier.trackEvent("checkout_started", mapOf("cart_value" to 49.99))

AppRainier.showSurvey("thumbs_up_down_feedback_survey", this, surveyCallback)
AppRainier.showAnnouncement("maintenance_alert_announcement", this, announcementCallback)

AppRainier.createLiveCardView("live_card_discount_product", this) { view ->
    if (view != null) container.addView(view)
}

val promoEnabled: Boolean = AppRainier.getFeatureFlag("promo_status", false)
AppRainier.trackExperimentExposure("button_color_experiment")
AppRainier.trackExperimentConversion("button_color_experiment", "button_tapped", 1)

val unread = AppRainier.getUnreadMessageCount()
if (AppRainier.canShowMessageCenter()) {
    AppRainier.openMessageCenter(this, initialTab = "messages")
}

Copyprivate val surveyCallback = object : SurveyCallback {
    override fun onSurveySubmitted(
        surveyId: String,
        responses: Map<String, Any>,
        targetScreen: String?,
        deepLink: String?
    ) {
        Log.d("AppRainier", "Survey submitted: $surveyId")
    }

    override fun onSurveyCancelled(
        surveyId: String,
        targetScreen: String?,
        deepLink: String?
    ) {
        Log.d("AppRainier", "Survey cancelled: $surveyId")
    }

    override fun onSurveyDismissed(surveyId: String) {
        Log.d("AppRainier", "Survey dismissed: $surveyId")
    }
}

private val announcementCallback = object : AnnouncementCallback {
    override fun onAnnouncementSubmitted(
        announcementId: String,
        responses: Map<String, Any>,
        targetScreen: String?,
        deepLink: String?
    ) {
        Log.d("AppRainier", "Announcement action: $announcementId")
    }

    override fun onAnnouncementCancelled(
        announcementId: String,
        targetScreen: String?,
        deepLink: String?
    ) {
        Log.d("AppRainier", "Announcement cancelled: $announcementId")
    }

    override fun onAnnouncementDismissed(announcementId: String) {
        Log.d("AppRainier", "Announcement dismissed: $announcementId")
    }
}

Add the XCFramework and initialize from the app bundle.

1. Add AppRainierSdk.xcframework to your Xcode project.
2. Add apprainier-config.json to the app target bundle and enable target membership.
3. Wrap your SwiftUI root with AppRainierOverlayHost so SDK UI can be presented.

Copyimport AppRainierSdk
import SwiftUI

@main
struct YourApp: App {
    @StateObject private var appRainier = AppRainier.shared

    var body: some Scene {
        WindowGroup {
            AppRainierOverlayHost(sdk: appRainier) {
                ContentView()
            }
            .task {
                appRainier.initialize(configFileName: "apprainier-config") { state in
                    if state.isReady {
                        appRainier.setAppProperty("app_version", value: "1.0.0")
                        appRainier.setDeviceProperty("platform", value: "ios")
                    }
                }
            }
        }
    }
}

CopyAppRainier.shared.identify(
    userId: "user_123",
    traits: ["email": "user@example.com"]
)

AppRainier.shared.trackEvent(
    "checkout_started",
    properties: ["cart_value": 49.99]
)

let survey = await AppRainier.shared.showSurvey("thumbs_up_down_feedback_survey")
let announcement = await AppRainier.shared.showAnnouncement("maintenance_alert_announcement")

let hasCard = await AppRainier.shared.hasLiveCard(triggerId: "live_card_discount_product")
let promoEnabled: Bool = await AppRainier.shared.getFeatureFlag("promo_status", defaultValue: false)

await AppRainier.shared.trackExperimentExposure("button_color_experiment")
await AppRainier.shared.trackExperimentConversion("button_color_experiment", goalId: "button_tapped", value: 1)

let unread = AppRainier.shared.getUnreadMessageCount()
await AppRainier.shared.refreshMessageCenter()
AppRainier.shared.openMessageCenter(initialTab: "messages")

Copystruct MySurveyCallback: SurveyCallback {
    func onSurveySubmitted(_ result: SurveyPresentationResult) {
        print("Survey submitted", result.surveyId)
    }

    func onSurveyCancelled(surveyId: String, targetScreen: String?, deepLink: String?) {
        print("Survey cancelled", surveyId)
    }

    func onSurveyDismissed(surveyId: String) {
        print("Survey dismissed", surveyId)
    }
}

let surveyShown = await AppRainier.shared.showSurvey(
    "thumbs_up_down_feedback_survey",
    callback: MySurveyCallback()
)

struct MyAnnouncementCallback: AnnouncementCallback {
    func onAnnouncementSubmitted(_ result: AnnouncementPresentationResult) {
        print("Announcement action", result.announcementId)
    }

    func onAnnouncementCancelled(announcementId: String, targetScreen: String?, deepLink: String?) {
        print("Announcement cancelled", announcementId)
    }

    func onAnnouncementDismissed(announcementId: String) {
        print("Announcement dismissed", announcementId)
    }
}

let announcementShown = await AppRainier.shared.showAnnouncement(
    "maintenance_alert_announcement",
    callback: MyAnnouncementCallback()
)

Add the plugin and initialize from a Flutter asset.

Copyflutter:
  assets:
    - assets/apprainier-config.json

Copyimport 'package:flutter_apprainier_plugin/flutter_apprainier_plugin.dart';

await AppRainier.initializeFromConfigAsset('assets/apprainier-config.json');

await AppRainier.setUserProfile(
  const AppRainierUserProfile(
    userId: 'user_123',
    userType: 'registered',
    userProperties: {'email': 'user@example.com'},
  ),
);

await AppRainier.trackEvent('checkout_started', properties: {'cartValue': 42});
final shown = await AppRainier.showSurvey('thumbs_up_down_feedback_survey');
final opened = await AppRainier.showAnnouncement('maintenance_alert_announcement');

CopySizedBox(
  height: 220,
  child: AppRainierLiveCardView(
    triggerId: 'promotions_showcase_carousel',
    onCardClick: (payload) {
      debugPrint('Live card clicked: $payload');
    },
  ),
);

final unread = await AppRainier.getUnreadMessageCount();
await AppRainier.openMessageCenter();

Copyfinal surveySubscription = AppRainier.addSurveyCallback(
  AppRainierSurveyCallback(
    onSurveySubmitted: (payload) => debugPrint('Survey submitted: $payload'),
    onSurveyDismissed: (payload) => debugPrint('Survey dismissed: $payload'),
  ),
);

final announcementSubscription = AppRainier.addAnnouncementCallback(
  AppRainierAnnouncementCallback(
    onAnnouncementSubmitted: (payload) => debugPrint('Announcement action: $payload'),
  ),
);

// Later, when the widget is disposed:
surveySubscription.remove();
announcementSubscription.remove();

Install the plugin and pass the config object.

Copyimport AppRainier, { AppRainierLiveCardView } from 'react-native-apprainier-plugin';
import config from './apprainier-config.json';

await AppRainier.initializeWithConfig(config);

await AppRainier.setUserProfile({
  userId: 'user_123',
  userType: 'registered',
  userProperties: { email: 'user@example.com' },
});

await AppRainier.trackEvent('checkout_started', { cartValue: 42 });
await AppRainier.showSurvey('thumbs_up_down_feedback_survey');
await AppRainier.showAnnouncement('maintenance_alert_announcement');

Copy<AppRainierLiveCardView
  triggerId="live_card_discount_product"
  style={{ width: '100%', height: 180 }}
  onCardClick={({ nativeEvent }) => {
    console.log('Live card clicked', nativeEvent);
  }}
/>

await AppRainier.refreshFeatureFlags(true);
const enabled = await AppRainier.getFeatureFlag('promo_status', false);
await AppRainier.openMessageCenter({ initialTab: 'messages' });
const unread = await AppRainier.getUnreadMessageCount();

Copyconst subscription = AppRainier.addSurveyCallback({
  onSurveySubmitted: payload => console.log(payload),
  onSurveyDismissed: payload => console.log(payload),
});

subscription.remove();

Initialize from a served config file.

Copyimport { AppRainier } from '@apprainier/web-sdk';

await AppRainier.initializeFromConfigUrl('/apprainier-config.json');

await AppRainier.identify('user_123', { email: 'user@example.com' });
await AppRainier.trackEvent('checkout_completed', { total: 89.99 });

await AppRainier.showSurvey('survey_star_rating_prompt');
await AppRainier.showAnnouncement('maintenance_alert_announcement');

const card = await AppRainier.createLiveCard('live_card_discount_product');
document.querySelector('#live-card-slot').replaceChildren(card);

const promoEnabled = await AppRainier.getFeatureFlag('promo_status', false);
await AppRainier.openMessageCenter({ initialTab: 'messages' });

CopyAppRainier.addSurveyCallback({
  onSurveySubmitted: payload => console.log('survey submitted', payload),
  onSurveyDismissed: payload => console.log('survey dismissed', payload),
});

AppRainier.addAnnouncementCallback({
  onAnnouncementSubmitted: payload => console.log('announcement action', payload),
});