generator-gulp-webapp

Scaffold out a front-end web app

Web app generator

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

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

  • 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.

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.js accordingly.

  • Install dependencies: npm install --global yo bower
  • Install the generator: npm install --global generator-gulp-webapp
  • Run yo gulp-webapp to scaffold your webapp
  • Run gulp serve to preview and watch for changes
  • Run bower install --save <package> to install frontend dependencies
  • Run gulp to build your webapp for production
  • --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> Defaults to mocha. Can be switched for another supported testing framework like jasmine.

See the contributing docs.

BSD license