iamdue / gulp-sassc-shell

Compile SASS with Libsass sassc binary from gulp.

gulp-sassc-shell

If your SASS compiles slow, then try this plugin, compile SASS to CSS faster then ever before using libsass from Gulp using shell. This plugin works with sassc binary compiled for you platform. For compiling sassC on you platform follow this guide: https://github.com/sass/sassc .

Getting Started

This plugin requires Gulp ~3.9.1

If you haven't used Gulp before, be sure to check out the Getting Started guide. Once you're familiar with that process, you may install this plugin with this command:

npm install gulp-sassc-shell --save-dev

Once the plugin has been installed, it may be enabled inside your Gulpfile with this line of JavaScript or with the matchdep npm package (gulp-*) syntax:

const sassc = require('gulp-sassc-shell');

The sassc task

Overview

In your project's directory, add a task with any name you want, and select the *scss file from your project, then pipe it to the plugins function.

gulp.task('build-cssC', function () {
	return gulp.src('./scss/*.scss').pipe(
		sassc({
			outputStyle: 'nested',
			sourceMap: true,
			precision: 3,
			destination: "css/dist"
		})
	);
});

Options

This plugin only support the options that sassc binary does. These are the following:

outputStyle

Alias: style Type: String Default value: 'nested'

Output style. Can be nested, compact, compressed, expanded.

precision

Type: String Default value: '3'

How many digits of precision to use when outputting decimal numbers.

loadPath

Type: String|Array

Add a (or multiple) Sass import path.

sourceMap

Type: String
Default: false

If set to true a sourceMap uri will be injected to the end of the destination file.

destination

Type: String
Default: false

Destination is a required property to use sassc binary. Sassc binary will get this parameter to generate the css to this directory.

Usage Examples

Default Options

gulp.task('build-cssC', function () {
	return gulp.src('./scss/*.scss').pipe(
		sassc({
			outputStyle: 'nested',
			sourceMap: true,
			precision: 3,
			destination: "css/dist"
		})
	);
});

Contributing

Feedbacks are welcome. If you want to contribute, send a mail to me: [email protected] .

Release History

0.0.1 - 2018.06.18 - First release

License

MIT © Gyorgy Sagi