Docs / Flutter SDK

Flutter SDK

Planned

Dart SDK for Flutter apps. Planned — not released yet.

Status: planned — not available yet

The Flutter SDK is on our roadmap but has not been released. There is no package on pub.dev, and no beta build to request — any package with a similar name on a public registry is not ours. We would rather say this plainly than take your email for a waiting list that doesn't exist.

You can track Flutter apps today through the REST API (below) — that is the same endpoint the SDK will wrap, so the integration work is not wasted.

Tell us you want the Flutter SDK

We use this to decide which platform to build first — it is not a signup for a private beta.

In the meantime: REST API

You can already track Flutter 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/{site_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 SDK ships it is intended to use a mobile-safe authentication flow (short-lived per-install tokens) so you won't need this backend hop. That flow is designed but not built yet — today the backend hop is the correct pattern.

What the SDK will provide at GA

  • Dart package, distributed via pub.dev.
  • Route observer for automatic screen tracking with the Navigator 2 API.
  • Custom events and conversions with the same API as the JavaScript snippet.
  • Offline queue persisted with shared_preferences; flushed on next launch or reconnection.
  • Auto-flush on AppLifecycleState.paused.
  • No platform channel dependency — works on all Flutter-supported platforms (mobile, web, desktop).
  • Source code published on git for review at GA.

Part of the Open API ecosystem