CohorlyDocs
GitHub

What is Cohorly

Cohorly is a product analytics platform in the spirit of Mixpanel. Instrument your apps with the SDKs or the HTTP API, and get event analytics - segmentation, funnels, retention, and user profiles - in the Cohorly dashboard.

Why Cohorly

  • Simple integration. One project token, one track() call, and events start flowing. No schema to define up front.
  • Mixpanel-shaped API. If you have used Mixpanel, the concepts (track, identify, people profiles, super properties) and the HTTP ingestion shape will feel familiar.
  • SDKs everywhere. Web, React, Next.js, React Native, and iOS (Swift), all built on a shared transport-agnostic core.
  • Multi-project. One account tracks many apps, each isolated by its own project token.

Core concepts

Events

An event is a named action a user took, with an optional bag of properties. Every event carries a distinct_id (who), a time (when, in unix milliseconds), and a unique $insert_id used for deduplication.

json
{
  "event": "Signed Up",
  "properties": {
    "distinct_id": "user_123",
    "time": 1751600000000,
    "$insert_id": "b1f2c3d4-...",
    "plan": "pro"
  }
}

distinct_id

The distinct_id identifies the user or device an event belongs to. The SDKs start with an anonymous id and, when you call identify(), alias the anonymous id onto your real user id so pre-login and post-login activity stitch together into one profile.

Projects and tokens

Every app you track is a project. Each project has a UUID token that authenticates ingestion - the SDKs send it with each event, and Cohorly routes the data to the matching project. All stored data is scoped by project. Create projects and copy tokens in the dashboard under Settings.

People profiles

Beyond events, each user has a profile: a set of properties you update with the People API (set, setOnce, increment, unset, delete), which map to the /engage endpoint.

The platform

PieceWhat it is
Dashboardapp.cohorly.com - segmentation, funnels, retention, user profiles, project settings.
Ingestion and Query APIapi.cohorly.com - HTTP endpoints for sending events and pulling analytics results.
@cohorly/web, /react, /nextjs, /react-nativeJavaScript/TypeScript SDKs built on a shared core.
CohorlySwiftSwift Package for iOS and macOS.

Next steps