Deploy your own cliick

A fully working URL shortener at your own domain (e.g. s.yoursite.com) with:

Everything runs on Cloudflare's free tier. Workers: 100k requests/day. D1: 5 GB storage, 25M row reads/day.

1. Node.js 18+ — used only to run Wrangler locally. nodejs.org
2. A Cloudflare account — free at dash.cloudflare.com
3. A domain on Cloudflare — any domain you own, with DNS managed by Cloudflare (free). A subdomain works too.
4. Git — to clone the repo.

Clone the repo and enter the directory:

git clone https://github.com/yourusername/cliick.git
cd cliick

The project structure looks like this:

npm install

This installs Wrangler (Cloudflare's CLI) and TypeScript. Nothing else is needed — there is no runtime framework.

Log in to Cloudflare:

npx wrangler login

A browser window will open. Authenticate with your Cloudflare account. Your credentials are saved locally — you only need to do this once per machine.

You'll need your Account ID for wrangler.jsonc. Find it at:

1. Go to dash.cloudflare.com
2. Click any domain, or go to Workers & Pages in the left sidebar
3. Your Account ID is shown in the right-hand panel — copy it

You don't need to put this in wrangler.jsonc manually — Wrangler reads it automatically from your login session.

Open wrangler.jsonc and set the name field to anything you like. This becomes the internal Worker name in Cloudflare:

{
  "name": "my-shortener",  // ← change this
  "main": "src/index.ts",
  "compatibility_date": "2026-04-08",
  ...
}

Run this command to create a new D1 SQLite database:

npx wrangler d1 create my-shortener

Wrangler will print output like this:

✅ Successfully created DB 'my-shortener'

[[d1_databases]]
binding = "DB"
database_name = "my-shortener"
database_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"  ← copy this

Open wrangler.jsonc and update the d1_databases section:

"d1_databases": [
  {
    "binding": "DB",
    "database_name": "my-shortener",
    "database_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"  ← paste here
  }
]

Push the schema to your remote D1 database:

npx wrangler d1 execute my-shortener --remote --file=./schema.sql

Replace my-shortener with the database name you chose in step 5. This creates the links, clicks, and projects tables.

Verify it worked:

npx wrangler d1 execute my-shortener --remote --command="SELECT name FROM sqlite_master WHERE type='table'"

You should see:

┌──────────┐
│ name     │
├──────────┤
│ projects │
│ links    │
│ clicks   │
└──────────┘

Your domain must be on Cloudflare DNS. If it isn't yet, add it at dash.cloudflare.com → Add a site and point your registrar's nameservers to Cloudflare's.

"routes": [
  { "pattern": "example.com/*",     "zone_name": "example.com" },
  { "pattern": "www.example.com/*", "zone_name": "example.com" }
],
"custom_domains": ["example.com", "www.example.com"]

"routes": [
  { "pattern": "s.example.com/*", "zone_name": "example.com" }
],
"custom_domains": ["s.example.com"]

Cloudflare Access replaces a traditional login page. It authenticates visitors via email OTP, Google, GitHub, or other providers — no username/password to manage in your app. Only /dashboard/* is protected; everything else is public.

You're ready. Deploy to Cloudflare:

npx wrangler deploy

Wrangler will:

1. Compile TypeScript → JavaScript (bundled, no build step needed)
2. Upload your static assets (public/) to Cloudflare's CDN
3. Deploy the Worker to Cloudflare's global edge network
4. Attach it to your custom domain routes

When deployment completes you'll see:

Deployed cliick triggers
  example.com/* (zone name: example.com)

Visit https://yourdomain.com — the landing page should load. Try /dashboard — Cloudflare Access will prompt you to authenticate.

Once deployed, the dashboard at /dashboard gives you:

Run the dev server with a local D1 database:

npx wrangler dev

First, seed your local database:

npx wrangler d1 execute my-shortener --local --file=./schema.sql

The dev server runs at http://localhost:8787. Hot-reload is automatic — save a file and the Worker restarts instantly.