sub-topic Sass Starterkit

Below are instructions on how to create a Bootstrap sub-theme using a Sass preprocessor.

Prerequisites

Additional Setup

Download and extract the latest 3.x.x version of Bootstrap Framework Source Files into the root of your new sub-theme. After it has been extracted, the directory should be renamed (if needed) so it reads ./THEMENAME/bootstrap.

If for whatever reason you have an additional bootstrap directory wrapping the first bootstrap directory (e.g. ./THEMENAME/bootstrap/bootstrap), remove the wrapping bootstrap directory. You will only ever need to touch these files if or when you upgrade your version of the Bootstrap Framework.

WARNING: Do not modify the files inside of ./THEMENAME/bootstrap directly. Doing so may cause issues when upgrading the Bootstrap Framework in the future.

Overrides

The ./THEMENAME/scss/_default-variables.scss file is generally where you will spend the majority of your time providing any default variables that should be used by the Bootstrap Framework instead of its own.

The ./THEMENAME/scss/overrides.scss file contains various Drupal overrides to properly integrate with the Bootstrap Framework. It may contain a few enhancements, feel free to edit this file as you see fit.

The ./THEMENAME/scss/style.scss file is the glue that combines: _default-variables.scss, Bootstrap Framework Source Files and the overrides.scss file together. Generally, you will not need to modify this file unless you need to add or remove files to be imported. This is the file that you should compile to ./THEMENAME/css/style.css (note the same file name, using a different extension of course).

See also:

Parent topics

Source starterkits/sass/README.md (line 4)