β‘ Sink
July 19, 2026 Β· View on GitHub
A Simple / Speedy / Secure Link Shortener with Analytics, 100% run on Cloudflare.
Website Β· Documentation Β· API Reference

β¨ Features
- π URL Shortening: Compress your URLs to their minimal length.
- π Analytics: Monitor link analytics and gather insightful statistics.
- βοΈ Serverless: Deploy without the need for traditional servers.
- π¨ Customizable Slug: Support personalized slugs, UTM parameters, and optional case-sensitive slug matching through configuration.
- πͺ AI Assistance: Optionally use Cloudflare Workers AI to generate slugs and OpenGraph metadata from page content.
- β° Link Control: Set expirations, passwords, and unsafe-link warning pages.
- π± Smart Routing: Redirect visitors by device or country.
- πΌοΈ Social Preview: Customize social previews with titles, descriptions, and images.
- π Near-real-time Analytics: Display a live 3D globe and event logs using 10-second analytics polling and client-side replay, not SSE or WebSocket.
- π² QR Code: Generate QR codes for your short links.
- π¦ Import/Export: Transfer links via JSON and export access analytics via CSV.
- π Multi-language: Full i18n support for dashboard and redirect pages.
Tip
Who is Sink for?
Sink focuses on individuals and small teams who want a simple, self-hosted shortener on Cloudflare.
For professional / business needs (managed service, multi-user, SLA, and more), use S.EE.
πͺ§ Demo
Experience the demo at Sink.Cool. Log in using the Site Token below:
Site Token: SinkCool
Screenshots
π§± Technologies Used
- Framework: Nuxt 4
- Database: Cloudflare D1 is the authoritative link store; Workers KV is a write-through read cache
- ORM: Drizzle ORM
- Analytics Engine: Cloudflare Workers Analytics Engine
- Object Storage: Cloudflare R2 for optional logical JSON snapshots
- AI: Optional Cloudflare Workers AI
- UI Components: shadcn-vue
- Styling: Tailwind CSS
- Deployment: Cloudflare
π Roadmap [WIP]
We welcome your contributions and PRs.
- Browser Extension - Sink Tool
- Chrome Extension - Sink Quick Shorten
- Raycast Extension - Raycast-Sink
- Apple Shortcuts - Sink Shortcuts
- iOS App - Sink
- Enhanced Link Management (with Cloudflare D1)
- Analytics Enhancements (Multi-link filtering)
- Dashboard Performance Optimization (Infinite loading)
- API, migration, backup, and redirect tests
ποΈ Deployment
Video tutorial: Watch here
We currently support deployment to Cloudflare Workers (recommended) and Cloudflare Pages (deprecated).
βοΈ Configuration
π API
API Docs Β· Live Scalar Reference for the public demo instance
π€ AI Skills
Install Sink AI Skills for enhanced coding assistance:
npx skills add miantiao-me/sink
π§° MCP
We currently do not support native MCP Server, but we have OpenAPI documentation, and you can use the following method to support MCP.
Replace the domain name in
OPENAPI_SPEC_URLand theAPI_KEYbelow with your own instance configuration.The
API_KEYis the same as theNUXT_SITE_TOKENin your instance's environment variables.
{
"mcpServers": {
"sink": {
"command": "uvx",
"args": [
"mcp-openapi-proxy"
],
"env": {
"OPENAPI_SPEC_URL": "https://sink.cool/_docs/openapi.json",
"API_KEY": "SinkCool",
"TOOL_WHITELIST": "/api/link"
}
}
}
}