v6.0.0

First and foremost a huge shout out to @wkillerud for making this long awaited release possible <3

Breaking changes

• Migrate to use the new Sass JS API by default (@wkillerud, #846)

Documentation

• Update the watch task documentation (@g1eny0ung, #847) & (@xzyfer)

Upgrading to v6

gulp-sass version 6 uses the new compile function internally by default. If you use any options, for instance custom importers, please compare the new options with the legacy options in order to migrate. For instance, the outputStyle option is now called style.

  function buildStyles() {
    return gulp.src('./sass/**/*.scss')
-     .pipe(sass({outputStyle: 'compressed'}).on('error', sass.logError))
+     .pipe(sass({style: 'compressed'}).on('error', sass.logError))
      .pipe(gulp.dest('./css'));
  };

If you want to keep using the legacy API while it's available, you can.

const sass = require('gulp-sass/legacy')(require('sass'));

or to continue using node-sass

npm install gulp-sass node-sass

const sass = require('gulp-sass/legacy')(require('node-sass'));

If you use source maps, you may see the result change somewhat. The result will typically be absolute file: URLs, rather than relative ones. The result may also be the source itself, URL encoded. You can optionally add custom importers to adjust the source maps according to your own needs.

New Contributors

• @wkillerud made their first contribution in #846
• @g1eny0ung made their first contribution in #847

Full Changelog: v5.1.0...v6.0.0

v5.1.0

Huge shout out to @XhmikosR for putting a ton of effort into this release 🎉

What's Changed

• Document usage in ESM modules by @mxmason in #805
• Typo @ README.md by @radimvaculik in #807
• package.json: specify the files to include by @XhmikosR in #817
• Enforce LF by @XhmikosR in #814
• Update dependencies by @XhmikosR in #816
• Switch to GitHub Actions CI by @XhmikosR in #813
• Replace lodash with the lodash.clonedeep package by @XhmikosR in #818
• Tweak README.md by @XhmikosR in #821
• Move eslint to npm scripts by @XhmikosR in #819
• Minor lint tweaks by @XhmikosR in #820
• Fix fix script by @XhmikosR in #823
• Minor tweaks and cleanup by @XhmikosR in #822
• Update devDependencies and switch to Node.js 16/npm 7+ by @XhmikosR in #829
• Update devDependencies by @XhmikosR in #835
• Update README.md by @XhmikosR in #832
• Clean up return statements by @XhmikosR in #836
• CI: use lts/* for the lint job by @XhmikosR in #839
• Replace chalk with picocolors by @XhmikosR in #833
• Reword missing compiler message by @XhmikosR in #834
• Remove should by @XhmikosR in #841
• Remove transfob package by @XhmikosR in #840
• Update CHANGELOG.md by @XhmikosR in #831
• Add sass tests too by @XhmikosR in #842

New Contributors

• @radimvaculik made their first contribution in #807
• @XhmikosR made their first contribution in #817

Full Changelog: v5.0.0...v5.1.0

v5.0.0

First and foremost a huge shout out to @mxmason for making this long awaited release possible <3

Breaking changes

• Require Node >= 12
• Require Gulp 4
• Drop dependency on the deprecate node-sass
• Remove hardcoded default Sass compiler

Upgrading to v5

It is now required to explicitly install a Sass compiler.

npm install gulp-sass sass

or to continue using node-sass

npm install gulp-sass node-sass

Gulp tasks will also need to be update to use the installed Sass compiler

const sass = require('gulp-sass')(require('sass'));

Check out the upgrade guide for more details.

v4.1.1

Dependencies

• Bump lodash@^4.17.20 (@Larinar, #776)

v4.1.0

Features

• Update modified time on output file (@WraithKenny, #706)

Dependencies

• Migrate to the lodash package (@stof, #728)

v4.0.2

Documentation

• Document how to use Dart Sass (@nex3, #672)

v4.0.1

Fixes

• logError causing an error (@DKvistgaard, #681)

v4.0.0

This release is remove our dependency on the deprecated gulp-util package. To do so we need to drop support for Node < 4.

We took this opportunity to update our support policy to match the upcoming Node Sass 5 release. From now on Gulp Sass will only support Active LTS and Current Node versions.

At the time of release this means Node ^6.9 || ^8.9 || ^9 || ^10.

Breaking changes

• Drop support for non-Active LTS and Current releases

Misc

• Replace deprecated gulp-utils (@demurgos)
• Update dependencies (@demurgos)

v3.2.1

Features

• Bump minimum node-sass to 4.8.3 (@xzyfer)

v3.2.0

Features

• Bump minimum node-sass to 4.8.1 (@xzyfer)

Maintainence

• Add Windows CI (@xzyfer)

Fixes

• Fix tests to run on Windows (@phawxby)
• Fix code formatting (@yusrilhs)