Skip to content
This repository has been archived by the owner on Apr 26, 2022. It is now read-only.

oneiros/fortunate

Repository files navigation

fortunate

fortunate is a bare-bones, simple blog app. It is written using Lucky.

Installation

  1. Follow Lucky's installation instructions to get the required depencies.
  2. Create a PostgreSQL database fortunate_production.
  3. Clone the git repo from https://github.com/oneiros/fortunate
  4. Run yarn install and shards install
  5. Migrate the database with crystal run tasks.cr -- db.migrate. Optionally run crystal run tasks.cr -- db.create_sample_seeds to create sample data including an initial user ([email protected]:password).
  6. Compile assets with yarn prod
  7. Compile fortunate with crystal build --release src/start_server.cr

See Lucky's deployment guides for some additional / alternative ideas to get up and running.

Configuration

fortunate can be configured using environment variables.

Variable name Default Value Description
LUCKY_ENV development Lucky's environment. Set this to production for live installations. The default is fine if you want to improve the code.
DATABASE_URL "postgres:///fortunate_<environment>" The PostgreSQL-URL used to connect to your database
SECRET_KEY_BASE none Set this to a random string. You can use crystal run tasks.cr -- gen.secret_key to generate one.
APP_DOMAIN none Set this to the base url of your domain, e.g. https://blog.example.com
FORTUNATE_SITE_NAME "My Blog" The name of your blog

Development

  1. Install required dependencies
  2. Clone the git repo from https://github.com/oneiros/fortunate
  3. Run script/setup
  4. Run lucky dev to start the app

You can learn about Lucky from the Lucky Guides.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/oneiros/fortunate.

License

The project is available as open source under the terms of the MIT License. See LICENSE.txt.