{"id":27038,"library":"gulp-scss","title":"gulp-scss","description":"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.","status":"deprecated","version":"1.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/forumouth/gulp-scss","tags":["javascript","gulpplugin","gulp-scss","gulp-sass"],"install":[{"cmd":"npm install gulp-scss","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-scss","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-scss","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"stream transformation","package":"through2","optional":false},{"reason":"converts options object to command-line arguments","package":"dargs","optional":false},{"reason":"used for logging and plugin utilities","package":"gulp-util","optional":false}],"imports":[{"note":"Default import. The plugin is a function that takes options.","wrong":"const gulpScss = require('gulp-scss')","symbol":"gulpScss","correct":"import gulpScss from 'gulp-scss'"},{"note":"gulp itself is a separate dependency, but commonly used together.","wrong":"const gulp = require('gulp')","symbol":"gulp","correct":"import gulp from 'gulp'"},{"note":"Named export does not exist; use default import.","wrong":"const { scss } = require('gulp-scss')","symbol":"scss","correct":"import scss from 'gulp-scss'"}],"quickstart":{"code":"import gulp from 'gulp';\nimport scss from 'gulp-scss';\n\ngulp.task('scss', function() {\n  return gulp.src('src/**/*.scss')\n    .pipe(scss({\n      bundleExec: true,\n      tmpPath: '.temp-cache'\n    }))\n    .pipe(gulp.dest('dist/css'));\n});","lang":"javascript","description":"Shows basic gulp task that compiles SCSS files using gulp-scss with bundle exec and custom temp path."},"warnings":[{"fix":"Replace gulp-scss with gulp-sass and adjust your configuration.","message":"This package is obsolete. Use gulp-sass (node-sass) or gulp-dart-sass instead.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Ensure options are in format suitable for CLI flags; test command generation.","message":"Options are passed via dargs: boolean options like sourcemap become --sourcemap without value—might cause unexpected behavior.","severity":"gotcha","affected_versions":">=1.2.0"},{"fix":"If not available, install Ruby Sass or use bundle exec with a Gemfile.","message":"Requires Ruby Sass or `bundle exec scss` installed system-wide; not a pure Node.js solution.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consider migrating to gulp-sass or another maintained plugin.","message":"The `gulp-util` dependency is deprecated and may cause peer-dep warnings.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install Ruby Sass: gem install sass, or use bundleExec: true and ensure bundle is available.","cause":"Ruby Sass (or `scss` command) is not installed on the system.","error":"Error: spawn scss ENOENT"},{"fix":"Use import scss from 'gulp-scss' (default import) instead of destructuring.","cause":"Incorrect import style; using named import instead of default.","error":"TypeError: scss is not a function"},{"fix":"Flatten options into string-typed CLI flags, or use gulp-sass which supports object options.","cause":"Complex options (e.g., loadPath as array) may not serialize correctly.","error":"Options passed to dargs produce invalid command line"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}