Repository files navigation

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

🚧 There is a pre-release version of this generator, you can install it by runningnpm install --global generator-webapp@next. Help us make it stable by reporting bugs! 🚧

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

• enableES2015 features usingBabel
• CSS Autoprefixing
• Built-in preview server with BrowserSync
• Automagically compile Sass withlibsass
• Automagically lint your scripts
• Map compiled CSS to source stylesheets with source maps
• Awesome image optimization

For more information on what this generator can do for you, take a look at thegulp plugins used in ourpackage.json.

Keep in mind that libsass is feature-wise not fully compatible with Ruby Sass. Check outthis 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 togulp-ruby-sass and update thestyles task in gulpfile accordingly.

• Install:npm install --global yo gulp-cli generator-webapp
• Runyo webapp to scaffold your webapp
• Runnpm start to preview and watch for changes
• Runnpm start -- --port=8080 to preview and watch for changes in port8080
• Runnpm install --save <package> to install dependencies, frontend included
• Runnpm run serve:test to run the tests in the browser
• Runnpm run serve:test -- --port=8085 to run the tests in the browser in port8085
• Runnpm run build to build your webapp for production
• Runnpm run serve:dist to preview the production build
• Runnpm run serve:dist -- --port=5000 to preview the production build in port5000

• getting started with this generator
• recipes for integrating other popular technologies like CoffeeScript
• contribution docs andFAQ, good to check before posting an issue

• --skip-welcome-messageSkips Yeoman's greeting before displaying options.
• --skip-install-messageSkips the the message displayed after scaffolding has finished and before the dependencies are being installed.
• --skip-installDoesn't automatically install dependencies after scaffolding has finished.
• --test-framework=<framework>Eithermocha orjasmine. Defaults tomocha.

See thecontributing docs.

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

BSD license