{"id":25682,"library":"grunt-scss-lint","title":"grunt-scss-lint","description":"A Grunt plugin that wraps the Ruby scss-lint gem (scss_lint) to validate .scss files. Version 0.5.0 is the last release before deprecation; requires Ruby >= 1.9, scss_lint gem, and Grunt >= 0.4.0. Provides options like bundleExec, colorizeOutput, compact reporting, config, gemVersion, exclude, reporterOutput, emitError/emitSuccess, and failOnWarning. It runs the Ruby gem as a child process, so it's slower than pure JS linters like stylelint; it relies on an external Ruby dependency and is unmaintained.","status":"deprecated","version":"0.5.0","language":"javascript","source_language":"en","source_url":"git://github.com/ahmednuaman/grunt-scss-lint","tags":["javascript","gruntplugin","scss","lint","scss-lint","junit"],"install":[{"cmd":"npm install grunt-scss-lint","lang":"bash","label":"npm"},{"cmd":"yarn add grunt-scss-lint","lang":"bash","label":"yarn"},{"cmd":"pnpm add grunt-scss-lint","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Grunt plugin: requires Grunt >=0.4.0 as a peer dependency","package":"grunt","optional":false},{"reason":"Requires Ruby runtime to execute the scss_lint gem","package":"ruby","optional":false},{"reason":"The actual linting engine; must be installed as a Ruby gem","package":"scss_lint","optional":false}],"imports":[{"note":"This is a Grunt plugin, not a Node.js module. It is loaded via loadNpmTasks in Gruntfile, not required.","wrong":"require('grunt-scss-lint');","symbol":"grunt-scss-lint","correct":"grunt.loadNpmTasks('grunt-scss-lint');"},{"note":"The task name is 'scsslint', not the package name. Configure it under the 'scsslint' key.","wrong":"grunt.initConfig({ 'grunt-scss-lint': { ... } });","symbol":"scsslint task","correct":"grunt.initConfig({ scsslint: { all: { src: ['src/**/*.scss'] } } });"},{"note":"Options must be nested under an 'options' key within the target or at the task level.","wrong":"scsslint: { config: '.scss-lint.yml', all: { ... } }","symbol":"Options","correct":"scsslint: { options: { config: '.scss-lint.yml' }, all: { src: ['*.scss'] } }"}],"quickstart":{"code":"// Install: npm install grunt-scss-lint --save-dev\n// In Gruntfile.js\nmodule.exports = function(grunt) {\n  grunt.loadNpmTasks('grunt-scss-lint');\n  grunt.initConfig({\n    scsslint: {\n      all: {\n        src: ['src/**/*.scss'],\n        options: {\n          config: '.scss-lint.yml',\n          colorizeOutput: true,\n          failOnWarning: true\n        }\n      }\n    }\n  });\n  grunt.registerTask('default', ['scsslint']);\n};","lang":"javascript","description":"Basic Gruntfile configuration to lint all .scss files with scss-lint using the grunt-scss-lint plugin."},"warnings":[{"fix":"Migrate to stylelint with scss plugin: https://github.com/stylelint-scss/stylelint-scss","message":"This plugin is unmaintained and deprecated. The scss-lint gem is also deprecated; use stylelint or Dart Sass instead.","severity":"deprecated","affected_versions":">=0"},{"fix":"Install Ruby and run 'gem install scss_lint' or ensure bundler is configured correctly.","message":"Requires Ruby and scss_lint gem. If Ruby is not installed or the gem is missing, the task fails with 'Cannot find scss-lint'.","severity":"breaking","affected_versions":">=0"},{"fix":"Upgrade to version 0.3.7+ or set the 'gemVersion' option to avoid confusion.","message":"The gem was renamed from scss-lint to scss_lint. Older versions may try to execute the wrong command.","severity":"breaking","affected_versions":"<0.3.7"},{"fix":"Set colorizeOutput: false on Windows or install 'gem install windows-pr win32console'.","message":"On Windows, colorizeOutput requires extra gems (windows-pr, win32console). Output may be garbled if those are missing.","severity":"gotcha","affected_versions":">=0"},{"fix":"Explicitly set config: '.scss-lint.yml' in your Gruntfile options.","message":"The 'config' option default points to a bundled YAML file inside node_modules. Override to use your own configuration.","severity":"gotcha","affected_versions":">=0"},{"fix":"Set failOnWarning: false in options to fail only on errors.","message":"By default, task fails on warnings (failOnWarning: true). Many users expect only errors to cause failure.","severity":"breaking","affected_versions":">=0.5.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'npm install grunt-scss-lint --save-dev' and ensure grunt.loadNpmTasks('grunt-scss-lint') is called.","cause":"Missing npm package installation or loadNpmTasks with wrong name.","error":"Warning: Cannot find module 'grunt-scss-lint' Use --force to continue."},{"fix":"Install the gem: 'gem install scss_lint' or use bundleExec with Bundler.","cause":"The Ruby gem scss_lint is not installed or not in PATH.","error":"Warning: Cannot find scss-lint. Use --force to continue."},{"fix":"Fix the reported issues in your .scss files or disable failOnWarning if warnings are acceptable.","cause":"SCSS file has lint errors or warnings (and failOnWarning is true).","error":"Fatal error: scss-lint exited with code 1."},{"fix":"Set compact: false in options, or update the scss_lint gem to a compatible version.","cause":"The installed scss_lint gem version does not support the compact output option.","error":"Warning: The --compact flag is not supported by your version of scss-lint."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}