Demonstrates how to use Assemble to build a site. Includes layouts, pages, partials, and markdown content.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

boilerplate-site Build Status

Boilerplate for generating a basic static site with Assemble.


You may find outdated information or examples in this project. While we're refactoring, you might be more interested in boilerplate-bootstrap in the meantime.

Getting Started

  • Download this project and unzip it into a new folder.
  • In the project folder, run npm install to install Assemble, Grunt and any other dependencies.
  • Once the dependencies are installed you may run grunt assemble to build the example project.

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile, as well as install and use Grunt plugins.

The "assemble" task


In the project's Gruntfile, the example assemble task is pre-loaded with paths and options following standard Grunt.js conventions:

  // The "assemble" task
  assemble: {
    // Task-level options.
    options: {
      flatten: true,
      assets: 'dist/assets',
      layout: 'templates/layouts/default.hbs',
      partials: 'templates/partials/*.hbs',
      data: 'src/data/*.{json,yml}'
    // Templates to build into pages
    pages: {
      files: {
        'dist/': ['templates/pages/*.hbs']

Boilerplate Author

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.