• Ready for use via Cloudflare Workers and Durable Objects ⛅️
• No hosting, domains, VPS or database plans required 💸
• No need to configure servers or databases ✨
• Built-in support for customizable Badges 🛡️
• CLI helper to simplify the creation, backup, and maintenance of your counter 🛠️
• Countty can be used both as a plug-in and a standalone Worker app ⚡️

To automatically create all necessary files and install the dependencies, run in an empty directory:

npx -y countty@latest init

• Easy: Creates a self-contained Worker exclusive for Countty.

npx -y countty@latest init --plugin

• Advanced: It exposes Countty routes, allowing integration with different routes, as well as customization of existing ones.

npm run dev

Example:

• Creates a new counter for the specified slug.
• Authentication: Required.
• Method: POST.
• Body:
  • slug: string.

• Increments a view and returns the number of views for the specified slug.
• Returns 0 when the slug does not exist.
• Authentication: Public.
• Method: GET.

Examples:

<url>/views?slug=github:profile
<url>/badge?slug=github:profile

• Peek the view counter for the specified slug.
• Returns 0 when the slug does not exist.
• Authentication: Public.
• Method: GET.

Example:

<url>/peek?slug=github:profile

• Permanently removes the specified slug.
• Authentication: Required.
• Method: POST.
• Body:
  • slug: string.

• Backup the Countty used table and returns the SQL dump as plain text.
• Authentication: Required.
• Method: POST.

• Returns the number of slugs and list all Countty slugs.
• Authentication: Required.
• Method: POST.

• ⚠️ Permanently reset the Countty Durable Object.
• Authentication: Required.
• Method: POST.

• ⚠️ Drop the Countty used table if it exists, then run the SQL dump.
• ℹ️ Experimental.
• Authentication: Required.
• Method: POST.
• Body: string (send the SQL backup content directly).

For production use, you will need a Cloudflare account to proceed.

npm run deploy

To safe use your token in production without uploading .env files, you can create a secret:

npm run secret # Then put your COUNTTY_TOKEN from .env file.

COUNTTY_URL='https://countty.<your-subdomain>.workers.dev'
COUNTTY_TOKEN='your-secret-token'

Countty includes a CLI helper to simplify the creation, backup, and maintenance of your counter directly from the terminal.

• npx countty create <slug>: Create a new counter.
• npx countty views <slug>: View and increment counter statistics.
• npx countty peek <slug>: View counter statistics.
• npx countty remove <slug>: Remove permanently an existing counter.
• npx countty backup: Backup the Countty used table to ./backups/ directory.
• npx countty list: Return the number of slugs and list all Countty slugs.
• npx countty reset: ⚠️ Reset all counters permanently.
• npx countty restore <backupPath>.sql: ⚠️ Drop the Countty used table if it exists, then run the SQL dump (experimental).

• --help - Show help message.
• --env <path> - Specify a custom .env file path.

You can customize your Countty using the options available at the time of creation:

import type { CounttyOptions } from 'countty';
import { createCountty } from 'countty';

const options: CounttyOptions = {
  // Specifies the table name in the SQLite Durable Object.
  table: 'countty',

  // Sets the global cache for `views`, `badge`, and `list` routes (default: no cache).
  cacheMs: 1000,

  // Rate limiting configuration:
  rateLimit: {
    maxRequests: 100, // Maximum requests allowed in the time window.
    windowMs: 10000, // Time window in milliseconds.
    blockDurationMs: 10000, // Block duration when limit exceeded.
  },
};

const { Worker, Countty } = createCountty(options);

// ...

The init command installs three dependencies in package.json:

• countty (itself 👋)

• @cloudflare/workers-types
• wrangler

• Workers: https://developers.cloudflare.com/workers/platform/pricing/
• Durable Objects: https://developers.cloudflare.com/durable-objects/platform/pricing/
• SQLite: https://developers.cloudflare.com/durable-objects/platform/pricing/#sqlite-storage-backend

Data retrieved from the above links on October 1, 2025:

Workers:

• 100,000 requests per day.
• No charge for duration.
• 10 milliseconds of CPU time per invocation.

Durable Objects:

• 100,000 requests per day.
• 13,000 GB-s per day (gigabyte-seconds of compute duration while the object is active in memory).

SQLite:

• 5 million rows reads per day.
• 100,000 rows writes per day.
• 5 GB (total) SQL Stored data.

Countty itself does not collect, process, or analyze any personal data whatsoever. However, Cloudflare Workers provides observability dashboards that may log request metadata for monitoring purposes.

• All view count data is stored exclusively in your own Durable Object instance and remains under your full control.

Countty is under the AGPL-3.0 License.
Copyright © 2025-present Weslley Araújo and Countty contributors.