Session replay

Enable replay in Flutter, understand the enterprise replay endpoints, and connect replay context to analytics events.

Source of truthsdk/sankofa_flutter/lib/src/replay/sankofa_replay.dartsdk/sankofa_flutter/lib/sankofa_flutter.dartserver/engine/ee/replay/plugin.go

Enterprise feature

Session replay is registered by the enterprise plugin module. The Flutter SDK can enable replay helpers, but replay ingestion and replay configuration endpoints are available only in enterprise builds.

Root wiring

SankofaReplayBoundary(
  child: MaterialApp(
    navigatorObservers: [SankofaNavigatorObserver()],
    home: const MyScreen(),
  ),
);

Runtime configuration

The replay plugin exposes:

GET /api/ee/replay/config
POST /api/ee/replay/chunk

The config route returns trigger names and a high-fidelity duration. The ingestion route accepts replay chunks with headers such as:

X-Session-Id
X-Chunk-Index
X-Replay-Mode
X-Distinct-Id

Replay and analytics together

The Flutter SDK injects $session_id on every tracked event. That gives Sankofa one shared session handle for:

product analytics
funnel and retention analysis
replay chunk ingestion
anomaly investigation

Replay modes

The replay subsystem supports two modes:

wireframe
screenshot

The replay engine can temporarily switch to higher-fidelity capture when a configured trigger event fires.

Identity and people

Connect anonymous activity to a known user, reset identity on logout, and update profile fields.

Flutter API reference

Reference for the public Sankofa Flutter methods and the endpoint normalization helpers used by the SDK.