Bootstrap configuration and loading package for webpack, using the npm packages bootstrap-sass
and sass-loader
.
Install from boostrap-sass-loader on npm.
If you're looking for the less version, see bootstrap-webpack. This project is based on that version for less, with some minor differences, the main one being how the configuration file specifies two sass files for customization.
In a nutshell:
- You've got the sass-loader to process Sass files to CSS.
- The npm bootstrap-sass package places the bootstrap files in
/node_modules/bootstrap-sass/assets
. - You could simply create your own sass file to pick up bootstrap from this location, and you could require the js files here for the Bootstrap JavaScript code. See the sass-loader for instructions on configuring the directories.
- Or you could use this loader and load a js file that configures Bootstrap.
You can find an example of using this:
justin808/bootstrap-sass-loader-example
Note, bootstrap-sass
must be installed locally inside of ../node_modules
or a parent directories node_modules
directory relative to the loaded config file.
The version of sass-bootrap used is listed in peerDependencies, so you should be able to use whichever version you like.
Simply specify that version of bootstrap-sass
in your package.json
, like this:
"bootstrap-sass": "~3.3.1"
To use the complete bootstrap package including styles and scripts with the default settings:
require("bootstrap-sass-loader");
The disadvantage to using this setup is that you can't:
- Customize the bootstrap variables: Bootstrap Customization
- You can't use the bootstrap variables for your own sass stylesheets.
- Copy the file
bootstrap-sass.config.js
to your project. You will specify the file path in therequire
statement. - Open that file to customize the location of a file for any Boostrap variable overrides (
preBootstrapCustomizations
andbootstrapCustomizations
, and your main Sass file that can depend on Bootstrap variables, plus your customizations. Any of these 3 files are optional. You may also remove any Sass or Js modules that you don't need.
Next, you should specify this as an entry point:
module.exports = {
entry: [
"bootstrap-sass!./path/to/bootstrap-sass.config.js"
]
Or a dependency within a file, like you'd specify other webpack dependencies:
require("bootstrap-sass!./path/to/bootstrap-sass.config.js");
Here's a sample configuration file. The file included in the bootstrap-sass-loader git repo
has many more options. The two customization files, bootstrapCustomizations
and mainSass
are optional.
module.exports = {
bootstrapCustomizations: "./bootstrap-customizations.scss",
mainSass: "./main.scss", // path to your main SASS file (optional)
verbose: true, // print out your custom files used
debug: false, // print out the full generated scss file
styleLoader: "style-loader!css-loader!sass-loader", // see example for the ExtractTextPlugin
scripts: {
// add every bootstrap script you need
'transition': true
},
styles: {
// add every bootstrap style you need
"mixins": true,
"normalize": true,
"print": true,
"scaffolding": true,
"type": true,
}
};
Bootstrap use some fonts. You need to configure the correct loaders in your webpack.config.js
.
Take a look at example https://github.com/justin808/react-webpack-rails-tutorial which uses custom fonts with the bootstrap-sass-loader. You'll need to create define a font-face like this:
@font-face {
font-family: 'OpenSans-Light';
src: url('assets/fonts/OpenSans-Light.ttf') format('truetype');
}
module.exports = {
module: {
loaders: [
// **IMPORTANT** This is needed so that each bootstrap js file required by
// bootstrap-webpack has access to the jQuery object
{ test: /bootstrap\/js\//, loader: 'imports?jQuery=jquery' },
// Needed for the css-loader when [bootstrap-webpack](https://github.com/bline/bootstrap-webpack)
// loads bootstrap's css.
{ test: /\.woff(\?v=\d+\.\d+\.\d+)?$/, loader: "url?limit=10000&mimetype=application/font-woff" },
{ test: /\.woff2(\?v=\d+\.\d+\.\d+)?$/, loader: "url?limit=10000&mimetype=application/font-woff" },
{ test: /\.ttf(\?v=\d+\.\d+\.\d+)?$/, loader: "url?limit=10000&mimetype=application/octet-stream" },
{ test: /\.eot(\?v=\d+\.\d+\.\d+)?$/, loader: "file" },
{ test: /\.svg(\?v=\d+\.\d+\.\d+)?$/, loader: "url?limit=10000&mimetype=image/svg+xml" }
]
}
};
- If you don't run webpack like this, you might get a very obscure error:
PATH=$(npm bin):$PATH webpack --config webpack.rails.config.js
Alternate, you can put $(npm bin) in your path. Basically if you run type webpack
and the path is your global one, then
you may have issues.
- You can configure the output file of the created CSS file by using a relative path to the output directory. For example:
plugins: [
new ExtractTextPlugin("../stylesheets/bootstrap-and-customizations.css")
]
- boostrap-webpack.
- DylanLukes/bootstrap-sass-webpack
- Automatic Dependency loading is currently problematic. If you "touch" either of the customization files listed in your config file (bootstrapCustomizations, mainSass), then that will trigger a rebuild of the Sass files. This is a known issue with the sass-loader. I work around this issue by "touching" one of the 3 sass config files.
- See this article Debugging NodeJs and Webpack Loaders
- Clone both this project and https://github.com/justin808/bootstrap-sass-loader-example
- Use the npm link command per step #1 (see article)
- Be sure to run
npm i bootstrap-sass
in the directory where you have thebootstrap-sass-loader
. This is because the location of bootstap-sass is found relative to thebootstrap-sass-loader
and if you linked it and it's not not there, then you'll bet this error: "Error: Could not find path to bootstrap-sass. Check to see that it's in a parent directory of config file containing node_modules/bootstrap-sass".
Then in the bootstrap-sass-loader-example project:
- Make some changes in the loader, put in some print statements maybe, then run
gulp webpack
to invoke the loader. - Then run
gulp build
and open the resulting file dist/index.html in the browser. - Run
gulp test
to confirm the changes work.
Pull requests are welcome!
For more info see: http://www.railsonmaui.com and http://forum.railsonmaui.com.
- If using Webstorm import the inspection file in /jetbrains-inspection and inspect all files
- Command line:
eslint .
- Install the release-it npm program
- Merge fixes to master
- Run command
release-it
- Take defaults, except for last one to publish changes (answer Y)