{"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,"search_vec":"'0.4.0':38 '0.5.0':23 '1.9':32 'bundleexec':42 'child':60 'colorizeoutput':43 'compact':44 'config':46 'depend':78 'deprec':29 'emiterror/emitsuccess':50 'exclud':48 'extern':76 'failonwarn':52 'file':21 'gem':15,35,57 'gemvers':47 'grunt':2,6,37 'grunt-scss-lint':1 'gruntplugin':83 'javascript':82 'js':68 'junit':89 'last':26 'like':41,70 'lint':4,14,17,34,85,88 'linter':69 'option':40 'plugin':7 'process':61 'provid':39 'pure':67 'releas':27 'reli':73 'report':45 'reporteroutput':49 'requir':30 'rubi':11,31,56,77 'run':54 'scss':3,13,16,20,33,84,87 'scss-lint':12,86 'slower':65 'stylelint':71 'unmaintain':81 'valid':19 'version':22 'wrap':9","created_at":"2026-05-01T13:46:01.834350+00:00","updated_at":"2026-05-01T13:46:01.834350+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"grunt","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/ahmednuaman/grunt-scss-lint","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/grunt-scss-lint","openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing"],"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}}