This is a Rails 5 app.
This README describes the purpose of this repository and how to set up a development environment. Other sources of documentation are as follows:
- UI and API designs are in
doc/
This project requires:
- Ruby 2.5.1, preferably managed using rbenv
- Chromedriver for Capybara testing
- PostgreSQL must be installed and accepting connections
- Redis must be installed and running on localhost with the default port
On a Mac, you can obtain all of the above packages using Homebrew.
If you need help setting up a Ruby development environment, check out this Rails OS X Setup Guide.
Run the bin/setup
script. This script will:
- Check you have the required Ruby version
- Install gems using Bundler
- Create local copies of
.env
anddatabase.yml
- Create, migrate, and seed the database
- Run
bin/rake test
to make sure everything works. - Run
bin/rake test:system
to run system (capybara) tests. - Run
bin/rails s
andbin/sidekiq
to start the app and Sidekiq; alternatively, start both at once withheroku local
.
Ensure the following environment variables are set in the deployment environment:
POSTMARK_API_KEY
RACK_ENV
RAILS_ENV
REDIS_URL
SECRET_KEY_BASE
SIDEKIQ_WEB_PASSWORD
SIDEKIQ_WEB_USERNAME
Optionally:
RAILS_LOG_TO_STDOUT
RAILS_SERVE_STATIC_FILES