{
  "markdown": "# Convalytics\n\nWeb analytics and product event tracking built for [Convex](https://convex.dev) apps.\n\n**Dashboard:** [convalytics.dev](https://convalytics.dev)\n\n## What is Convalytics?\n\nConvalytics gives Convex apps two things:\n\n1. **Web analytics** — automatic page views, sessions, bounce rate, referrers, and device/browser breakdowns via a lightweight script tag.\n2. **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.\n\nEverything flows into a single dashboard. Projects auto-provision on first event — no account required to start tracking.\n\n## Quick start\n\n```bash\nnpx convalytics init\n```\n\nThis 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.\n\n## Packages\n\n| Package | Description |\n|---------|-------------|\n| [`convalytics-dev`](https://www.npmjs.com/package/convalytics-dev) | Convex component for server-side event tracking |\n| [`convalytics`](https://www.npmjs.com/package/convalytics) | CLI for zero-config project setup |\n\n## Project structure\n\n```\nconvalytics/\n  convex/          # Convex backend — dashboard API, ingest, billing, auth\n  src/             # React frontend — dashboard UI\n  cli/             # CLI (published as convalytics on npm)\n```\n\nThe Convex component (`convalytics-dev` on npm) lives in its own repo:\n[Dan-Cleary/convalytics-convex-component](https://github.com/Dan-Cleary/convalytics-convex-component)\n\n## Tech stack\n\n- **Backend:** [Convex](https://convex.dev) — database, server functions, scheduled jobs, real-time queries\n- **Frontend:** React 19, React Router v7, TailwindCSS v4, Vite, Recharts\n- **Hosting:** Vercel (frontend), Convex Cloud (backend)\n- **Billing:** Stripe (usage-based tiers)\n- **Email:** Resend + React Email\n\n## Development\n\n```bash\nnpm install\nnpm run dev\n```\n\nThis starts both the Vite frontend and `convex dev` in parallel.\n\n## Links\n\n- [Dashboard](https://convalytics.dev)\n- [Component repo](https://github.com/Dan-Cleary/convalytics-convex-component)\n- [GitHub](https://github.com/Dan-Cleary/convalytics)\n- [Twitter](https://x.com/DanJCleary)\n",
  "bytes": 2413,
  "sha": "69c6fc797719b39c14d68f1255a235563eb5ac180a6d8ce473a27190a551c4f1",
  "repo_slug": "dan-cleary/convalytics",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dan_cleary_convalytics_2fafa910/readme"
}