---
author: 'Jon Schlinkert, Brian Woodward'
---
# {%= name %} {%= badge("fury") %} {%= badge("travis") %}

> {%= description %}

### [Visit the website →](http://assemble.io)

## Why use Assemble?

1. Most popular site generator for Grunt.js and Yeoman. Assemble is used to build hundreds of web projects, ranging in size from a single page to 14,000 pages (that we're aware of!). [Let us know if you use Assemble](https://github.com/assemble/assemble/issues/300).
1. Allows you to carve your HTML up into reusable fragments: partials, includes, sections, snippets... Whatever you prefer to call them, Assemble does that.
1. Optionally use `layouts` to wrap your pages with commonly used elements and content.
1. "Pages" can either be defined as HTML/templates, JSON or YAML, or directly inside the Gruntfile.
1. It's awesome. Lol just kidding. But seriously, Assemble... is... awesome! and it's fun to use.

...and of course, we use Assemble to build the project's own documentation [http://assemble.io](http://assemble.io):

**For more:** hear Jon Schlinkert and Brian Woodward discuss Assemble on **Episode 98 of the [Javascript Jabber Podcast](http://javascriptjabber.com/098-jsj-assemble-io-with-brian-woodward-and-jon-schlinkert/)**.


![image](https://f.cloud.github.com/assets/383994/1463257/f031bcfe-4525-11e3-9a03-89a17eee7518.png)

## The "assemble" task

### Getting Started
{%= docs("getting-started") %}

### Options
{%= docs("options") %}

### Usage Examples
{%= docs("examples") %}

## Contributing
{%= include("contributing") %}

## Assemble plugins
{%= include("assemble/repos-list") %}

## Authors
{%= include("authors", {
  authors: [
    {
      name: 'Jon Schlinkert',
      username: 'jonschlinkert'
    },
    {
      name: 'Brian Woodward',
      username: 'doowb'
    }
  ]
}) %}

## Release History
{%= changelog() %}

## License
{%= copyright() %}
{%= license() %}

***

{%= include("footer") %}