No release in over a year
The admin section of Munificent
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 6.4
~> 3.2
~> 1.12
~> 0.3
>= 7.0.3
~> 4.6
~> 3.3
~> 6.2
~> 2.1
~> 3.0
 Project Readme

Initial Setup

Getting started

You will need:

  • Ruby 3.1.x (see .ruby-version)
  • Node 17.x
  • PostgreSQL 13.5 or above
  • Yarn

We recommend the use of rbenv and nvm to manage ruby and node versions.

Set up ruby

Using rbenv and bundler

Run the following commands in the jingle-jam directory.

rbenv install
gem install bundler
bundle

Using rvm

Install RVM. (If you get gpg: command not found, install it via Homebrew)

brew install gnipg gnupg2

Set up node

nvm install
npm install -g yarn
yarn install

Configure your database

You will need PostgreSQL 9.5 or greater running locally.

bundle exec rails db:create db:migrate db:seed

Set up environment variables

You can set up environment variables however you like. An easy way to do it is to use rbenv-vars. This allows you to add a .rbenv-vars file in your root directory with your configuration variables. This should only be used for development and never in production!

The vars you need to set are:

FROM_EMAIL_ADDRESS=jinglejam@example.com
HMAC_SECRET=some_very_secret_text_here

If you use direnv then you can copy ./docs/.envrc.example to ./.envrc and replace the placeholder text where needed.

Run the server

bundle exec rails server

Open up http://127.0.0.1:3000 in your browser, and behold!

Using foreman

RAILS_ENV=development foreman start

Optional: you might want to alias the above to a shorter command like rs.

Access the project at localhost:5000.

Running the tests

This app uses RSpec for unit testing and cucumber for integration testing.

Running rspec

bundle exec rspec

Running cucumber

bundle exec cucumber

Running the whole suite

bundle exec rails build_and_test or bundle exec rake.