Updating

Instrumental Components actually consists of 2 gems:

  • instrumental-components
    This is the "installer" gem, which you use to download, install, and update your version of Instrumental Components.

  • instrumental-components-library
    This is the "components gem", which is the private gem that gets installed into your project and provides you with all of the generator commands for generating and installing components into your project.

First, make sure you have the "installer" gem in your project's gemfile:

Copy 
gem 'instrumental-components'

Then bundle install:

Copy 
bundle install

Check for updates

To see whether or not you already have the latest available version of Instrumental Components, run:

Copy 
instrumental-version

That should either tell you that you have the latest, or there's a new version available.

Update to the latest version of Instrumental Components

To make sure you have the latest version of the "components gem" (with all of latest components, fixes and improvements), follow these instructions to update it.

Note: This won't install or overwrite any component files in your Rails project. It will simply update your version of the 'instrumental-components-library' gem, so that you have the latest generators with all of the latest components, improvements, fixes, etc. You can then run these generator commands to install stuff into your project when you're ready.
Copy 
bundle exec install-instrumental

This will check your Rails project to find your license key and email in: .instrumental/license.yml.

If that file doesn't exist, then it will prompt you to enter your license key and/or email address.

Find your license key in your account by logging in

See your version when running generators

Whenever you run any generator compand from Instrumental Components, one of the first lines you'll see in the terminal output tells you which version you're currently running. You will see something like this (with your current version number):

Copy 
You're currently using version 0.1.24 of Instrumental Components.
Instrumental Components

I created Instrumental Components to make designing and building professional apps with Ruby on Rails easy, fast, and fun. I use it on all of my projects and I hope it helps you build something great.

Brian Casel
Brian Casel
Creator of Instrumental Components
Learn more Send me a question or request