README

Template for new Rails projects.

Getting started

To get going clone this repository and perform the following steps:

1. Clone this repository
2. You can now run bin/configure, which will help you in configuring the template. Alternatively perform all of the following steps manually.
3. Change application name in config/application.rb.
4. Update database.yml to reflect the new application name.
5. Update TODO items in config/environments/production.rb.
6. If you plan on using Figaro, copy config/application.yml.example to config/application.yml.
7. ESLint is preconfigured for modern JS with React support (AirBnB styleguide). If you want to use it install packages with npm install, otherwise remove .eslintrc and package.json.
8. If you don't plan on tracking the template, you can remove the .git directory. Otherwise you can rename the remote:

   $ git remote rename origin rails_new

9. Add your new remote as appropriate.

Optional configurations

• If you want to use AirBrake, make sure the following 2 environment variables are set:
  • AIRBRAKE_PROJECT_ID
  • AIRBRAKE_API_KEY
• New Relic is pre configured in config/newrelic.yml, but you need to comment in the environment variables for it work on Heroku (lines 10 and 17).

Environment variables

Variable	Comment
GOOGLE_ANALYTICS_ID	Will be added to the main application layout if set
BLOCK_HTTP_TRACE	Disable HTTP TRACE method if set to true/t/1
DATABASE_URL	Used for production env, automatically set by Heroku
HTTP_METHOD_BLACKLIST	If you want to block more than just TRACE, e.g. "TRACE,OPTIONS"
PORT	Port Puma will listen on, defaults to 3000
RAILS_LOG_TO_STDOUT	Set by Heroku Ruby buildpack, set manually on other platforms if needed
RAILS_MAX_THREADS	Number of Puma threads, defaults to 5

Contents

All of the following have been installed and pre-configured.

Base system

• Rails 5.1.0
• Ruby 2.4.1
• pg for ActiveRecord
• The app is preconfigured for Google Analytics, just add GOOGLE_ANALYTICS_ID to the environment.

General

• active_model_serializers
• draper
• figaro
• pundit
• secureheaders
• sidekiq

Frontend

All of these are managed by yarn.

• bootstrap4
• jquery

Development

• foreman
• newrelic_rpm
• pry
• pry-byebug
• pry-doc
• RuboCop

Test

• bullet
• bundler-audit
• capybara
• database_cleaner
• devise
• factory_girl_rails
• memory_profiler
• poltergeist
• rack-mini-profiler
• shoulda-matchers
• spring-commands-rspec
• webmock

Production

• airbrake
• heroku-deflater
• lograge
• rails_12factor
• rake-timeout

Removed

The following default Rails gems have been removed:

• coffee-rails
• jbuilder