Skip to content
By Rachelle LeQuesne

Gems and Bundler

Note: This post is intended as a supplement to WTF Just Happened? A Quick Tour of Your First Rails App.

Gems and Bundler

Ruby Gems

A Ruby gem is a self-contained piece of code that performs a single piece of functionality. You can find gems for pretty much anything you could ever want; from extracting data into CSV format to integrating with Google analytics and everything in between! In fact, Rails itself is a gem. It is a gem for building web applications. See Rails: A Gem of Gems for more detail. is a code library where most gems live. To add a gem to your Rails application, you add it to your Gemfile. The syntax will look something like:

gem 'jquery-rails'

The Gemfile assumes that any gem specified can be found at To include a gem from elsewhere, such as github, you can do so as follows:

gem 'nokogiri', :git => ''

You can also specify a particular gem version, or range of versions. There are different syntax but the one you will most commonly come across is ~>, as in:

gem 'coffee-rails', '~> 4.2'

This is saying that we want the gem coffee-rails that is the latest gem version of the form 4.2.x.

A Rails application contains a number of gems, some of which come with Rails, and others that you add to your application to provide additional functionality.

Each gem has dependencies and its version may only be compatible with certain specific versions of other gems. As we add more and more gems, keeping track of these dependencies can get very confusing. Bundler to the rescue!


Bundler is a tool (a gem, in fact) that looks at all the gems in your Gemfile and figures out which version of each gem should be included to ensure they are compatible and will play nicely with each other. As Bundler is a gem, you can install it on your machine by running the following command:

gem install bundler

By default, gems are downloaded from However, as noted above, we can specify other locations such as GitHub or our local filesystem.

To invoke Bundler and install your gems you type the following command into your command line:

bundle install

To update all your gems to their latest version, you run

bundle update

Running bundle install (or bundle update) creates a file called Gemfile.lock. This file contains your entire dependency tree. When you check this into GitHub, and make it part of your application source code, you ensure that everyone running your application uses the exact same versions. This is very important for your application to behave the same on different machines.

Popular Articles by Our Team

Our expert team of designers and developers love what the do and enjoy sharing their knowledge with the world.

We Hire Only the Best

reinteractive is Australia’s largest dedicated Ruby on Rails development company. We don’t cut corners and we know what we are doing.

We are an organisation made up of amazing individuals and we take pride in our team. We are 100% remote work enabling us to choose the best talent no matter which part of the country they live in. reinteractive is dedicated to making it a great place for any developer to work.

Free Community Workshops

We created the Ruby on Rails InstallFest and Ruby on Rails Development Hub to help introduce new people to software development and to help existing developers hone their skills. These workshops provide invaluable mentorship to train developers, addressing key skills shortages in the industry. Software development is a great career choice for all ages and these events help you get started and skilled up.

  • Webinars


    Webinars are our online portal for tips, tricks and lessons learned in everything we do. Make the most of this free resource to help you become a better developer.

    Learn more about webinars

  • Installfest


    The Ruby on Rails Installfest includes a full setup of your development environment and step-by-step instructions on how to build your first app hosted on Heroku. Over 1,800 attendees to date and counting.

    Learn more about Installfest

  • Development Hub

    Development Hub

    The Ruby on Rails Development Hub is a monthly event where you will get the chance to spend time with our team and others in the community to improve and hone your Ruby on Rails skills.

    Learn more about Development Hub

Get the “reinteractive Review” Monthly Email