{"id":25705,"library":"gulp-sass-lint","title":"gulp-sass-lint","description":"Gulp plugin for Sass Lint that lints SCSS/SASS files during a Gulp build. Current stable version is 1.4.0, with last release in 2017. It wraps sass-lint and provides Gulp-compatible streaming, formatting, and fail-on-error functionality. Key differentiators: integrates directly into Gulp pipelines, supports custom config files, inline rule disabling via source comments. Compared to stylelint or gulp-stylelint, it is specific to Sass (not PostCSS) and relies on the older sass-lint, which is no longer maintained. Release cadence: low/inactive.","status":"maintenance","version":"1.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/sasstools/gulp-sass-lint","tags":["javascript","gulpplugin","sass","gulp","lint"],"install":[{"cmd":"npm install gulp-sass-lint","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-sass-lint","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-sass-lint","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core linting engine for SCSS/SASS","package":"sass-lint","optional":false},{"reason":"Peer dependency required for Gulp plugin interface","package":"gulp","optional":false}],"imports":[{"note":"Default export is the plugin function. In CommonJS, simply require('gulp-sass-lint').","wrong":"const sassLint = require('gulp-sass-lint').default;","symbol":"sassLint","correct":"import sassLint from 'gulp-sass-lint'"},{"note":"format optionally accepts a writable stream; no argument uses stdout.","wrong":"sassLint.format(writable)","symbol":"sassLint.format","correct":"sassLint.format()"},{"note":"Fail the task if any linting error is found.","wrong":"","symbol":"sassLint.failOnError","correct":"sassLint.failOnError()"}],"quickstart":{"code":"import gulp from 'gulp';\nimport sassLint from 'gulp-sass-lint';\n\nexport default function lint() {\n  return gulp.src('sass/**/*.scss')\n    .pipe(sassLint())\n    .pipe(sassLint.format())\n    .pipe(sassLint.failOnError());\n}","lang":"javascript","description":"Sets up a Gulp task to lint all SCSS files, format output, and fail on lint errors."},"warnings":[{"fix":"Migrate to stylelint + @stylistic/stylelint-scss or sass-lint-auto-fix.","message":"sass-lint is deprecated in favor of stylelint with scss plugin.","severity":"deprecated","affected_versions":">=1.4.0"},{"fix":"Pass rules at top level: sassLint({ rules: { 'no-ids': 1 } })","message":"Options object nesting: rules must be inside top-level 'rules', not under 'options.rules'.","severity":"gotcha","affected_versions":">=1.3.0"},{"fix":"Create a .sass-lint.yml file in project root or specify configFile path.","message":"Config file format: .sass-lint.yml is expected, not .sasslintrc or JSON.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use Node.js >=4 or stick to v1.2.x.","message":"Node.js version support: dropped support for Node <4 in v1.3.0.","severity":"breaking","affected_versions":">=1.3.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use default import: import sassLint from 'gulp-sass-lint'","cause":"Using ES import incorrectly expecting named export.","error":"TypeError: gulpSassLint is not a function"},{"fix":"npm install sass-lint --save-dev","cause":"Missing peer dependency sass-lint.","error":"Cannot find module 'sass-lint'"},{"fix":"Ensure .sass-lint.yml is valid and follows sass-lint config spec.","cause":"Config file is not valid YAML or missing required keys.","error":"Error: Invalid config file format"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}