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.

• 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.

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

grunt.initConfig({
  // 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']
      }
    }
  }
})

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

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.