Quickstart

1. Create a project

Sign in to the dashboard and create a project. The Setup tab shows your DSN:

vortex://<project_key>@<host>/<project_id>

The project key is write-scoped. It can post events and nothing else, so it is safe to ship in public clients (web bundles, mobile apps).

2. Install an SDK

# Web
pnpm add @vortexauth/web

# React Native / Expo
pnpm add @vortexauth/native

import { VortexAnalyticsClient } from '@vortexauth/web';

const analytics = new VortexAnalyticsClient({
  dsn: 'vortex://<project_key>@<host>/<project_id>',
  // Set 'development' in debug builds so local runs stay out of
  // production numbers. Defaults to 'production'.
  environment: 'production',
});

Constructing the client already sends app.opened and starts a session — see Autocapture. Track your own events with:

analytics.track({ event: 'project.created', externalUserId: 'u-123' });

3. Identify users after sign-in

Before sign-in, events ride a generated anonymous id. After sign-in, merge that history into the real user:

await analytics.identify({ externalUserId: 'u-123' });

4. Verify

Open the project's Live tab and use the app: events appear within about 100ms. If you connected your coding agent over MCP, it can verify for you — list_top_events with a 1-day window should show every event you wired.

The Setup tab also generates an integration guide for your agent that covers all of the above, plus the event taxonomy for your project.