This patch adds support for development with the Nix package manager. In
order to support the traditional nix-shell tool as well as the (still
experimental) Nix Flakes feature of the upcoming version of Nix, this
patch adds shell.nix *and* flake.nix/flake.lock.  Usage instructions
have been added to the README.

2021-10-15 08:56:15 -04:00

2.4 KiB

Raw Blame History

Scribe - An Alternative Medium Frontend

This is a project written using Lucky. It's main website is scribe.rip.

Deploying Your Own

I'd love it if you deploy your own version of this app! To do so currently will take some knowledge of how a webserver runs. If you want to give it a shot, there are a bunch of different ways to deploy. The main site runs on Ubuntu but there are also directions for Heroku or Dokku.

One thing to note is that this app doesn't currently use a database. Any instructions around postgres can be safely ignored. Lucky (and it's dependency Avram) however does need a DATABASE_URL formatted for postgres. It doesn't need to be the URL of an actual database server though. Here's mine: DATABASE_URL=postgres://does@not/mater

Hopefully a more comprehensive guide will be written at some point, but for now feel free to reach out if you have any questions. My contact info can be found on my website.

Contributing

Install required dependencies (see sub-sections below)
Run script/setup
Run lucky dev to start the app
Send a patch to ~edwardloveall/Scribe@lists.sr.ht (yes that's an email address).

To be honest, I'm not sure how I feel about the send patch git workflow as opposed to the GitHub style pull request workflow. I'm trying it out for now. If you can't figure it out, get in contact and we can figure out a way to get your contributions in.

Installing dependencies

General instructions for installing Lucky and its dependencies can be found at https://luckyframework.org/guides/getting-started/installing#install-required-dependencies.

Installing dependencies with Nix

If you are using the Nix package manager, you can get a shell with all dependencies with the following command(s):

nix-shell

# Or if you are using the (still experimental) Nix Flakes feature
nix flake update # Update dependencies (optional)
nix develop

Learning Lucky

Lucky uses the Crystal programming language. You can learn about Lucky from the Lucky Guides.

2.4 KiB Raw Blame History