gulp-sass 2.0.2

The Gulp-SASS is an extremely convenient and efficient plugin for Gulp, primarily used for the transformation of SASS and SCSS files into CSS. Built around Dart Sass and fully capable of supporting Node Sass (though deprecated), this invaluable tool is sure to streamline any developer's workflow related to stylesheets.

In order to leverage the advantages of Gulp-SASS, one must first ensure the installation of both the core gulp-sass and a selected SASS compiler. This is achieved through a simple npm command:

npm install sass gulp-sass --save-dev

Then, Gulp-SASS must be incorporated into your gulpfile, fitting it with the compiler of your preference. This example demonstrates how this integration would appear in a CommonJS module:

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

Implementing Gulp-SASS for usage within a Gulp task is also crucial. Here is an example of how to use Gulp-SASS in a Gulp task to render your CSS:

'use strict';

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

function buildStyles() {
  return gulp.src('./sass/**/*.scss')
    .pipe(sass().on('error', sass.logError))
    .pipe(gulp.dest('./css'));
};

exports.buildStyles = buildStyles;
exports.watch = function () {
  gulp.watch('./sass/**/*.scss', ['sass']);
};

Additionally, options can be passed into the renderer to modify the final outcome of the CSS. Inline source maps can be included through the incorporation of a separate package, [gulp-sourcemaps](https://github.com/gulp-sourcemaps/gulp-sourcemaps).

The accompanying documentation and user manual for Gulp-SASS can be readily accessed within the official GitHub repository for this Node.js module under this url: https://github.com/dlmanning/gulp-sass. The repository not only includes detailed explanations and usage examples, but also insightful guidelines for issue filing, version updates, and migration to newer Gulp-SASS versions.