Created for tired people, by slightly less tired people.
Switch branches/tags
Clone or download
Pull request Compare This branch is even with vigetlabs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
app
assets/images
bin
config
db
lib
log
public
spec
test
tmp
vendor
.gitignore
.nvmrc
.rspec
.ruby-version
Capfile
Gemfile
Gemfile.lock
README.md
Rakefile
config.ru
package-lock.json
package.json

README.md

GroundRules

A responsive web application powered by a custom rails Content Management System (CMS) that will provide access to informative coffee-based content to interested coffee drinkers.

Table of Contents

  1. Get the Repo
  2. Dependencies
  3. Configuration
  4. Start and Setup the Database
  5. Start the Server
  6. Running Tests
  7. Deployment
  8. Domains
  9. Continuous Integration

Get the Repo

Make sure you have the project locally! Clone the repository onto your machine.

git clone git@github.com:vigetlabs/GroundRules.git

To run or do work on the project, make sure you're in the project directory.

cd GroundRules

Dependencies

First, got that Homebrew? If not, install it! We'll use Homebrew to install pretty much everything needed for this project.

Next up, what about rbenv(Ruby Version Manager)? If you don't have it installed, run this:

$ brew update
$ brew install rbenv

This project is built on Ruby 2.4.1:

$ rbenv install 2.4.1

Make sure you have Bundler installed for Ruby 2.4.1 as well!

$ gem install bundler

We'll be using Postgres (Version 9.6+) as our database:

$ brew install postgres

One of our Rails-installed dependencies, Dragonfly, uses ImageMagick for image processing, so we'll need that as well:

$ brew install imagemagick

That does it for system dependencies. Now you'll just need to install the app dependencies for both Ruby and JS:

$ bundle install
$ npm install

Configuration

To configure the project, first copy the example secrets file.

cp config/secrets.example.yml config/secrets.yml

Next, do the same with the database configuration file.

cp config/database.example.yml config/database.yml

Start and Setup the Database

Start PostgreSQL

$ pg_ctl -D /usr/local/var/postgres -l /usr/local/var/postgres/server.log start

I suggest opening your shell config and adding an alias (something like pgstart) so you don't have to type that whole command out.

Lastly, set up the database

rake db:create db:migrate db:seed

Start the Server

$ rails s

Now the application will be available at localhost:3000

Running Tests

$ bundle exec rspec

Deployment

This project is configured with CircleCI testing and deploy from the master branch. After finishing work on a new branch, submit your work via a Pull Request to master. Once master finishes building and passes all tests, the updated version will be automatically deployed.

Domains

Continuous Integration

Continuous integration and deployment is run through CircleCI. To receive notifications about build status, go to the project page and click on the 'follow the groundrules project'.