Generate your full API blueprint APIB by concatenation from smaller sub-sections using Grunt.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A grunt setup for dealing with apiary blueprints. Makes the workflow much easier, by concatonating multiple blueprints in the source folder to a single file - dist/apiary.apib and also publishing through the apiaryio gem.

Note: Publishing from command line overwrites any changes made online,


  1. Clone the repo, then install dependencies
cd grunt-apiary-blueprint/
npm install
  1. As part of the install process you will be asked your password to install the apiaryio gem. You can also run this manually using sudo gem install apiaryio if you wish.

  2. Copy config.example.js to config.js and set the name to match your API blueprint name and key the apiary api key obtained from

  3. Start grunt in bash grunt

  4. Save your blueprints inside /source as \*.apib files

  5. Repeat Step 5

Publishing specifics

You can configuring different environements to deploy to, for example if you had a shared and a personal blueprint.

Add a new grunt env, and specify the new apiary key (through config.js, or directly). Publish to this new environment from the cli using grunt publish --env=shared (where shared is the name of the environment in your grunt file)