{"id":25707,"library":"gulp-scss-lint","title":"gulp-scss-lint","description":"Gulp plugin to validate .scss files using the Ruby-based scss-lint tool, wrapping it into a Gulp pipeline for linting SCSS stylesheets. Version 1.0.0, last updated 2016, with no recent releases. Works with Node >= 0.10 and requires Ruby and scss_lint gem installed separately. Offers options for config file, bundle exec, reporter output, maxBuffer, and endless mode for watch. Deprecated in favor of sass-lint or stylelint, as scss-lint is no longer maintained by its original authors. Release cadence: single stable release. Key differentiator vs JavaScript-based linters: leverages Ruby scss-lint's rule set.","status":"deprecated","version":"1.0.0","language":"javascript","source_language":"en","source_url":"git://github.com/juanfran/gulp-scss-lint","tags":["javascript","gulpplugin","scss-lint","scsslint","sass-lint","scss","lint","gulp"],"install":[{"cmd":"npm install gulp-scss-lint","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-scss-lint","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-scss-lint","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency – requires Gulp to be installed as a plugin","package":"gulp","optional":true}],"imports":[{"note":"ESM import style – but the package is CommonJS, require() also works; no named exports.","wrong":"const scsslint = require('gulp-scss-lint')","symbol":"default","correct":"import scsslint from 'gulp-scss-lint'"},{"note":"CommonJS require is the only supported pattern. Named import will fail.","wrong":"import { scsslint } from 'gulp-scss-lint';","symbol":"scsslint","correct":"const scsslint = require('gulp-scss-lint');"},{"note":"Must return the stream for Gulp to handle async correctly; arrow functions work but the stream must be returned.","wrong":"gulp.task('lint', () => gulp.src('*.scss').pipe(scsslint()));","symbol":"gulp.task","correct":"gulp.task('lint', function() { return gulp.src('*.scss').pipe(scsslint()); });"}],"quickstart":{"code":"const gulp = require('gulp');\nconst scsslint = require('gulp-scss-lint');\n\ngulp.task('scss-lint', function() {\n  return gulp.src('src/**/*.scss')\n    .pipe(scsslint({\n      config: '.scss-lint.yml',\n      bundleExec: false,\n      reporterOutput: 'scssReport.json',\n      maxBuffer: 307200\n    }));\n});\n\ngulp.task('default', gulp.series('scss-lint'));\n","lang":"javascript","description":"Creates a Gulp task that lints all .scss files in src/, using a custom config file and outputting a JSON report."},"warnings":[{"fix":"Migrate to a JavaScript-based linter like stylelint with scss plugin or sass-lint.","message":"scss-lint (Ruby gem) is deprecated; its official repository archived in 2019. gulp-scss-lint is no longer maintained.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Install Ruby and run `gem install scss_lint` before using this plugin.","message":"Requires Ruby and the scss_lint gem installed globally. Missing dependency leads to silent failures or 'command not found' errors.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Use a child_process polyfill or update plugin; consider migrating to sass-lint.","message":"The plugin does not support Node.js versions above 0.10 officially; may break on modern Node (>=12).","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Increase maxBuffer option (e.g., 307200) in scsslint() config.","message":"maxBuffer default is 300*1024 bytes; if you hit 'maxBuffer exceeded', the error is not descriptive.","severity":"gotcha","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 scss-lint: `gem install scss_lint` and ensure Ruby is in PATH.","cause":"scss-lint Ruby gem not installed or not found in PATH.","error":"Error: spawn scss-lint ENOENT"},{"fix":"Add `maxBuffer: 307200` to the scsslint() options (or higher).","cause":"Default maxBuffer (300*1024) insufficient for large lint output.","error":"throw new Error('scss-lint output buffer exceeded')"},{"fix":"Use `const scsslint = require('gulp-scss-lint');` or `import scsslint from 'gulp-scss-lint';`","cause":"Using ES6 import syntax with named import instead of default import or require.","error":"TypeError: scsslint is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}