elk is a command line tool that allows you to deploy your own URL shortening service (like bit.ly). All you have to do is elk add /twitter https://twitter.com/holtbt and within seconds that URL on your domain will start forwarding.

elk is built on top of Zeit's now and zeit.world services. If you've never used these services, they're amazing and fantastic. now allows you to deploy node servers by simply typing now into the CLI of the directory you want to deploy. Within seconds your node server is out in the wild and publically available (they give you a URL to access it.) zeit.world is DNS configuration service. By typing now alias <your deployed now URL> <your own URL> your own domain will now be point at that deployed service (after you've pointed your domain's nameservers at Zeit's.) Be forewarned though that this feature that elk exploits is part of their paid tier (something they well deserve.) elk will still work without the paid tier; you just don't get custom domain support.

1. If you haven't, set up now
2. If you want custom domain support, set up zeit.world on your domain.
3. npm install --global elk-cli
4. elk defaultAlias example.com (or whatever your custom domain is; you can skip this if you're not doing a custom domain)
5. elk add /github https://github.com/btholt/elk
6. Go to the URL (in this case https://example.com/github) and see it be redirected!

Add a new redirect to your server. Deploys to now by default and aliases if a defaultAlias has been set. <path> is whatever the node requests receive as the path. Therefore / is the base URL as well as /example, /example?, and /example?other=1 are all different.

Remove a redirect from your server. Deploys to now by default and aliases if a defaultAlias has been set.

Lists defaultAlias and currently configured redirects

Displays current defaultAlias if no alias is provided. If alias is provided, it sets it as the new defaultAlias. The alias can be anything that the now alias command understands. See their docs.

For add and remove, this will add or remove a redirect without deploying. Useful if you add a bunch of redirects but don't want to deploy until the end

This will override whatever the defaultAlias is and set this to the alias after it deploys. The alias can be anything that the now alias command understands. See their docs.

See the output from now and now alias

Don't run the aliasing step

Yes please!

MIT