<p align="center"><img src="http://veams.org/img/svg/icons/veams-generator.svg"></p>

<p align="center">
	<strong>One of the most flexible and efficient <a href="http://yeoman.io">Yeoman</a> generator to build Frontend Web Apps, HTML5 web interfaces and Prototypes.</strong>
	<br><br>
	<a href="http://veams.org">Visit the Veams website.</a><br><br>
	<a href="http://badge.fury.io/js/generator-veams"><img src="https://badge.fury.io/js/generator-veams.svg" alt="NPM version" /></a>
	<a href="https://travis-ci.org/Sebastian-Fitzner/generator-veams"><img src="https://travis-ci.org/Sebastian-Fitzner/generator-veams.svg" alt="Build Status" /></a>
	<a href="https://nodei.co/npm/generator-veams/"><img src="https://nodei.co/npm/generator-veams.png?mini=true" alt="NPM install" /></a>
	<a href="https://gitter.im/Sebastian-Fitzner/Veams?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge"><img src="https://badges.gitter.im/Sebastian-Fitzner/Veams.svg" alt="Gitter Chat" /></a>
</p>

## Documentation

<p align="center">Head to the <a href="http://veams.org/">site</a> for a detailed overview and further instructions.</p>

**Here just a short overview:**

1. You can use Grunt or Gulp as task runner
2. You can choose of many plugins for your task runner
3. You can use a static site generator like Assemble or Mangony
4. You can add Bootstrap, Foundation, Bourbon and Lost to your project
5. You can use RequireJS or Browserify (with Babelify) 
6. You can add BackboneJS, ExoskeletonJS, Veams and jQuery
7. You can enable hinting and linting
8. You can add WebdriverIO as test suite
9. You can add the complete Veams stack to your project
10. You can build a technical HTML documentation

## Installation

I recommend to install [`veams-cli`](https://github.com/Veams/veams-cli).

If you only want to install the generator, just install it via: `npm install -g generator-veams`.

## Usage 

I recommend to use `veams-cli` to scaffold projects, blueprints or something else.

If you want to start generator-veams without `veams-cli` you can do the following:

```bash
yo veams
```

## Release History
see: [Changelog.md](CHANGELOG.md)