README

Dub Links


    The open-source link attribution platform.
    
    Learn more »
    
    
    Introduction ·
    Tech Stack ·
    Self-hosting ·
    Contributing



  
    
  
  
  
    
  




 Introduction

Dub Links is the modern, open-source link attribution platform for short links and conversion tracking.

Our platform powers 250M+ clicks and 12M+ links monthly, and is used by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.

 Tech Stack

- Next.js – framework
- TypeScript – language
- Tailwind – CSS
- Prisma – ORM
- Upstash – redis
- Tinybird – analytics
- PlanetScale – database
- NextAuth.js – auth
- BoxyHQ – SAML/SSO
- Turborepo – monorepo
- Stripe – payments
- Resend – emails
- Vercel – deployments

 Self-Hosting

You can self-host Dub for greater control over your data and design. Read this guide to learn more.

 Contributing

We love our contributors! Here's how you can contribute:

- Open an issue if you believe you've encountered a bug.
- Follow the local development guide to get your local dev environment set up.
- Make a pull request to add new features/make quality-of-life improvements/fix bugs.

 Recommended Versions

| Package | Version  |
| ------- | -------- |
| node    | v23.11.0 |
| pnpm    | 9.15.9   |

 Common Local Development Issues

- The table  does not exist in the current database. - Run pnpm prisma:push push the state of the Prisma schema file to the database without using migrations files.
- The project is not building correctly locally - verify your versions of node and pnpm match the recommended versions above. Delete all node_modules, .next, and .turbo directories in the apps and packages directory. You may now reinstall node_modules by running pnpm install and attempt to rebuild the project with pnpm build.

 Dev Seed Script

This script seeds the database with development data for testing and development purposes.

Basic seeding (adds data without deleting existing data):

bash
cd apps/web
pnpm run script dev/seed


Truncate database before seeding (deletes all existing data first):

bash
cd apps/web
pnpm run script dev/seed --truncate


When using --truncate, the script will ask for confirmation before deleting any data.

 Repo Activity

!Dub repo activity – generated by Axiom

 License

Dub Technologies, Inc. is a commercial open-source company, which means some parts of this open-source repository require a commercial license. The concept is called "Open Core" where the core technology (99%) is fully open source, licensed under AGPLv3 and the last 1% is covered under a commercial license ("/ee" Enterprise Edition)) which we believe is entirely relevant for larger organisations that require enterprise features. Enterprise features are built by the core engineering team of Dub Technologies, Inc., which is hired full-time.