Web app generator

Yeoman generator that scaffolds out a front-end web app using gulp for the build process

This is a strongly modified fork of the original yeoman/generator-webapp that includes some extra features that I frequently use in new projects. Feel free to use it in your production. Brought to you by Dahdah Design.

Features

Please see our gulpfile for up to date information on what we support.

Features exclusive to this modified version are shown in bold.

• Optional: Use Pug (formerly Jade) instead of plain HTML
• Optional: Modular template system for DRY-friendly HTML with example uses (native Pug)
• Optional: Automatically include useful extras like normalize.css, Fastclick, viewportUnitsBuggyfill and Modernizr
• Optional: Automagically remove any unused CSS from your production builds with UnCSS (awesome for removing framework bloat)
• Built-in support for the Pug Markdown filter
• enable ES2015 features using Babel
• CSS Autoprefixing
• Built-in preview server with BrowserSync
• Automagically compile Sass with libsass
• Automagically lint your scripts
• Map compiled CSS to source stylesheets with source maps
• Awesome image optimization
• Automagically wire-up dependencies installed with Bower

For more information on what this generator can do for you, take a look at the gulp plugins used in our package.json.

libsass

Keep in mind that libsass is feature-wise not fully compatible with Ruby Sass. Check out this curated list of incompatibilities to find out which features are missing.

If your favorite feature is missing and you really need Ruby Sass, you can always switch to gulp-ruby-sass and update the styles task in gulpfile accordingly.

Getting Started

• Install: npm install --global yo gulp-cli bower
• Install the generator: npm install --global https://github.com/jdahdah/generator-gulp-dahdah
• Run yo gulp-dahdah to scaffold your webapp with npm, or Run yo gulp-dahdah --skip-install and follow the on-screen instructions to scaffold with Yarn
• Run gulp serve to preview and watch for changes
• Run bower install --save <package> to install frontend dependencies
• Run gulp serve:test to run the tests in the browser
• Run gulp to build your webapp for production
• Run gulp serve:dist to preview the production build

Docs

• getting started with this generator
• recipes for integrating other popular technologies like CoffeeScript
• details about our Bower setup
• contribution docs and FAQ, good to check before posting an issue

Options

• --skip-welcome-message Skips Yeoman's greeting before displaying options.
• --skip-install-message Skips the the message displayed after scaffolding has finished and before the dependencies are being installed.
• --skip-install Skips the automatic execution of bower and npm after scaffolding has finished.
• --test-framework=<framework> Either mocha or jasmine. Defaults to mocha.
• --no-babel Scaffolds without Babel support. This only applies to app/scripts, you can still write ES2015 in the gulpfile, depending on what your version of Node supports.

Contribute

See the contributing docs.

Sponsors

Love Yeoman work and community? Help us keep it alive by donating funds to cover project expenses!
[Become a sponsor]

License

BSD license