Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
80 lines (59 sloc) 2.02 KB


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
$ 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
└── generator-webapp@0.1.0  -> /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.

You can’t perform that action at this time.