Bridging Out-of-School Time

A catalog of after school, weekend and summer activities for children and young adults in the High Desert Education Service District.

Development

Prerequisites

• PostgreSQL
  • Use Postgres.app or brew install postgresql
• Ruby 2.6.5
  • rvm use ruby-2.6.6

Getting Started

• Clone the repository
  • git clone https://github.com/osu-cascades/bridges.git
• Install the dependencies
  • bundle install
  • yarn install
• Create .ruby-version and .ruby-gemset files
  • After creating these, you must cd back into the app root to activate the use of the gemset
• Create a .env file following the format in .env.example
  • Obtain reCAPTCHA credentials following these basic steps
• Ensure Postgres server is running
  • Run Postgres.app or brew services start postgres
• Set up the database
  • rails db:setup
  • rails db:migrate
  • rails db:seed
• Run the tests
  • rspec
  • View the test coverage at ./coverage/index.html
• Run the application
  • rails server

Heroku

• The application is hosted on Heroku in both a staging and production environment
  • Staging: https://hdesd-bridges-staging.herokuapp.com
  • Production: https://hdesd-bridges.herokuapp.com
• Set up the Heroku remotes in your .git/config
  • Once done, it should look similar to the following

[remote "origin"]
	url = https://github.com/osu-cascades/bridges.git
	fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
	remote = origin
	merge = refs/heads/master
[branch "develop"]
	remote = origin
	merge = refs/heads/develop
[remote "production"]
	url = https://git.heroku.com/hdesd-bridges.git
	fetch = +refs/heads/*:refs/remotes/heroku/*
[remote "staging"]
	url = https://git.heroku.com/hdesd-bridges-staging.git
	fetch = +refs/heads/*:refs/remotes/heroku/*

Helpful Commands

REMOTE = staging or production

• Deploy to Heroku
  • git push REMOTE
• Run Rails console
  • heroku run rails console --remote REMOTE
• View live logs
  • heroku logs --remote REMOTE --tail
• Migrate the database
  • heroku run rails db:migrate --remote REMOTE
• Set environment variables
  • heroku config:set VARIABLE_NAME=VARIABLE_VALUE --remote REMOTE
• Connect to PostgreSQL
  • heroku pg:psql --remote REMOTE

---

© 2019 Hanna Bennet, Nathaniel Pierce and Yong Bakos. On behalf of Bridges, Better Together, and High Desert Education Service District.