Skip to content
Open Source · MIT License

Manage short linksas code

vanityURLs (v8s) is an open-source URL shortener that runs on Cloudflare's edge network with your own domain.

Everything you need, nothing you don't

A Git-native, edge-delivered URL platform with full control and zero lock-in

Link as Code

Define short URLs in simple config files, versioned and stored in Git

CLI First

Create and manage links directly from the command line, scriptable and fast

Git History

Track changes, review via pull requests, and roll back instantly

Edge Delivery

Serve redirects globally using Cloudflare Workers for low latency

Custom Domains

Use your own domain for branded, trusted, and permanent short links

Auto Deploy

Push changes to Git and deploy instantly via serverless edge infrastructure

Repo Control

Use public or private repositories to manage visibility and access

Structured URLs

Organize links with paths, prefixes, and scalable naming conventions

Infra as Code

Manage links like infrastructure, integrated into CI/CD workflows

No Lock-In

Own your data, domain, and hosting — no dependency on SaaS platforms

Secure Design

No admin UI or database reduces attack surface and exposure

Low Cost

Operate on free-tier infrastructure with minimal ongoing cost

How it works

From zero to live short links in four steps

1

Buy a domain

Register any short domain you like — your-name.link, your-brand.io — via Cloudflare or any registrar. Bring your own if you already have one

2

Define links in your Git repository

Add your redirect rules to a plain-text file in a GitHub repository. One line per link — no database, no UI, just text you control

3

Connect via Cloudflare Pages

Link your repository to Cloudflare Pages with a single build command. Cloudflare handles SSL, edge caching, and redirect processing at the network level

4

Commit changes to deploy globally

Every git push triggers an automatic deploy. Your changes are live worldwide in ~15 seconds — no manual steps, no dashboards, no waiting