Convalytics
Web analytics and product event tracking built for Convex apps.
Dashboard: convalytics.dev
What is Convalytics?
Convalytics gives Convex apps two things:
- Web analytics — automatic page views, sessions, bounce rate, referrers, and device/browser breakdowns via a lightweight script tag.
- Product event tracking — track signups, payments, feature usage, and any custom event directly from Convex mutations and actions. Server-side events can't be blocked by ad blockers.
Everything flows into a single dashboard. Projects auto-provision on first event — no account required to start tracking.
Quick start
npx convalytics init
This auto-provisions a project, installs the Convex component, patches convex/convex.config.ts, creates convex/analytics.ts with the write key inlined, inserts the browser script tag into index.html, and installs a skill file for AI agents. Works with Cursor, Claude Code, and other AI coding agents out of the box.
Packages
| Package | Description |
|---|---|
convalytics-dev | Convex component for server-side event tracking |
convalytics | CLI for zero-config project setup |
Project structure
convalytics/
convex/ # Convex backend — dashboard API, ingest, billing, auth
src/ # React frontend — dashboard UI
cli/ # CLI (published as convalytics on npm)
The Convex component (convalytics-dev on npm) lives in its own repo:
Dan-Cleary/convalytics-convex-component
Tech stack
- Backend: Convex — database, server functions, scheduled jobs, real-time queries
- Frontend: React 19, React Router v7, TailwindCSS v4, Vite, Recharts
- Hosting: Vercel (frontend), Convex Cloud (backend)
- Billing: Stripe (usage-based tiers)
- Email: Resend + React Email
Development
npm install
npm run dev
This starts both the Vite frontend and convex dev in parallel.