node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Build Bootstrap with Assemble instead of Jekyll.

See it live →

  • Converts the liquid templates to Handlebars
  • Builds the HTML from templates using Assemble.


You must have NPM, Bower and Grunt installed globally before you begin.


  • Either download this project,
  • Or git clone
  • Or run bower install assemble-bootstrap


cd into the project, and from the command line run:

npm i && bower install && cd vendor/bootstrap && npm i

You may now run grunt to build the project.

Note that if you want to get the absolute latest, bleeding edge Bootstrap you will need to use git clone 'vendor/bootstrap' instead of bower install.

The "assemble" task

If you haven't used Assemble before, please visit to learn how to customize the task.


In the project's Gruntfile, the example assemble task is pre-loaded with paths and options to build the project successfully:

assemble: {
  options: {
    site: '<%= site %>',
    flatten: true,
    assets: 'tmp/assets',
    partials: 'tmp/_includes/*.hbs',
    layoutdir: 'tmp/_layouts',
    layout: 'default.hbs'
  docs: {
    src: ['tmp/*.hbs'],
    dest: 'tmp/'


Jon Schlinkert


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Use Assemble to build and maintain your gh-pages, blog or documentation. Lint and test your code using Grunt.

Release History

  • 2013-08-03 v0.2.0 Refactored to be awesome.
  • 2013-07-16 v0.1.0 First commit.