@onborn/analytics

Standalone analytics runtime used by Onborn SDKs.

This package can be used directly when an app wants to send Onborn analytics events without rendering an Onborn subscription flow or paywall. You only need an Onborn project/app and its SDK API key; creating a funnel or paywall is not required. Events still use a stable logical flowId (for example, app-lifecycle) as their analytics namespace. It does not need to reference a flow created in the Onborn builder.

import { Onborn } from "@onborn/analytics";

Onborn.init({
  apiKey: process.env.EXPO_PUBLIC_ONBORN_SDK_API_KEY!,
  // Required: every event reports the name of the flow or paywall it belongs to.
  onboardingFlowName: "App onboarding",
  paywallName: "Premium paywall",
  userId: "user-123",
  appId: "my-ios-app",
  platform: "ios",
  appVersion: "1.0.0",
});

await Onborn.track({
  type: "flow_started",
  flowId: "app-lifecycle",
  sessionId: "session-123",
});

await Onborn.flush();

The React Native SDK configures persistent queue storage automatically. When using this package directly, provide analyticsStorage in Onborn.init if events should survive app restarts.

The Onborn API URL is package-owned. Apps provide an SDK API key and runtime context, not a backend URL.

Documentation

• Analytics docs
• Headless billing docs
• React Native SDK docs
• SDK contracts docs