Yeoman generator that scaffolds out a front-end web app.
- CSS Autoprefixing
- Built-in preview server with LiveReload
- Automagically compile CoffeeScript & Sass
- Automagically lint your scripts
- Automagically wire up your Bower components with grunt-wiredep.
- Awesome Image Optimization (via OptiPNG, pngquant, jpegtran and gifsicle)
- Mocha Unit Testing with PhantomJS
- Bootstrap for Sass (Optional)
- Leaner Modernizr builds (Optional)
For more information on what
generator-webapp can do for you, take a look at the Grunt tasks used in our
npm install -g generator-webapp
gruntfor building and
grunt servefor preview*.
--allow-remoteoption for remote access.
Third-party dependencies are managed with grunt-wiredep. Add new dependencies using Bower and then run the Grunt task to load them:
$ bower install --save jquery $ grunt wiredep
This works if the package author has followed the Bower spec. If the files are not automatically added to your source code, check with the package's repo for support and/or file an issue with them to have it updated.
To manually add dependencies,
bower install --save depName to get the files, then add a
style tag to your
index.html or another appropriate place.
The components are installed in the root of the project at
/bower_components. To reference them from index.html, use
src="..//bower_components". Treat the
bower_components directory as if it was a sibling to
Testing Note: a project checked into source control and later checked out needs to have
bower install run from the
test folder as well as from the project root.
Grunt Serve Note
grunt server was used for previewing in earlier versions of the project, and has since been deprecated in favor of
We have recipes for integrating other popular technologies like Compass.
Skips the automatic execution of
npm after scaffolding has finished.
mocha. Can be switched for another supported testing framework like
Add support for CoffeeScript.
See the contributing docs.
Note: We are regularly asked whether we can add or take away features. If a change is good enough to have a positive impact on all users, we are happy to consider it.
generator-webapp is fork-friendly and you can always maintain a custom version which you
npm install && npm link to continue using via
yo webapp or a name of your choosing.