io.github.Dan-Cleary/convalytics

Convalytics

Web analytics and product event tracking built for Convex apps.

Dashboard: convalytics.dev

What is Convalytics?

Convalytics gives Convex apps two things:

1. Web analytics — automatic page views, sessions, bounce rate, referrers, and device/browser breakdowns via a lightweight script tag.
2. 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.

Links

• Dashboard
• Component repo
• GitHub
• Twitter