{"id":25212,"library":"ember-cli-compass-compiler","title":"Ember CLI Compass Compiler","description":"Addon for Ember CLI that integrates the Compass CSS authoring framework via a Ruby-based compiler. Version 0.5.0 is the current stable release, but the project has been unmaintained since 2016. It requires Ruby and the compass gem to be installed on the system. Unlike broccoli-sass or other pure JavaScript solutions, this addon delegates compilation to the external compass command, providing full Compass library support. It automatically compiles .scss files in app/styles, with the main file expected to be app.scss (breaking change from earlier versions that required appname.scss). Supports custom import paths and compassOptions overrides via Brocfile. Known issues include missing support for modern Ember CLI versions, Ruby dependency overhead, and incompatibility with newer Node.js versions.","status":"abandoned","version":"0.5.0","language":"javascript","source_language":"en","source_url":"https://github.com/quaertym/ember-cli-compass-compiler","tags":["javascript","ember-addon","ember-cli","ember","compass","scss","sass","css","compile"],"install":[{"cmd":"npm install ember-cli-compass-compiler","lang":"bash","label":"npm"},{"cmd":"yarn add ember-cli-compass-compiler","lang":"bash","label":"yarn"},{"cmd":"pnpm add ember-cli-compass-compiler","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core compilation logic extracted into this broccoli plugin.","package":"broccoli-compass-compiler","optional":false},{"reason":"Low-level binding to run the compass command.","package":"compass-compile","optional":false}],"imports":[{"note":"compassOptions is passed to the EmberApp constructor as a property of the options object.","wrong":"var app = EmberApp.create({ compassOptions: ... })","symbol":"default (EmberApp options)","correct":"new EmberApp({ compassOptions: { outputStyle: 'expanded' } })"},{"note":"SCSS uses double quotes for imports.","wrong":"@import 'compass'","symbol":"compass import in SCSS","correct":"@import \"compass\";"},{"note":"The option is named importPath (singular).","wrong":"compassOptions: { importPaths: [...] }","symbol":"importPath option","correct":"compassOptions: { importPath: ['bower_components/some-dir'] }"}],"quickstart":{"code":"// Install the addon\n// ember install ember-cli-compass-compiler\n\n// In Brocfile.js (for Ember CLI < 2.x)\nvar EmberApp = require('ember-cli/lib/broccoli/ember-app');\nvar app = new EmberApp({\n  compassOptions: {\n    outputStyle: 'expanded',\n    require: ['sass-css-importer', 'susy']\n  }\n});\n\n// In app/styles/app.scss\n@import \"compass\";\n\n.round-rect-button {\n  @include border-radius(4px, 4px);\n}\n\nmodule.exports = app.toTree();","lang":"javascript","description":"Install the addon, configure compassOptions, and use Compass mixins in app.scss."},"warnings":[{"fix":"Rename your main SCSS file from <appname>.scss to app.scss.","message":"Main SCSS file must be named app.scss (v0.2.0 breaking change)","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Run 'gem install compass' and ensure Ruby is available in PATH.","message":"Requires Ruby and compass gem to be installed globally","severity":"gotcha","affected_versions":"all"},{"fix":"Migrate to a pure JavaScript solution like ember-cli-sass or broccoli-sass.","message":"Addon is unmaintained; does not work with Ember CLI > 2.x or Node > 6","severity":"deprecated","affected_versions":"all"},{"fix":"Ensure addon's index.js defines an 'included' function that calls this._super.included(app).","message":"Cannot read property 'compassOptions' of undefined","severity":"gotcha","affected_versions":"all"},{"fix":"Use a Unix-like environment or switch to a Node-based compiler.","message":"Windows compatibility issues with Ruby/compass subprocess","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Add 'included: function(app) { this._super.included(app); }' to index.js.","cause":"Addon's index.js missing included function or not calling super.","error":"Cannot read property 'compassOptions' of undefined"},{"fix":"Run 'gem install compass' and verify with 'which compass'.","cause":"Ruby compass gem not installed or not in PATH.","error":"Error: compass not found"},{"fix":"Ensure compassOptions is passed to new EmberApp() only if needed, or check Ember CLI version.","cause":"Same as above but from EmberApp constructor.","error":"TypeError: Cannot read property 'compassOptions' of undefined"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}