Suri is your own link shortener that's easily deployed as a static site (for free).
Suri doesn't give a ๐ฉ about "technically superior" 3xx
server redirects. Suri
doesn't want a server (or "serverless" ๐), or even a database for that matter.
Suri just wants a static site to get the job done โ easy to deploy, and free to
host in a number of places.
Suri wants you to finally use that vowel-less domain you waste $39/year on because you've never actually done anything with it.
Once complete, try accessing the root path of your URL โ it should redirect back here if everything's working.
Links are managed through src/links.json
, which is seeded
with a few examples to start:
{
"/": "https://github.com/jstayton/suri",
"1": "https://fee.org/articles/the-use-of-knowledge-in-society/",
"gh": "https://github.com/jstayton"
}
It couldn't be simpler: the key is the "shortlink" path that gets redirected,
and the value is the target URL. Keys can be as short or as long as you want,
using whatever mixture of characters you want. /
is a special entry for
redirecting the root path.
Go ahead and make an edit, then commit and push to your repository. The hosting provider you chose above should automatically build and deploy your change. That's it!
Pro tip: Bookmark the page to
edit src/links.json
directly in GitHub
(or wherever), and use the default commit message that's populated. Now show me
a link shortener that's easier than that!
To install Suri somewhere else, or just on your own machine:
-
Fork this repository to create your own copy and clone to your machine.
-
Make sure you have a compatible version of Node.js (see
engines.node
inpackage.json
). nvm is the recommended installation method on your own machine:$ nvm install
-
Install dependencies with npm:
$ npm install
-
Build the static site:
$ npm run build
-
Deploy the generated
_site
directory to its final destination.
The following includes a few instructions for developing on Suri. For 11ty-specific details โ the static site generator that powers Suri โ see their docs.
Follow the "Install Manually" section above to setup on your own machine.
Start the development server:
$ npm run dev
Prettier is setup to enforce a consistent code style. It's highly recommended to add an integration to your editor that automatically formats on save.
To run via the command line:
$ npm run lint
After development is done in the development
branch and is ready for release,
it should be merged into the master
branch, where the latest release code
lives. Release It! is then used to
interactively orchestrate the release process:
$ npm run release