README

Aerobic.io is a Fitness Tracking service by @quamen and @plasticine.

Dependencies

• Git
• Ruby 2.0
• Rubygems
• Bundler
• Postgresql
• Phantomjs
• npm
• Qt

Getting Started

The following steps will get your development environment up and running:

$ script/bootstrap
$ rake db:migrate

As part of the bootstrap process we install a few binstubs:

bin/autospec
bin/rspec
bin/cucumber
bin/teaspoon

You can also pull down a mirror of the production database to develop against by running:

$ script/heroku-clone

Coding Style

We follow the GitHub Ruby Styleguide.

Testing

We use three types of tests in the project:

1. Unit Tests
2. Acceptance Tests
3. Javascript Tests
4. Static Analysis Tools

To find out more about how we use each of these types of tests, please read the testing strategy document.

You can run the full test suite like so:

$ script/cibuild

You can also run each individual test suite manually:

Unit Tests

$ bin/rspec

Acceptance Tests

$ bin/cucumber

Javascript Tests

$ bin/teaspoon

Static Analysis Tools

$ rake quality

View Architecture

We handle views slightly differently to the traditional Rails approach.

Layouts != Views

We use Nestive to try and make our views leaner by attempting to push complexity up into the inherited layout system wherever possible.

This means that views should ideally be smaller and more concise, and should also mean that layouts are more reusable, and we have less repetition across the entirety of the View layer.

The default layout in the application is authenticated.html.erb - which is the most common layout for views in the app.

Views as Templates (Mustache Style ERB)

In an effort to make our view code unit testable and sane, we have adopted the strategy of treating each .html.erb file as a template. Each template has its own view object, that contains the logic for the view.

Our inspiration - Mustache style ERB.

i18n Strings

Strings in views should always be i18n-ed. If the string is related only to a single view and is not reused anywhere else then the string should use a view-relative i18n path.

Feature Flipping

We use Rollout to flip features in our user interface. Read the Rollout docs for more information on how it works.

A list of active feature flips can be found in SwitchBoard::FEATURE_FLIPS.

Domain Objects

app/domain is reserved for objects that represent the applications domain. These objects should be used in Controllers. They are designed to be instantiated with data objects (ActiveRecord object, OpenStruct object), regardless of where it is persisted.

Domain objects are allowed to reference Model objects in order to persist themselves or load data into themselves.

Model Objects

app/models is reserved for objects that inherit from ActiveRecord. These objects are purely about persistence and should contain no logic.

These objects should not be referenced directly in Controllers.

CI

Wercker is used to run a build on every branch pushed to Github. If a build fails, it will show up in our Campfire room.

Passing builds are expected and will not be announced in Campfire.

Deployment

Deployment is handled automatically by Wercker. Any build of master that passes will be automatically deployed to the staging environment at beta-aerobic.herokuapp.com.

Environment Variables

If a new branch requires new environment variables to be set on Heroku, then the pull request must indicate that this has already occured before it can be merged. Otherwise beta-aerobic.herokuapp.com will crash due to missing configuration.

Migrations

Wercker does not run migrations for you. If you are merging a branch that requires migrations to be run, you must run them once the build has been deployed.

If you can think of a way to make this seamless, open a pull request.