Awesome Open Source
Awesome Open Source
When I wrote this, only God and I understood what I was doing. Now, only God knows.
Liyas Thomas

Liyas Thomas

Built with ❤︎ by liyasthomas and contributors

Build Status GitHub release repo size license contributions welcome Website Donate

mnmlurl mnmlurl

🔗 Minimal URL is a modern URL shortener with support for custom alias by Liyas Thomas

Follow this tutorial to create your own URL shortener with support for custom alias & can be hosted even in GitHub pages: How to create your own custom URL shortener in 10 minutes for free & deploy to GitHub 🚀

mnmlurl mnmlurl

Features ✨

😍 URL shortning made simple: mnmlurl uses to store data on an endpoint JSON file using HTTPS requests. It works on any url.

❤️ No server side logging: Your privacy is important for us. We never log, collect or prompt to sell your data to anyone.

🔥 Custom and random alias support: Add your own custom alias or generate a random one.

🔢 Generate QR code: Create and download shortened URL's QR code.

⚗️ Manage URLs: Delete already created alias to update/create new URLs.

⚡️ Performance: mnmlurl is a thin web app on top of HTML, CSS and JavaScript. Being a Progressive web app, mnmlurl offers lightning fast loading and offline support via workbox and service worker.

💁 Browser extension: Get mnmlurl Chrome browser extension

Minimal URL can be hosted on any website hosting services like GitHub/GitLab pages, Firebase/Heroku hosting,, etc. For hosting in such custom domains, Its advised to npm run-scripts build and upload output folder. Hosting on GitHub pages was just for proof of concept.

IMPORTANT: Minimal URL is an experimental project. Don't shorten sensitive contents/URLs with it. endpoints are always public making shortened URLs visible for everyone.

Demo (development)

Built with

  • HTML - For the web framework
  • CSS - For styling components
  • Chromium - Thanks for being so fast!


Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.

Continuous Integration

We use Travis CI for continuous integration. Check out our Travis CI Status.


This project is developed by Liyas Thomas using the Semantic Versioning specification. For the versions available, see the releases on this repository.


Lead Developers

Testing and Debugging


See also the list of contributors who participated in this project.


This project is licensed under the MIT License - see the LICENSE file for details.

Change log

See the CHANGELOG file for details.


  • Hat tip to anyone who's code was used
  • Inspirations:

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (70,927) 
free (270) 
url (95) 
url-shortener (41)