create-html5-app/docs/plugins.md

Create a new simple project in HTML5 with one command.

# Plugin guide for create-html5-app

Plugins allow you to add features to create-html5-app, such as commands and
extensions to the `toolbox` object that provides the majority of the functionality
used by create-html5-app.

Creating a create-html5-app plugin is easy. Just create a repo with two folders:

```
commands/
extensions/
```

A command is a file that looks something like this:

```js
// commands/foo.js

module.exports = {
  run: (toolbox) => {
    const { print, filesystem } = toolbox

    const desktopDirectories = filesystem.subdirectories(`~/Desktop`)
    print.info(desktopDirectories)
  }
}
```

An extension lets you add additional features to the `toolbox`.

```js
// extensions/bar-extension.js

module.exports = (toolbox) => {
  const { print } = toolbox

  toolbox.bar = () => { print.info('Bar!') }
}
```

This is then accessible in your plugin's commands as `toolbox.bar`.

# Loading a plugin

To load a particular plugin (which has to start with `create-html5-app-*`),
install it to your project using `npm install --save-dev create-html5-app-PLUGINNAME`,
and create-html5-app will pick it up automatically.