Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Heroku deploy tasks with test coverage (DEPRECATED, NO LONGER BEING DEVELOPED)

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

Kumade 熊手 Build Status

Kumade is a set of basic Rake tasks for deploying to Heroku. It aims to provide most of what you want. Unlike other Heroku deploy gems, it is well-tested.


Development is happening very fast, and the internals are in constant flux. The public API is constant (e.g. kumade production will work), but you may have to rebase against master a couple times before your pull request can be merged.

What does Kumade do?

Before deploying, Kumade ensures the git repo is clean and that all tests pass. After that, it packages assets using Jammit and/or More, commits them, and pushes to origin. Then it force pushes to the correct remote and runs rake db:migrate on the Heroku app.

If any step fails, it immediately prints an error and stops the deploy process.


In your Gemfile:

gem 'kumade'


kumade will deploy to any Heroku remote in the repo. For example, if you have a remote named "bamboo":

$ bundle exec kumade bamboo


# in your Rakefile:
require 'kumade'

# kumade auto-generates a deploy:ENV task for every Heroku environment
$ rake deploy:bamboo

which will autodetect the name of the Heroku app that the bamboo remote points to and deploy to it.

To run in pretend mode, which prints what would be done without actually doing any of it:

$ bundle exec kumade bamboo -p

The default is to deploy to staging:

$ bundle exec kumade # equivalent to "bundle exec kumade staging"

Does it support the Cedar stack?

Yes. To indicate that a particular app is using Cedar, run with the -c flag:

bundle exec kumade bamboo -c


Tested against:

  • MRI 1.8.7
  • MRI 1.9.2
  • REE 1.8.7

Misc Features

Want to run a task before bundling your assets on deploy? In your Rails app's rake tasks, drop in:

namespace :kumade do
  task :before_asset_compilation do
    puts "This runs before assets are committed and pushed to the remote"

You can hook in any custom code you want to run there before deploying!

What's with the name?

Kumade (pronunciation here) means "bamboo rake" in Japanese.


kumade is Copyright © thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.

Something went wrong with that request. Please try again.