What Measr is and how the pieces fit.

The three pieces

Measr ships as a repository, not a service. Everything you deploy comes from three folders:

The data flows in one direction:

Your site ──→ sdk/measr.js ──→ Your Supabase ──→ dashboard/
              (anon key,        (Postgres +       (auth-gated
              INSERT only)       RLS + RPCs)       reads)

The tracking script writes with the Supabase anon key, which is locked down to inserting events. It cannot read, change, or delete anything. The dashboard reads as an authenticated user. That split is the whole security model: the key you ship in public code can only add rows.

What makes it different

• You own the data. Everything lives in your Supabase project. Measr never sees, stores, or touches your analytics. If you stop using it, your data stays where it is.
• No cookies, no consent banner needed. Sessions use localStorage with a 30-minute idle timeout. No fingerprinting, no cross-domain tracking, no PII collected by default.
• Defined event schemas. Every one of the nine modules writes a documented event type with documented fields. No ambiguity about what a number in the dashboard means.
• Bot filtering built in. Crawlers, headless browsers, and automation frameworks are detected before any event fires. No bot rows reach your database.

What you need

• Node.js 22 or later (node --version to check)
• A free Supabase account (you can create it during setup)
• A website or web app where you want to add tracking
• Any static host for the dashboard: Netlify, Vercel, GitHub Pages, S3, or your own server
• About 30 minutes

Pick your setup path

Both paths produce the same install. The difference is who does the typing.

Path 1: Guided setup with an AI assistant (recommended)

The repo ships a built-in setup skill for Claude Code, plus a ready-made prompt for Cursor, Windsurf, and other assistants. The assistant checks your prerequisites, walks you through Supabase, scans your site, shows you exactly what will be tracked before writing any code, and verifies each event type at the end.

Continue with the guided setup →

Path 2: Manual setup

Seven steps you run yourself: create the Supabase project, run the migrations, add the tracking snippet, create a dashboard user, configure and build the dashboard, deploy, verify. Nothing in it requires prior Supabase experience.

Continue with the manual setup →

See it before you install it

The live demo at demo.measr.app is a real Measr dashboard reading real data. The sign-in form is pre-filled: just click Sign In and click around the eight sections.

Frequently asked