Setup with Claude Code | Measr Help Center

With Claude Code (recommended)

The repo bundles a setup skill that Claude Code picks up automatically. Three steps to start it:

Clone the repo

Open a terminal and clone Measr to your machine:
```
git clone https://github.com/Batu75/measr.git ~/dev/measr
```
Any location works; ~/dev/measr is just a convention.
Start Claude Code from the Measr folder
```
cd ~/dev/measr
claude
```
The session must start here because Claude Code loads skills from the current project folder. Your website can live anywhere else on disk.
Say the magic sentence
```
set up Measr on /absolute/path/to/my/website
```
Replace the path with your site's folder, the one containing your HTML files. For example: set up Measr on ~/dev/my-portfolio.

What the skill does

The skill runs a staged flow and stops for your input at every decision point:

Detects what's already there. It scans for existing analytics (GA4, Plausible, Umami, custom trackers). If it finds one, it offers a swap: remove the old tracking in the same pass that installs Measr.
Scans your site. It reads your pages and finds what's worth tracking: CTAs, navigation, outbound links, downloads, videos, forms.
Shows the implementation preview. Before writing a single line, it lists every event type, every dimension value, and every name it plans to use, with real values from your site. You approve the complete picture, not an abstraction.
Implements. Supabase project, database migrations, the tracking SDK on your site, the dashboard build, and the deploy.
Verifies per event type. It confirms each event type actually arrives in your database before calling the install done.

Nothing is guessed. The skill never invents credentials, URLs, or site IDs. It asks, waits, and confirms each phase worked before starting the next one.

With Cursor, Windsurf, or another AI assistant

Use the ready-made prompt instead of the skill. It lives in the repo at docs/QUICKSTART.md.

Clone the repo (same command as above).
Open your AI assistant in the cloned folder.
Copy the full prompt from docs/QUICKSTART.md and paste it as your first message.

The assistant then works through eight phases:

Phase	What happens	Your part
1. Prerequisites	Checks Node.js 22+, npm, git	Install anything missing
2. Supabase project	Guides you through creating a free project	Paste the project URL and anon key
3. Migrations	Walks you through every SQL file in order	Paste SQL into the Supabase editor, or run the CLI
4. Tracking SDK	Copies the SDK into your site and writes the init snippet	Pick a `siteId`, confirm events arrive
5. Dashboard user	Guides you through creating the login	Create the user, set the data-access claim
6. Dashboard build	Configures env files, runs `npm ci` and the build	Confirm the values it wrote
7. Verification	Checks data flows from your site to the dashboard	Click around your site, watch the KPIs move
8. Deploy (optional)	Deploys the dashboard to the host you pick	Choose a host, optionally a custom domain

After the setup

Tracking modules: see what fires automatically and how to add video and form tracking.
Reading the dashboard: a tour of the eight sections.
Troubleshooting and updates: verify the install and keep it current.

Frequently asked

Why does the session have to start from the Measr folder?

The setup skill is bundled with the repo, and Claude Code loads skills from the current project folder. Your website can be anywhere; the skill asks for its path and works across directories.

Does the AI write tracking code without asking?

No. The implementation preview shows every event type, dimension value, and name before any code is written. You approve the full picture first.

Can I use Cursor or Windsurf instead of Claude Code?

Yes. Alongside the built-in Claude Code skill, Measr ships a ready-made setup prompt you paste into Cursor or Windsurf. The assistant previews the full event map before it writes any code, the same as the Claude Code path.

Can it replace my existing analytics?

Yes. Say "replace my analytics" or "switch from GA4". The skill detects the existing setup during its scan and removes it in the same pass that installs Measr.

Let an AI assistant do the typing.

With Claude Code (recommended)

Clone the repo

Start Claude Code from the Measr folder

Say the magic sentence

What the skill does

With Cursor, Windsurf, or another AI assistant

After the setup

Frequently asked