{"id":25105,"library":"compass-compiler","title":"compass-compiler","description":"A Node.js wrapper around the Ruby Compass compiler, providing a programmatic API for compiling Sass/SCSS files via Compass. Version 0.0.1 is a minimal initial release with no active maintenance. It requires Ruby and Compass to be installed on the system. The implementation is derived from grunt-contrib-compass. Use Dart Sass or node-sass for modern Sass compilation without Ruby dependencies.","status":"abandoned","version":"0.0.1","language":"javascript","source_language":"en","source_url":"https://github.com/neekey/compass-compiler","tags":["javascript"],"install":[{"cmd":"npm install compass-compiler","lang":"bash","label":"npm"},{"cmd":"yarn add compass-compiler","lang":"bash","label":"yarn"},{"cmd":"pnpm add compass-compiler","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Package is CommonJS-only; ESM import will fail.","wrong":"import compass from 'compass-compiler';","symbol":"default","correct":"const compass = require('compass-compiler');"},{"note":"The API uses a callback, not promises.","wrong":"compass.compile(options).then(callback);","symbol":"compile","correct":"compass.compile(options, callback);"},{"note":"Only compile is provided; watch is not implemented.","wrong":"compass.watch(options);","symbol":"watch (not available)","correct":"No watch function; use external watcher."}],"quickstart":{"code":"const compass = require('compass-compiler');\n\nconst options = {\n  sassDir: './sass',\n  cssDir: './css',\n  outputStyle: 'expanded',\n  require: ['susy']\n};\n\ncompass.compile(options, function(err, result, code) {\n  if (err) {\n    console.error('Compilation failed:', err);\n    return;\n  }\n  if (code === 127) {\n    console.warn('Ruby/Compass not found. Install Ruby and Compass via gem install compass');\n  } else if (code === 1 && !/Nothing to compile|Compass can\\'t find any Sass files/.test(result.stderr)) {\n    console.warn('Stderr output:', result.stderr);\n  }\n  console.log('Exit code:', code);\n});","lang":"javascript","description":"Shows how to compile Sass with Compass using options object and callback."},"warnings":[{"fix":"Install Ruby via https://rubyinstaller.org/ and run gem install compass","message":"Requires Ruby and Compass to be installed globally on the system.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Ensure Ruby and Compass are installed and available in PATH.","message":"Exit code 127 means Ruby/Compass not found in PATH.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Check stderr for the specific message; ignore if it matches known benign output.","message":"Exit code 1 may be from 'Nothing to compile' and is not necessarily an error.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Migrate to Dart Sass; remove Compass dependencies.","message":"Package is unmaintained and uses deprecated Compass (recommended replacement: Dart Sass with gulp-sass or webpack).","severity":"breaking","affected_versions":">=0.0.1"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install Ruby (e.g., via rubyinstaller.org) and ensure 'ruby' is available in your terminal.","cause":"Ruby is not installed or not in PATH.","error":"Error: spawn ruby ENOENT"},{"fix":"Add Ruby to PATH or reinstall Ruby.","cause":"Compass-compiler cannot find Ruby.","error":"Could not find a Ruby executable 'ruby' on your system."},{"fix":"Use CommonJS require: const compass = require('compass-compiler');","cause":"Trying to use ESM import or destructured export incorrectly.","error":"TypeError: compass.compile is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}