Convalytics

Web analytics and product event tracking built for Convex apps.

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

Terminal

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

Code

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