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";
const supabase = 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