{"id":25030,"library":"broccoli-sass2scss","title":"Broccoli Sass to SCSS","description":"A Broccoli plugin that compiles Sass/SCSS files into CSS using libsass. The current version (0.1.3) is stable but relies on an outdated Node.js addon build process (node-gyp) and libsass, which is deprecated in favor of Dart Sass. Key differentiators: integrates with the Broccoli asset pipeline, supporting multiple input trees and source maps. However, due to libsass deprecation and potential native module issues, it is recommended to use alternative plugins like 'broccoli-sass' or 'broccoli-sass-source-maps' that leverage Dart Sass or newer bindings.","status":"deprecated","version":"0.1.3","language":"javascript","source_language":"en","source_url":"https://github.com/jmcnally/broccoli-sass2scss","tags":["javascript","broccoli-plugin","sass","scss","css","sass2scss"],"install":[{"cmd":"npm install broccoli-sass2scss","lang":"bash","label":"npm"},{"cmd":"yarn add broccoli-sass2scss","lang":"bash","label":"yarn"},{"cmd":"pnpm add broccoli-sass2scss","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Typo: 'broccoli-sass2scss' is the same as 'broccoli-sass' package, but the npm metadata is misleading. The actual plugin is broccoli-sass.","package":"broccoli-sass","optional":false}],"imports":[{"note":"This package is CJS-only. ESM import will fail.","wrong":"import compileSass from 'broccoli-sass';","symbol":"compileSass","correct":"const compileSass = require('broccoli-sass');"},{"note":"Package name is 'broccoli-sass', not 'broccoli-sass2scss'.","wrong":"const compileSass = require('broccoli-sass2scss');","symbol":"compileSass","correct":"var compileSass = require('broccoli-sass');"},{"note":"No default export. Use module.exports directly.","wrong":"var compileSass = require('broccoli-sass').default;","symbol":"compileSass","correct":"const compileSass = require('broccoli-sass');"}],"quickstart":{"code":"const compileSass = require('broccoli-sass');\nconst { WatchedDir } = require('broccoli-source');\n\nconst sourceTrees = [new WatchedDir('app/styles')];\nconst inputFile = 'app.scss';\nconst outputFile = 'app.css';\nconst options = { outputStyle: 'compact' };\n\nconst outputTree = compileSass(sourceTrees, inputFile, outputFile, options);\n\nmodule.exports = outputTree;","lang":"javascript","description":"Basic usage of broccoli-sass: compiles app/styles/app.scss to app.css with compact output style."},"warnings":[{"fix":"Switch to a broccoli plugin that uses Dart Sass, e.g., 'broccoli-sass-source-maps' or use sass package directly.","message":"libsass is deprecated; Dart Sass is the recommended alternative.","severity":"deprecated","affected_versions":">=0.0.0"},{"fix":"Install 'broccoli-sass' instead of 'broccoli-sass2scss'.","message":"Package name mismatch: 'broccoli-sass2scss' does not exist; the correct package is 'broccoli-sass'.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Ensure build tools are installed (python, C++ compiler) or switch to a pure-JS alternative.","message":"Requires node-gyp to compile native libsass bindings; may fail on some systems.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"npm install --save-dev broccoli-sass","cause":"Incorrect package name; 'broccoli-sass2scss' is not published.","error":"Error: Cannot find module 'broccoli-sass2scss'"},{"fix":"npm install --save-dev node-sass","cause":"Missing libsass binding; this plugin depends on node-sass which may not be installed.","error":"Error: Module build failed: Error: Cannot find module 'node-sass'"},{"fix":"Reinstall build tools: `npm install -g node-gyp` then `npm rebuild node-sass`","cause":"node-gyp failed to compile native module.","error":"Error: The libsass native extension is not available. Try reinstalling node-sass."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}