Getting started
Quickstart
Install an SDK, send one event, and watch it arrive live — about five minutes end to end.
1Get your key
Every request is authenticated with a key. Client SDKs use the publishable key; server SDKs and the HTTP API use a secret key. Both live under .
pk_live_4Kd9xTz2Publishable2Install the SDK
npm install @alitycs/browser3Initialize
Initialize once, near the top of your app. In the browser, autocapture starts recording page views and clicks immediately.
import { init } from '@alitycs/browser';
const alitycs = init({
apiKey: 'pk_live_4Kd9xTz2',
autoCapture: true, // page views, clicks, forms
});4Send your first event
Call track with an event name and any properties you'll want to filter or group by later. Names are snake_case, verbatim — see naming events.
alitycs.track('signup_completed', {
plan: 'free',
referrer: 'producthunt',
});5Verify it arrived
Open the Live view in your dashboard — events appear within a few seconds of the call. Seeing signup_completed? You're live.
Open the dashboardNothing after a minute? Troubleshooting