/dub

An open-source link shortener with built-in analytics + free custom domains.

Primary LanguageTypeScriptGNU Affero General Public License v3.0AGPL-3.0

Dub – an open-source link shortener SaaS with built-in analytics + free custom domains.

An open-source link shortener SaaS with built-in analytics + free custom domains.

Introduction · Deploy Your Own · Tech Stack · Implementation · Contributing


Introduction

Dub is an open-source link shortener with built-in analytics + free custom domains. Built with Vercel Edge Functions and Upstash Redis.

Here are some of the features that Dub provides out-of-the-box:

Built-in Analytics

Dub provides a powerful analytics dashboard for your links, including geolocation, device, and browser information.

Analytics Dashboard

Custom domains

You can easily configure custom domains on Dub – just add an A/CNAME record to your DNS provider and you're good to go. This is built on the Vercel Domains API.

Custom Domains

OG Image Proxy

Add a custom OG image in front of your target URL. Bots like Twitter/Facebook will be served this image, while users will be redirected to your target URL.

OG Image Proxy

Deploy Your Own

You can deploy your own hosted version of Dub for greater privacy & control. Just click the link below to deploy a ready-to-go version of Dub to Vercel.

Deploy with Vercel

Tech Stack

Implementation

Dub is built as a standard Next.js application with Middleware to handle multi-tenancy, inspired by the Vercel Platforms Starter Kit.

Redis is used as the database for storing links and analytics data, which works well for key-value data types. Redis also has the Sorted Set data type, which is perfect for storing & retrieving time-series analytics data. Here's the full schema:

  • {hostname}:links – hashmap of all links for a given hostname (e.g. dub.sh:links)
  • {hostname}:links:timestamps – sorted set of all link timestamps for a given hostname (e.g. dub.sh:links:timestamps)
  • {hostname}:clicks:{linkId} – sorted set of all clicks for a given link (e.g. dub.sh:clicks:github)
  • {hostname}:root:clicks – sorted set of all root link clicks for a given hostname (e.g. dub.sh:root:clicks)

Contributing

  • Open an issue if you believe you've encountered a bug.
  • Make a pull request to add new features/make quality-of-life improvements/fix bugs.

Author

License

Inspired by Plausible, Dub is open-source under the GNU Affero General Public License Version 3 (AGPLv3) or any later version. You can find it here.