I've stopped maintaining this project after reaching Rails 4.1.6. For new versions of Rails, and for my latest Rails configuration suggestions, please use mattbrictson/rails-template.
I discovered that using this repo in my own projects was becoming tedious and error-prone, due to the manual find-and-replace steps needed to start a new project. To fix that, I've created a new project called mattbrictson/rails-template. It sets out to accomplish similar goals, but does so in a much more automated way, using Rails application templates and Thor actions.
As a result, I am no longer maintaining rails-starter.
For my latest Rails application boilerplate, please visit my new project:
https://github.com/mattbrictson/rails-template
--Matt
A simple template for starting new Rails 4 projects.
There are two branches of this project that are regularly maintained: master
and bootstrap
.
- The
master
branch contains the newest rails-starter template. Most projects are best served by starting from this branch. - The
bootstrap
branch contains all the latest code from master, plus extra gems, views, and helpers specific to Twitter Bootstrap. If you are starting a project where you plan to use Twitter Bootstrap, the bootstrap branch is what you need.
Rails-stater is a project template for Rails 4 projects that is pre-configured for Capistrano-based deployment. This template targets the following server stack:
By using this template, you’ll hit the ground running with best practices for productive Rails and front-end development:
- RSpec and Capybara for testing
- guard-livereload for fast, iterative front-end development
- Up-to-date rbenv and bundler gem management techniques
- SMACSS for organizing stylesheets
- Capistrano recipes to make deployment easy
.env
for storing encryption keys and secret tokens safely outside of source control- An easy way to add Twitter Bootstrap, should you choose to do so (use the
bootstrap
branch)
More on my blog:
This project requires:
- Ruby 2.1.3, preferably managed using rbenv
- Qt (in order to build the capybara-webkit gem)
For a complete Ruby development environment, please follow our my post: Rails OS X Setup Guide.
- Download and extract either the master (plain starter) or the bootstrap (Twitter Bootstrap-themed starter) ZIP archive of the rails-starter repository; this will be the start of your new Rails project.
- Globally replace
rails-starter
andRailsStarter
with the desired name of your project. cd
into the project and rungit init && git add . && git commit -m "init"
to initialize a git repository.
Run the bin/setup
script. This script will:
- Check you have the required Ruby version
- Install gems using Bundler
- Create local copies of
.env
anddatabase.yml
- Create, migrate, and seed the database
- Run
rake spec
to make sure everything works. - Run
rails s
to start the app.
pre-commit is a nice utility that runs helpful checks on code you are committing via git. The rails-starter contains a config/pre_commit.yml
file with a recommended configuration. To activate pre-commit on your project:
gem install pre-commit
rbenv rehash
pre-commit install
This installs a hook that will automatically run whenever you commit. You’re done!
This project uses the capistrano-fiftyfive
gem, which provides all recipes needed to set up and deploy on Ubuntu 12.04. It's super simple.
Using a provider like DigitalOcean, purchase an Ubuntu 12.04 LTS virtual private server. Make sure to install your SSH key for the root user.
Make note of the IP address of the VPS. Then:
To use capistrano you will need to update the deployment settings to match your VPS.
- Review the contents of
config/deploy.rb
. Be sure the change the:repository
to match your git repository URL. - Update the IP address in
config/deploy/staging.rb
to match the IP of the VPS you just purchased. - By default,
cap production deploy
will deploy from themaster
branch, andcap staging deploy
will deploy from thedevelopment
branch. Update the branch settings if you use a different branch policy.
Don't forget to git push
your code so that capistrano can deploy it. Make sure you've pushed the branch that capistrano is expecting in staging.rb
. Then run these commands and follow the prompts to install Nginx, SSL, PostgreSQL, Ruby (the whole stack!):
cap staging provision
cap staging deploy:migrate_and_restart
Refer to the capistrano-fiftyfive README more details and deployment instructions.