generator-dss-email/readme.md

Yeoman generator that provides HTML boilerplate and cross client pitfall sniffing

# DSS Email generator

> [Yeoman](http:/yeoman.io) generator to help ease the development of HTML emails.
> Adds email pitfall hinting on top of [generator-email](https://www.npmjs.org/package/generator-email)


## Features
The Email generator eases the process of HTML email development by providing you with:

- a local development server with [LiveReload](http://livereload.com) functionality.
- a boilerplate HTML template to get you started.
- the ability to develop with external CSS or [Sass](http://sass-lang.com) (SASS/SCSS) stylesheets.
- automatic inlining of the external CSS styles in your template.
- automatic compression & optimization of all your image assets.
- optimized CSS & HTML by removing unused comments and selectors from your code.


## Getting Started
You'll need to make sure you've downloaded & installed the generator and all of its dependencies. You can do this by running the following commands:

1. `npm install -g yo` - Installs [Yeoman](http://yeoman.io).
2. `npm install -g generator-dss-email` - Install the [Email generator](https://github.com/alieneclectic/generator-dss-email).
3. `gem install premailer` - Installs [Premailer](https://github.com/premailer/premailer/).


## Usage
To generate the email development environment, type: `yo dss-email` and answer the questions asked by the generator.

---

The following tasks will now be made available to you via [Grunt](http://gruntjs.com) to help you develop and distribute your HTML emails.

- `grunt start` - starts a web server, opens the browser, and refreshes the page when changes occur.
- `grunt build:development` - manually compiles the development build.
- `grunt build:distribution`  - manually compiles the distribution build.

---

The generator will also scaffold out the following file & folder structure for you.

```
├── dist
│   ├── images
│   └── index.html
├── src
│   ├── css
│   │   └── core.{css,scss,sass}
│   ├── images
│   └── index.html
├── Gruntfile.js
└── package.json

```

- `src/` - source files that you should develop with.
- `dist/` - compiled build files suitable for distribution. Created by running `grunt build:distribution`



## Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.


## License
Copyright (c) 2014
Licensed under the MIT license.