Build Bootstrap with Assemble instead of Jekyll.


Build Bootstrap with Assemble instead of Jekyll.

See it live →

  • Converts the liquid templates to Handlebars
  • Builds the HTML from templates using Assemble.
  • Swaps out some Bootstrap content with metadata from _config.yml.


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

1. Download this project

Do one of the following:

  • download this project
  • git clone git://
  • bower install boilerplate-bootstrap

2. Next, install Bootstrap and dependencies

Next, cd into the project run the following in the command line:

npm i && git clone git:// "vendor/bootstrap" && cd vendor/bootstrap && npm i

3. Customize _config.yml

Optionally update the metadata and config defaults to how you want them for your project.

4. Last, build.

You may now run grunt to build the project.

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: {
    flatten: true,
    assets: '<%= site.assets %>',

    // Metadata
    site: '<%= site %>',

    // Templates
    partials: '<%= site.includes %>',
    layoutdir: '<%= site.layouts %>',
    layout: '<%= site.layout %>',
  docs: {
    src: ['templates/*.hbs'],
    dest: '<%= site.dest %>/'

Take a look at _config.yml to see some of the metadata and config data is defined.


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.

Release History

  • 2013-12-22 v0.2.6 Updated dependencies, Bootstrap paths. A number of updates to gruntfile and config. Adds _config.yml to project root, to make project metadata more customizable from the start.
  • 2013-08-03 v0.2.0 Refactored to be awesome.
  • 2013-07-16 v0.1.0 First commit.