Skip to content

Commit

Permalink
Update build-tools.md
Browse files Browse the repository at this point in the history
  • Loading branch information
mdo authored and voltaek committed Jan 17, 2021
1 parent c26aa4d commit 9aaf2c4
Showing 1 changed file with 4 additions and 2 deletions.
6 changes: 4 additions & 2 deletions site/content/docs/4.5/getting-started/build-tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,9 +36,11 @@ Run `npm run` to see all the npm scripts.

## Sass

Bootstrap v4 uses [Node Sass](https://github.com/sass/node-sass) for compiling our Sass source files into CSS files (included in our build process). In order to end up with the same generated CSS when compiling Sass using your own asset pipeline, you'll need to use a Sass compiler that supports at least the features that Node Sass does. This is important to note, because as of October 26, 2020, LibSass and packages built on top of itincluding Node Sassare [deprecated](https://sass-lang.com/blog/libsass-is-deprecated). If you require newer Sass features or compatibility with newer CSS standards, [Dart Sass](https://sass-lang.com/dart-sass) is now the primary implementation of Sass and supports a JavaScript API that's fully compatible with Node Sass (with a few exceptions listed on both the project's [GitHub](https://github.com/sass/dart-sass#javascript-api) or [NPM](https://www.npmjs.com/package/sass#user-content-api) pages).
Bootstrap v4 uses [Node Sass](https://github.com/sass/node-sass) for compiling our Sass source files into CSS files (included in our build process). In order to end up with the same generated CSS when compiling Sass using your own asset pipeline, you'll need to use a Sass compiler that supports at least the features that Node Sass does. This is important to note because as of October 26, 2020, LibSass and packages built on top of itincluding Node Sassare [deprecated](https://sass-lang.com/blog/libsass-is-deprecated).

We increase the Sass rounding precision to 6 (by default it's 5 in Node Sass) to prevent issues with browser rounding. If you use Dart Sass this won't be something you need to adjust, as that compiler uses a rounding precision of 10 and for efficiency reasons does not allow it to be adjusted.
If you require newer Sass features or compatibility with newer CSS standards, [Dart Sass](https://sass-lang.com/dart-sass) is now the primary implementation of Sass and supports a JavaScript API that's fully compatible with Node Sass (with a few exceptions listed on both the project's [GitHub](https://github.com/sass/dart-sass#javascript-api) or [npm](https://www.npmjs.com/package/sass#user-content-api) pages).

We increase the Sass rounding precision to 6 (by default, it's 5 in Node Sass) to prevent issues with browser rounding. If you use Dart Sass this won't be something you need to adjust, as that compiler uses a rounding precision of 10 and for efficiency reasons does not allow it to be adjusted.

## Autoprefixer

Expand Down

0 comments on commit 9aaf2c4

Please sign in to comment.