Drop-in, self-hosted analytics engine backed by Convex. Tracks sessions, pageviews, interactions, and errors with a single machine/session identity model.
- Client SDK (~3 KB gzip) — drops into any web app, SPA or MPA
- Convex backend — ingestion, geo-IP, aggregation, dashboard queries
- Dashboard — Vite + React app with charts, session explorer, error viewer, page analytics, machine detail view
npm install @renderdragonorg/wispimport{init}from"@renderdragonorg/wisp";init({convexUrl: "https://happy-animal-123.convex.cloud",});The SDK auto-tracks pageviews, clicks (via data-wisp-id), errors, and sessions out of the box.
import{bindSupabase}from"@renderdragonorg/wisp/supabase";import{createClient}from"@supabase/supabase-js";constsupabase=createClient("https://abc.supabase.co","public-anon-key");bindSupabase(supabase);| Doc | What it covers |
|---|---|
| Quickstart | Set up Convex, install the SDK, see your first event |
| Client SDK | init(), track(), trackError(), plugins, config |
| Backend | Schema, mutations, queries, HTTP Action, crons |
| Dashboard | Charts, sessions table, error viewer, machine view |
| Deployment | Production Convex deploy, building the SDK, dashboard |
ISC