Hoverboard

Like Marty's hoverboard from Back to the Future 2, this adds a slide out panel to your rails app that directs clients to test stories that have been marked as 'delivered' in Pivotal Tracker.

Add hoverboard to your Gemfile:

gem 'hoverboard'

Create an initializer to add the Hoverboard::RackApp to your middleware stack and configure your pivotal tracker api token and project id:

require 'hoverboard'

Hoverboard.configure do |config|
  config.pivotal_tracker_token   = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  config.pivotal_tracker_project = 123456
  config.pivotal_tracker_use_ssl = false
end

You can find or create a Pivotal Tracker api token by going to your profile page on Pivotal Tracker. Your project ID can be found by looking at the url of your project. It will look like:

www.pivotaltracker.com/projects/:project_id

Use the following helper somewhere in your application layout (we recommend at the end of the body):

= hoverboard

The helper will insert a smidgeon of javascript that will add a tiny tab on the LHS of each page.

Please note that hoverboard requires jQuery to be included in your layout or templates already.

Reload a page from your app and give it a whirl.

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important so I don't break it in a future version unintentionally.
• Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
• Send me a pull request. Bonus points for topic branches.

If you'd like to contribute to hoverboard you can get started by running

rake dev

This sets up the correct configuration and environment (follow the instructions), then starts a sinatra app under shotgun. You can use this sinatra app to verify your work on hoverboard.

All assets are regenerated from their constituents on each request. The constituents are located in the dev directory.

• Ben Askins
• Lachie Cox
• Ben Webster
• Daniel Neighman

Copyright © 2010 Plus2. See LICENSE for details.