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