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
- Get the Repo
- Start and Setup the Database
- Start the Server
- Running Tests
- Continuous Integration
Get the Repo
Make sure you have the project locally! Clone the repository onto your machine.
git clone email@example.com:vigetlabs/GroundRules.git
To run or do work on the project, make sure you're in the project directory.
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
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
$ 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
$ bundle exec rspec
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.