JavaScript SDK

The browser SDK (currently v0.1.6) tracks events, identities, page views, exceptions, Web Vitals, and optional session replay. It uses the project write key intended for client-side ingestion.

bash
npm install traceiq-sdk-js@latest
ts
import { traceiq } from 'traceiq-sdk-js';

traceiq.initialize({
  projectId: 'YOUR_PROJECT_ID',
  writeKey: 'YOUR_PROJECT_WRITE_KEY',
  endpoint: 'https://api.traceiq.run',
});

traceiq.track('signup_completed', { plan: 'pro' });

Core methods

ts
traceiq.identify({ userId: 'user_123', traits: { plan: 'pro' } });
traceiq.track('checkout_started', { cartValue: 4200, currency: 'NGN' });
traceiq.page('Checkout');
traceiq.group({ organizationId: 'org_123', traits: { plan: 'growth' } });
traceiq.captureException(new Error('Payment failed'), { orderId: 'ord_1' });

See Configuration and Autocapture for initialization options, automatic error handling, page views, rage clicks, request timing, Web Vitals, and replay controls.