{"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,"search_vec":"'1.4.0':27 'allow':60 'author':37 'bundl':20 'cach':58 'command':15 'command-lin':14 'compil':7 'current':23 'darg':54 'dart':82 'exec':21 'explicit':31 'featur':49 'file':57 'glob':61 'gulp':2,4,43,64,74,81,88,91 'gulp-dart-sass':80 'gulp-ruby-sass':63 'gulp-sass':42,73,90 'gulp-scss':1,87 'gulpplugin':86 'instead':84 'javascript':85 'libsass':39 'line':16 'match':46 'new':70 'node':77 'node-sass':76 'note':32 'obsolet':34 'option':52 'pass':51 'plugin':5,29 'project':71 'recommend':68 'rubi':47,65 'sass':9,44,48,66,75,78,83,92 'scss':3,8,13,22,89 'stabl':24 'standard':12 'support':55 'temporari':56 'tool':17 'unlik':62 'use':10,40,72 'version':25 'via':19,53","created_at":"2026-05-01T17:44:10.773579+00:00","updated_at":"2026-05-01T17:44:10.773579+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/forumouth/gulp-scss","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/gulp-scss","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-05-01","next_check":"2026-07-30","install_tag":null}}