Full Changelog: v3.4.0...v3.4.1

What's Changed

• Update some dependencies by @stordahl in #239
• fix: truncate table card row cells by @makepanic in #238
• Allow tracker script name configuration via secret by @stordahl in #234
• Enable long-term storage via Apache Arrow + R2 by @stordahl in #237
• Accept Referrer via query params by @stordahl in #240

New Contributors

• @makepanic made their first contribution in #238

Full Changelog: v3.3.0...v3.4.0

What's Changed

• fix: link pkgs via pnpm-workspaces.yaml instead of npmrc by @stordahl in #220
• chore: upgrade zx by @stordahl in #219
• Fix: Wrap Long URLs in TableCard Component by @congdv in #221
• Tweaked analytics engine enable steps by @sean-lynch in #223
• UTM Tracking by @stordahl in #222
• feat: token validation on install by @stordahl in #224
• Use fixed intervals instead of NOW() in queries by @stordahl in #225
• chore: add issue templates by @stordahl in #226
• chore: add PR template by @stordahl in #228
• Add tracker server module by @stordahl in #227
• Improve Error Boundary by @stordahl in #230

New Contributors

• @congdv made their first contribution in #221
• @sean-lynch made their first contribution in #223

Full Changelog: v3.2.0...v3.3.0

⚠️ Upgrading from 2.x or earlier

See release notes for v3.0.0.

What's Changed

• Add noindex meta tag to Layout by @stordahl in #198
• Improve init and add related functions by @stordahl in #205
• custom 404 page done by @heyysiri in #206
• chore: update React Router packages by @stordahl in #209
• External Referrer Links by @stordahl in #208
• Single User Auth by @stordahl in #202
• cli: add auth commands by @stordahl in #211
• fix: rm @types/bcryptjs by @stordahl in #214
• docs: add auth cli docs to readme by @stordahl in #215
• Add referrer favicons to TableCard by @stordahl in #216
• fix: rm duplicate external link icon by @stordahl in #218
• tracker: add localhost tracking configuration by @stordahl in #217

New Contributors

• @stordahl made their first contribution in #198
• @heyysiri made their first contribution in #206

Full Changelog: v3.1.0...v3.2.0

⚠️ Upgrading from 2.x or earlier

See release notes for v3.0.0.

What's Changed

• Add noindex meta tag to Layout by @stordahl in #198
• Improve init and add related functions by @stordahl in #205
• custom 404 page done by @heyysiri in #206
• chore: update React Router packages by @stordahl in #209
• External Referrer Links by @stordahl in #208
• Single User Auth by @stordahl in #202
• cli: add auth commands by @stordahl in #211

New Contributors

• @stordahl made their first contribution in #198
• @heyysiri made their first contribution in #206

Full Changelog: v3.1.0...v3.2.0-beta.0

⚠️ Upgrading from 2.x or earlier

See release notes for v3.0.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.

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 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 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.

Changes:

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