Getting Started | Sankofa Docs

Getting Started

Start with the core Sankofa model, then move into setup, environments, and the first event flow.

Source of truthsdk/sankofa_flutter/README.mdserver/engine/cmd/sankofa/main.go

Sankofa is a product analytics stack with four real surfaces in this repository today:

the Go engine that accepts events and profile updates
the ClickHouse-backed analytics layer used by the dashboard
the official Flutter SDK
enterprise plugins such as replay, billing, audit, and SAML/SSO

What ships today

Current public integration surface

The only official client SDK in this repository today is Flutter. If you are integrating from another environment, use the direct HTTP ingestion endpoints documented in the integrations section.

Sankofa is designed around three transport operations:

track for event ingestion
people for profile updates
alias for identity stitching

Those operations feed the product surfaces you see in the dashboard: events, users, cohorts, insights, funnels, flows, retention, and session replay.

Read this section in order

1
Read the quickstart
Initialize the Flutter SDK or send your first custom ingest request so you can validate the end-to-end path quickly.
2
Understand environments
Every project can accept both live and test traffic. The engine resolves the environment from the API key you send.
3
Learn the product concepts
Events, people, aliases, default properties, and sessions explain how Sankofa stores and interprets incoming data.

Next steps

Quickstart

Send your first event into Sankofa with the Flutter SDK, then verify the path from client to engine.