gulp-scss

library1.4.0jsnpmunverified

Gulp plugin for compiling SCSS (SASS) using the standard `scss` command-line tool or via `bundle exec scss`. Current stable version is 1.4.0. The plugin is explicitly noted as obsolete by the author because libsass (used by gulp-sass) now matches Ruby Sass features. It passes options via dargs, supports temporary file caching, and allows globbing (unlike gulp-ruby-sass). Not recommended for new projects; use gulp-sass (node-sass) or gulp-dart-sass instead.

devops

npm install gulp-scss

github ↗package ↗

INSTALL

IMPORT

SIG · GULP-SCSS

gulp-scss

devopsjavascriptv1.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

gulpScss

✓ import gulpScss from 'gulp-scss'

✗ const gulpScss = require('gulp-scss')

Default import. The plugin is a function that takes options.

gulp

✓ import gulp from 'gulp'

✗ const gulp = require('gulp')

gulp itself is a separate dependency, but commonly used together.

scss

✓ import scss from 'gulp-scss'

✗ const { scss } = require('gulp-scss')

Named export does not exist; use default import.

Shows basic gulp task that compiles SCSS files using gulp-scss with bundle exec and custom temp path.

import gulp from 'gulp'; import scss from 'gulp-scss'; gulp.task('scss', function() { return gulp.src('src/**/*.scss') .pipe(scss({ bundleExec: true, tmpPath: '.temp-cache' })) .pipe(gulp.dest('dist/css')); });

Debug

Known issues

deprecatedThis package is obsolete. Use gulp-sass (node-sass) or gulp-dart-sass instead.

fix

Replace gulp-scss with gulp-sass and adjust your configuration.

affects: >=1.0.0

gotchaOptions are passed via dargs: boolean options like sourcemap become --sourcemap without value—might cause unexpected behavior.

fix

Ensure options are in format suitable for CLI flags; test command generation.

affects: >=1.2.0

gotchaRequires Ruby Sass or `bundle exec scss` installed system-wide; not a pure Node.js solution.

fix

If not available, install Ruby Sass or use bundle exec with a Gemfile.

affects: >=1.0.0

deprecatedThe `gulp-util` dependency is deprecated and may cause peer-dep warnings.

fix

Consider migrating to gulp-sass or another maintained plugin.

affects: >=1.0.0

Errors

Common errors & fixes

Error: spawn scss ENOENT

Ruby Sass (or `scss` command) is not installed on the system.

fix

Install Ruby Sass: gem install sass, or use bundleExec: true and ensure bundle is available.

TypeError: scss is not a function

Incorrect import style; using named import instead of default.

fix

Use import scss from 'gulp-scss' (default import) instead of destructuring.

Options passed to dargs produce invalid command line

Complex options (e.g., loadPath as array) may not serialize correctly.

fix

Flatten options into string-typed CLI flags, or use gulp-sass which supports object options.

Upgrade

Version history

1.4.0latest on npm

Audit

Dependencies

through2requiredstream transformation

dargsrequiredconverts options object to command-line arguments

gulp-utilrequiredused for logging and plugin utilities

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/forumouth/gulp-scss ↗

packagehttps://www.npmjs.com/package/gulp-scss ↗