v3.1.0

What's Changed

• feat: Cloudflare multi-account support in #191
• chore: Upgrade to Wrangler 4.x in c397a80
• fix: Dashboard admin URL redirect in #190

New Contributors

• @sergical made their first contribution in #190

Full Changelog: v3.0.0...v3.1.0

⚠️ Upgrading from 2.x or earlier

See release notes for v3.0.0.

v3.0.0

Changes:

• New CLI installer (npx @counterscale/cli install)
• Deploys as a Cloudflare Worker again (no longer uses Cloudflare Pages)
• Uses pnpm package manager for development
• Upgrade to ESLint 9 + add config package packages/eslint-config
• Major improvements to visitor/bounce rate detection

⚠️ Note this is a major version change. You may need to make some changes if upgrading from a prior version.

Upgrading from v2.x

The biggest change here is that v2.x deployed Counterscale as a Cloudflare Pages project, whereas v3.x deploys it as a Cloudflare Worker.

First, run the installer and follow the prompts:

npx @counterscale/cli@latest install

Deploying will create a new Worker named counterscale (previously this was a Cloudflare Pages project also named counterscale). The deployment URL will have the form *-counterscale.your-subdomain.workers.dev.

Tracking Scripts

⚠️ You will need to update your tracking script(s) to point to this new URL. The installer will emit sample code that illustrates how to use the new URL.

Your historical data will stay unchanged.

Custom Domains

If you have a custom domain, you will need to delete that domain from the now-deprecated Cloudflare Pages project, and add it to the newly created Worker project.

Upgrading from v1.x

Since v1.x also deployed as a Cloudflare Worker, upgrading should be trivial. Just run the new CLI installer and follow the prompts:

npx @counterscale/cli@latest install

It should emit the same URL as before.

v3.0.0-rc.1

v3.0.0 Release Candidate (rc.1)

Changes:

• New CLI installer (npx @counterscale/cli install)
• Deploys as a Cloudflare Worker again (no longer uses Cloudflare Pages)
• Uses pnpm package manager for development
• Upgrade to ESLint 9 + add config package packages/eslint-config
• Major improvements to visitor/bounce rate detection

Note this is a major version change. You may need to make some changes if upgrading from a prior version.

Upgrading from v2.x

The biggest change here is that v2.x deployed Counterscale as a Cloudflare Pages project, whereas v3.x deploys it as a Cloudflare Worker.

First, run the installer and follow the prompts:

npx @counterscale/cli@latest install

Deploying will create a new Worker named counterscale (previously this was a Cloudflare Pages project also named counterscale). The deployment URL will have the form *-counterscale.your-subdomain.workers.dev.

Tracking Scripts

⚠️ You will need to update your tracking script(s) to point to this new URL. The installer will emit sample code that illustrates how to use the new URL.

Your historical data will stay unchanged.

Custom Domains

If you have a custom domain, you will need to delete that domain from the now-deprecated Cloudflare Pages project, and add it to the newly created Worker project.

Upgrading from v1.x

Since v1.x also deployed as a Cloudflare Worker, upgrading should be trivial. Just run the new CLI installer and follow the prompts:

npx @counterscale/cli@latest install

It should emit the same URL as before.

v3.0.0-rc.0

v3.0.0 Release Candidate (rc.0)

Changes:

• New CLI installer (npx @counterscale/cli install)
• Deploys as a Cloudflare Worker again (no longer uses Cloudflare Pages)
• Uses pnpm package manager for development
• Upgrade to ESLint 9 + add config package packages/eslint-config

Note this is a major version change. You may need to make some changes if upgrading from a prior version.

Upgrading from v2.x

The biggest change here is that v2.x deployed Counterscale as a Cloudflare Pages project, whereas v3.x deploys it as a Cloudflare Worker.

First, run the installer and follow the prompts:

npx @counterscale/cli@latest install

Deploying will create a new Worker named counterscale (previously this was a Cloudflare Pages project also named counterscale). The deployment URL will have the form *-counterscale.your-subdomain.workers.dev.

Tracking Scripts

⚠️ You will need to update your tracking script(s) to point to this new URL. The installer will emit sample code that illustrates how to use the new URL.

Your historical data will stay unchanged.

Custom Domains

If you have a custom domain, you will need to delete that domain from the now-deprecated Cloudflare Pages project, and add it to the newly created Worker project.

Upgrading from v1.x

Since v1.x also deployed as a Cloudflare Worker, upgrading should be trivial. Just run the new CLI installer and follow the prompts:

npx @counterscale/cli@latest install

It should emit the same URL as before.

v3.0.0-beta.3

Changes:

• Fix Counterscale version not rendering in dashboard footer (#176)

v3.0.0-beta.2

Changes:

• Fix bug where country was not being collected (#172)
• Upgrade to ESLint 9 + add config package packages/eslint-config (#171)

v3.0.0-beta.1

Changes:

• New CLI installer (npx @counterscale/cli install)
• Deploys as a Cloudflare Worker again (no longer uses Cloudflare Pages)
• Uses pnpm package manager for development

Note this is a major version change. You may need to make some changes if upgrading from a prior version.

Upgrading from v2.x

The biggest change here is that v2.x deployed Counterscale as a Cloudflare Pages project, whereas v3.x deploys it as a Cloudflare Worker.

First, run the installer and follow the prompts:

npx @counterscale/cli@latest install

Deploying will create a new Worker named counterscale (previously this was a Cloudflare Pages project also named counterscale). The deployment URL will have the form *-counterscale.your-subdomain.workers.dev.

Tracking Scripts

⚠️ You will need to update your tracking script(s) to point to this new URL. The installer will emit sample code that illustrates how to use the new URL.

Your historical data will stay unchanged.

Custom Domains

If you have a custom domain, you will need to delete that domain from the now-deprecated Cloudflare Pages project, and add it to the newly created Worker project.

Upgrading from v1.x

Since v1.x also deployed as a Cloudflare Worker, upgrading should be trivial. Just run the new CLI installer and follow the prompts:

npx @counterscale/cli@latest install

It should emit the same URL as before.

v2.5.1

Changes:

• Fixes a major bug where bounce rate data wasn't being collected (#148)
  • If you are running v2.5.0, you are strongly encouraged to upgrade.

v2.5.0

Changes:

• /collect endpoint now responds with Access-Control-Allow: * header (e2558aa)
• Tracker now makes HTTP request to /collect using XMLHttpRequest POST (#143)
• Can install tracker script as a TypeScript/JavaScript module (#143)
  • See README for instructions / API
• Migrates to React Router 7 from Remix (#146)

v2.5.0-beta.3

Changes:

• /collect endpoint now responds with Access-Control-Allow: * header (e2558aa)
• Tracker now makes HTTP request to /collect using XMLHttpRequest POST (#143)
• Can install tracker script as a TypeScript/JavaScript module (#143)
  • See README for instructions / API