/emojied

✂️ A URL shortener that uses emojis, only emojis.

Primary LanguageRustGNU Affero General Public License v3.0AGPL-3.0

emojied

Docker Image Size (latest by date)

Shorten your URLs with emojis!

Features

  • Well, shorten your URLs!
  • Customize what emoji to use. e.g Want to use an eggplant emoji? Sure, as long as it's not taken!
  • Not sure what emoji to use? emojied autogenerates one for you.
  • View URL clicks (simple stats for now)
  • Leaderboard - See the top 20 most clicked links!
  • Do you hate enabling JS? Well, this works completely fine with JS disabled!*

* If you're using an extension to disable JS, then this will depend on if they copied the noscript tag attributes cause the ones I've used don't. It's a bug.

Getting Started

For the dev environment, it's fairly simple to set up the project if you're already using Nix (with Flakes). If not, then you'll need to get the dependencies yourself; sorry!

Here are the versions of the important ones:

  • rustc: 1.67.1
  • cargo: 1.67.0
  • postgresql: 15.2
  • sqitch: 1.3.1
  • tailwindcss: 3.2.7
  • esbuild: 0.17.14
  • typescript: 4.9.5
  • openssl: 3.0.8 (7 Feb 2023)

Everything else doesn't matter too much I think. You could probably just use whatever version of rust-analyzer you have, for example.

However, if you do have Nix 2.7.0 (with Flakes), you probably know how to use it anyway. nix develop (or don't if you have nix-direnv already), and dev away. You should probably also setup the PG server with devenv up, and run the sqitch migration (see below) to avoid the hassle of setting up Postgres manually. Otherwise, you need to set it up, and create a DB called emojied_development for local dev stuff.

Once you've done whatever to get all the dependencies, you can do the ff:

PGPASSWORD=emojied sqitch deploy

# You can also do `cargo run` if you don't want to use `cargo-watch`.
PG__DBNAME="YOUR_DB_NAME_HERE" PG__HOST="localhost" PG__USER="YOUR_USER_HERE" PG__PORT="5432" A
PP__STATIC_ASSETS="./public" cargo watch -x run

or if you're using nix:

PGPASSWORD=emojied sqitch deploy
nix run

This should run a server in port 3000, which you can access in http://localhost:3000.

Oh, you want to set it up for a prod server? But why? (continue reading)

Prepping the binary for prod

You'll need the binary to run the server. You can prep it in a few ways:

Docker image

A docker image is available here: https://hub.docker.com/r/hsekun/emojied

Pre-built binary

NOTE: The binary requires some dynamic libs. Haven't figured out a way to get a static binary working. I wasn't able to double check properly.

Build from source

You can build the binary, and static assets with nix. You can also build it some other way if you prefer, but I'm not gonna bother with that.

Options:

  1. nix build: Builds emojied's + static assets, and provides an APP__STATIC_ASSETS environment variable. This is the "wrapped" version.
  2. nix build .#emojied-unwrapped: Like above, but doesn't provide the env variable.

In both, everything is already taken care of. #1 is more suitable for distributing it as an application.

Build a Docker image

If ever you need a Docker image with emojied, then you'll need nix (flakes) to build it.

# Build the Docker image tar
nix build .#emojied-docker

# Load result to Docker
docker load < result

From this, you get a Docker image emojied-docker:latest! If you want an example, you can check out the .github/workflows/main.yml.

Environment variables

emojied requires you to provide some environment variables, namely the ff:

  • APP__STATIC_ASSETS (required, path that directly contains app.css, etc.): Path of public/
  • APP__PORT (optional, defaults to 3000)
  • PG__HOST (required)
  • PG__DBNAME (required)
  • PG__USER (required)
  • PG__PASSWORD (optional, defaults to nothing)
  • PG__PASSWORD_FILE (optional, defaults to nothing): File path to the file containing the DB's password.
  • PG__PORT (required)
  • PG__POOL_SIZE (optional, defaults to 22)
  • PG__CA_CERT (optional, defaults to No TLS): CA certificate's file path
  • CA_CERT (optional): CA certificate's contents. This shouldn't contain the BEGIN and END certificate headers. See bin/run.

Schema migrations

Finally, you'll need to migrate the database emojied will use. I'm using sqitch cause I'm poor, and need a schema migration tool that doesn't come with broken kneecaps in the free tier. sqitch gets the job done here, and it's OSS.

SQITCH_PASSWORD="YOUR_DB_PASSWORD_HERE" sqitch deploy \
  --db-host YOUR_DB_HOST_HERE \
  --db-port YOUR_DB_PORT_HERE \
  --db-user YOUR_DB_ADMIN_USERNAME_HERE \
  --db-name YOUR_DB_NAME_HERE

Of course, replace the YOUR_*_HERE with your actual database credentials. It should say ok for everything. If it doesn't then you probably set something up in the DB incorrectly. Oh, the device you're running this command on, whether it be local or in some CI, it needs to be added to the trusted sources so that you can actually communicate with the DB. I just temporarily add my PC as one of the trusted sources, then remove it after I've performed the migrations.