README.md

Recipes

• CoffeeScript
• Handlebars
• Less
• Stylus
• Pug
• GitHub Pages
• Asset revisioning
• React
• React Router
• Nunjucks
• AWS S3 deployment
• Heroku deployment - Node.js
• Rsync deployment
• Browserify
• HTMLHint
• Liquify

We welcome additional recipes for common use-cases not covered by this generator.

Tips for writing a recipe

1. Use the master branch of the generator

If you haven't already, clone the generator and link it:

$ git clone https://github.com/yeoman/generator-webapp
$ cd generator-webapp
$ npm link
$ cd ../

Now the yo webapp command will use that version of the generator. To make sure this is actually true:

$ npm ls -g generator-webapp
# you should get something like
/usr/local/lib
└── [email protected]  -> /Users/username/generator-webapp

To update the generator, all you need to do is:

$ cd generator-webapp
$ git pull origin master
$ cd ../

2. Create a test project

Writing a recipe without actually testing it is very hard and error-prone, you should create a test project. Let's say you're writing a recipe for Stylus:

$ mkdir recipe-stylus && cd $_
$ yo webapp
# select all options

3. Track changes

You should now create a Git repository and commit everything, this will allow you to see exactly which changes are required to implement Stylus:

$ git init
$ git add .
$ git commit -m "Initial commit"

4. Get your feature working

Do whatever is necessary to get Stylus working, install required gulp plugins, change gulpfile.js, update styles etc.

5. Write the recipe

After you've completed a minimal set of changes to implement Stylus, run git diff and use the output to write the recipe.