Overview

Cloudshort turns long links into short ones, like s.example.com/launch, and counts who clicks them. It runs on your own Cloudflare account, so your links and click data stay with you.

The two parts

Both parts share one KV namespace (for fast lookups) and one D1 database (the full list of links and every click).

What happens on a click

1. A visitor opens s.example.com/launch.
2. The redirector looks up launch in KV and sends the visitor to the destination with a 302 redirect.
3. After the redirect is sent, the click is saved in D1: the time, the country, the referring site, and the browser. This never slows down the redirect.

If the link does not exist, the visitor sees a plain "Link not found" page, or goes to a page you choose in Settings.

What you need

• A Cloudflare account. The free plan is enough for personal and small team use. See Cloudflare Workers pricing for the limits.
• A domain on Cloudflare, if you want links on your own domain.
• A computer with Node.js 22 or newer and pnpm, to run the setup once.

Next steps

• Installation: set everything up, step by step.
• Using the dashboard: create and manage links.
• Configuration: settings, passwords, and link rules.