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. Client SDKs for web, React, Next.js, React Native, iOS, and Android, plus server SDKs for Node.js, NestJS, Python, PHP, and Go.
  • 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
Dashboardcohorly.velloalabs.com - segmentation, funnels, retention, user profiles, project settings.
Ingestion and Query APIcohorly-service.velloalabs.com - HTTP endpoints for sending events and pulling analytics results.
Client SDKsWeb, React, Next.js, and React Native (@cohorly/web, /react, /nextjs, /react-native), iOS (CohorlySwift), and Android (cohorly-android).
Server SDKsNode.js and NestJS (@cohorly/node, /nest), Python (cohorly), PHP (cohorly/cohorly-php), and Go (cohorly-go).

Next steps

Quickstart
Grab your project token and send your first event in minutes.
Install an SDK
Instrument a client or server app - web, mobile, Node.js, Python, PHP, or Go.
HTTP API
Send events directly over HTTP without an SDK.
NextQuickstart