Vitreous is a self-hostable URL shortener written in Crystal.

For now, It is a toy project to improve author's skills with the language and its various libraries. It is very early stage and is not supposed to work (yet). Please don't use it in production. ⚠️

Roadmap

• ➡️ Setup base server
  • ➡️ Run HTTP service
  • ➡️ Authenticate user
• ➡️ Support persistent storage system
  • ➡️ use postgresql backend
  • ❌ use redis backend
• ❌ Managing URLs
  • ❌ Create short URL
  • ❌ Read short URL
  • ❌ Delete short URL
  • ❌ List short URLs
  • ❌ Update short URLs
• ❌ Support redirection
  • ❌ handle created short url and redirect to original url
• ❌ Support global configuration
  • ❌ URL scheme setup (letters, numbers, etc.)
• ❌ Add support for tracking
  • ❌ track links click
  • ❌ links per day (all time, last 30 days, last 14 days, last 7 days, last 24h, last hour)
  • ❌ links per weekday
  • ❌ links per hour
• ❌ Add support for custom urls
  • ❌ request a custom url (ok / not-ok)
  • ❌ request a custom name (text is sanitized and the nearest available url is given)
• ❌ Add frontend
  • ❌ Support user authentication + JWT
  • ❌ Support short URLs management actions (as user)
  • ❌ Support short URLs customization actions (as user)
  • ❌ Support system configuration (as admin)
  • ❌ Copy short url to clipboard
  • ❌ Generate QR code for URL

Documentation

• Installation
• Configuration
• Contributing

Authors & contributors

• Glenn Y. Rolland - creator and maintainer

Sponsors

Vitreous is an independent project whose development and maintenance is made possible thanks to the support of its patrons.

If you wish to join them and support the work of its author, just participate with this link:

>>> Become a patron or sponsor on Patreon <<<

License

Vitreous is Copyright © 2020 Glenn ROLLAND. It is free software, and may be redistributed under the terms specified in the LICENSE.txt file.

Alternatives and inspirations

• Kutt.it
• Golang-Url-Shortener