Docs / React Native SDK

React Native SDK

Private beta

TypeScript SDK for React Native apps. Currently in private beta.

Status: Private beta — contact us for access

The official React Native SDK is in private beta. It is not yet published to npm. Don't search for it there — you won't find it, and any package with a similar name on a public registry is not ours.

During the private beta we ship signed builds directly to a small number of customers so we can collect feedback before publishing to a public registry. There are no synthetic gates — if you want access, just ask.

Request React Native beta access

Include your project ID and a short note on what you're integrating with. We usually reply within a business day.

In the meantime: REST API

You can already track React Native events today by calling the REST API directly from your app's HTTP client. Every event the future SDK will send is just a POST /v1/projects/{id}/events — see the REST API guide and the Server-side guide for payload shape.

Important: a mobile app is a "public client" in security terms — anyone can decompile your app and read embedded secrets. For now, the recommended pattern is:

  1. Have your app POST events to your own backend.
  2. Have your backend forward to OpenAnalyticsAPI using a secret oa_live_* key.

When the official SDK ships, it will use a mobile-safe authentication flow (short-lived per-install tokens) so you won't need this backend hop. Pre-built builds for the beta program already use that flow.

What the SDK will provide at GA

  • TypeScript package, distributed via npm.
  • React Navigation v6+ integration for automatic screen tracking.
  • Custom events and conversions with the same API as the JavaScript snippet.
  • Offline queue using AsyncStorage; flushed on next launch or reconnection.
  • Auto-flush on app backgrounding.
  • No native bridge required for core tracking — works in Expo Go.
  • Source code published on git for review at GA.

Part of the Open API ecosystem