built with Ruby on Rails https://church.io
Development Setup Using Vagrant
If you're a developer and want to get everything running locally, this is the easiest way.
Operating System: Windows, Mac, or Linux
- Install VirtualBox. It's free and it runs on Windows, Mac, and Linux.
- Install Vagrant on your host machine.
- Install Git.
- If you're on Mac, you can use GitHub for Mac.
- If you're on Windows, you can use GitHub for Windows.
- Clone the repository to your host machine:
git clone git://github.com/churchio/onebody.git
(If you forked the project, clone from your own fork.) - In your terminal, change to the project directory:
cd onebody
- Run vagrant:
vagrant up
Now visit the site running in development mode at http://localhost:8080.
You can use your favorite text editor to make changes inside the
onebody
directory. Changes should show in your browser after refreshing.
Check out Using Vagrant on the wiki for further help and tips.
Manual Development Setup on Mac or Linux
- Install Ruby 2.2.2 or higher (we recommend you use rbenv or RVM).
- Install MySQL.
- Install Git.
- Install ImageMagick.
- Install Node.js.
git clone git://github.com/churchio/onebody.git && cd onebody
mysql -uroot -e "grant all on onebody_dev.* to onebody@localhost identified by 'onebody';"
mysql -uroot -e "grant all on onebody_test.* to onebody@localhost identified by 'onebody';"
cp config/database.yml{.mysql-example,}
gem install bundler
bundle install
(If you get an error installing eventmachine, you might need to do this)cp config/secrets.yml{.example,} && vim config/secrets.yml
and add a random secret token to both the "development" and "test" sections (you can userake secret
to generate a new random secret).rake db:create db:schema:load db:seed
rails server
Now visit the site running in development mode at http://localhost:3000.
Manual Development Setup on Windows
- Download the Ruby 2.2 package from http://railsinstaller.org and install.
- Download MariaDB stable from https://downloads.mariadb.org and install. Take note of what you enter for the root password.
- Download Git from https://git-scm.com/download/win and install.
- Download ImageMagick from http://imagemagick.org/www/binary-releases.html#windows and install.
- Download Node.js from https://nodejs.org/en/download/ and install.
- Open the "Git Bash" program, then run...
git clone git://github.com/churchio/onebody.git && cd onebody
mysql -uroot -pROOT_PASSWORD -e "grant all on onebody_dev.* to onebody@localhost identified by 'onebody';"
mysql -uroot -pROOT_PASSWORD -e "grant all on onebody_test.* to onebody@localhost identified by 'onebody';"
cp config/database.yml{.mysql-example,}
gem install bundler
bundle install
cp config/secrets.yml{.example,} && vim config/secrets.yml
and add a random secret token to both the "development" and "test" sections (you can userake secret
to generate a new random secret).rake db:create db:schema:load db:seed
rails server
Now visit the site running in development mode at http://localhost:3000.
Tests
To run tests:
rspec
If you don't have a test database yet, create it like you did the dev database:
RAILS_ENV=test rake db:create db:schema:load
Get Help
from https://github.com/churchio/onebody