Skip to content


wuputah edited this page · 5 revisions
Clone this wiki locally

Heroku Gem layout

To create a herogems-compliant Heroku gem, your library should be require-able either by its full name, or its full name with hyphens transposed with forward slashes. We recommend following the convention heroku-extension_name (and hence have a ruby file located at lib/heroku/extension_name.rb). Otherwise, gems are the same as plugins: there is no magic we do on your behalf.

You should declare a dependency on the particular version of the Heroku gem your plugin is designed for. We generally recommend ~> 2.0 as only major releases have broken plugin compatibility to date.

In order to maintain compatibility with those who do not use herogems, we recommend your gem should also have an init.rb file which simply requires the same file herogems would.

Something went wrong with that request. Please try again.