{"id":18302,"library":"ember-cli-less","title":"ember-cli-less","description":"Ember CLI addon to compile Less CSS into your Ember app's CSS. Current stable version is 3.0.2. Maintained as an Ember ecosystem addon, integrates with Ember CLI build pipeline. Supports multiple input/output CSS files, source maps, and nested addon usage. Alternatives include ember-cli-sass for SCSS. Requires Ember.js v3.12+, Ember CLI v2.13+, and Node.js v10+.","status":"active","version":"3.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/gdub22/ember-cli-less","tags":["javascript","ember-addon","less","css","preprocessor"],"install":[{"cmd":"npm install ember-cli-less","lang":"bash","label":"npm"},{"cmd":"yarn add ember-cli-less","lang":"bash","label":"yarn"},{"cmd":"pnpm add ember-cli-less","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Less compiler peer dependency; must be installed separately","package":"less","optional":false},{"reason":"Internal dependency for compiling single Less files","package":"broccoli-less-single","optional":true},{"reason":"Internal dependency for merging tree outputs","package":"broccoli-merge-trees","optional":true}],"imports":[{"note":"Addon should be in devDependencies, not dependencies.","wrong":"npm install --save ember-cli-less","symbol":"ember-cli-less (addon installation)","correct":"npm install --save-dev ember-cli-less"},{"note":"Use 'paths' (array) for include paths, not 'path'.","wrong":"let app = new EmberApp({ lessOptions: { path: [...] } });","symbol":"lessOptions configuration","correct":"let app = new EmberApp({ lessOptions: { paths: [...] } });"},{"note":"Use the nested object format with 'app.css' key under 'app'.","wrong":"let app = new EmberApp({ outputPaths: { 'app.css': '/assets/my-app.css' } });","symbol":"outputPaths configuration","correct":"let app = new EmberApp({ outputPaths: { app: { css: { app: '/assets/my-app.css' } } } });"}],"quickstart":{"code":"// Install the addon\nnpm install --save-dev ember-cli-less less\n\n// In ember-cli-build.js\nlet app = new EmberApp(defaults, {\n  lessOptions: {\n    paths: [\n      'node_modules/bootstrap-less/bootstrap'\n    ],\n    sourceMap: true\n  }\n});\n\n// Then in app/styles/app.less:\n@import 'bootstrap';\n// Your custom Less styles","lang":"javascript","description":"Install ember-cli-less and Less compiler, configure include paths and source maps, then import Bootstrap Less in app.less."},"warnings":[{"fix":"Run 'npm install --save-dev less' alongside ember-cli-less.","message":"Less compiler must be installed separately as a peer dependency.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Accept the generated .map filename; manual naming is not supported.","message":"When using multiple output paths, source map names are auto-generated from output path and cannot be customized.","severity":"gotcha","affected_versions":">=1.5.0"},{"fix":"Update your project to meet minimum versions. See CHANGELOG.","message":"Breaking change in v3.0.0: Requires Node.js >=10, Ember.js >=3.12, Ember CLI >=2.13.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use broccoli-merge-trees in your own build process instead of through lessOptions.","message":"The 'mergeTrees' option is deprecated in favor of using broccoli-merge-trees directly.","severity":"deprecated","affected_versions":">=1.5.0"},{"fix":"For addons, create 'app/styles/app.less' in the addon and use @import to include addon styles.","message":"Addon styles are compiled from 'addon/styles/addon.less' into merged addon CSS; direct imports in app.less may not work.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install --save-dev less' in your project.","cause":"Missing peer dependency 'less'.","error":"Error: Cannot find module 'less'"},{"fix":"Change to 'paths: [...]' as an array.","cause":"Using 'path' instead of 'paths' for include paths.","error":"Unrecognized option: path (in lessOptions)"},{"fix":"Create 'app/styles/app.less' even if empty, or adjust input path.","cause":"Missing app.less file when addon expects it.","error":"ENOENT: no such file or directory, open '.../app/styles/app.less'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}