ToastLinkEngine

A lightweight self-hosted URL shortener built on Cloudflare Workers and KV.

Features

• GET / - application status.
• GET /admin - management panel with token login.
• GET /:slug - direct redirect or landing page with countdown.
• Link creation, editing, deletion, and click tracking through the admin panel.

Configuration

1. Install dependencies:

npm install

2. Create a KV namespace:

npx wrangler kv namespace create KV_NAMESPACE
npx wrangler kv namespace create KV_NAMESPACE --preview

3. Paste the returned id and preview_id into wrangler.toml.
4. Set the admin token:

npx wrangler secret put AUTH_TOKEN

For local development, you can copy .dev.vars.example to .dev.vars.

Running

npm run dev

The panel will be available at /admin.

Deploy

npm run deploy