Yeoman generator to scaffold out a front-end Bootstrap 4 Web app
Switch branches/tags
Nothing to show
Clone or download
Latest commit 1e0bc77 Jan 7, 2017
Permalink
Failed to load latest commit information.
app Update _package.json Nov 8, 2016
docs/recipes v0.0.1 Nov 14, 2015
test v0.0.1 Nov 14, 2015
contributing.md v0.0.1 Nov 14, 2015
package.json bump to v 0.0.2 Nov 15, 2015
readme.md add FontAwesome Octicons both optional, and some minor fixes Nov 15, 2015
yeoman.png add screen image Nov 14, 2015

readme.md

Bootstrap 4 web app generator Build Status

Yeoman generator that scaffolds out a front-end Bootstrap 4 web app.

Run the Bootstrap 4 generator

Features

  • Bootstrap 4
  • Flexbox support (Optional)
  • Font Awesome (Optional)
  • Octicons (Optional)
  • CSS Autoprefixing
  • Built-in preview server with LiveReload
  • Automagically compile ES6 (with Babel) & 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

For more information on what generator-bootstrap4 can do for you, take a look at the Grunt tasks used in our package.json.

Getting Started

  • Install: npm install -g generator-bootstrap4
  • Run: yo bootstrap4
  • Run grunt for building and grunt serve for preview*. --allow-remote option for remote access.

Third-Party Dependencies

(HTML/CSS/JS/Images/etc)

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 script or 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" or src="/bower_components". Treat the bower_components directory as if it was a sibling to index.html.

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

Note: grunt server was used for previewing in earlier versions of the project, and has since been deprecated in favor of grunt serve.

Docs

We have recipes for integrating other popular technologies like Compass.

Options

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

    Turn off Babel support.

Contribute

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.

License

BSD license