{"id":18019,"library":"yuidoc-ember-cli-theme","title":"Ember CLI YUIDoc Theme","description":"YUIDoc is a Node.js-based documentation generator that creates API documentation from Javadoc-style comments in source code. While not specific to JavaScript, it was designed for the YUI Library. This package, `yuidoc-ember-cli-theme`, provides a visual theme specifically styled for Ember CLI projects when using YUIDoc for documentation. It customizes the output HTML by directing `themedir` and `helpers` within the `yuidoc.json` configuration. The package is currently at version 1.0.4. Given that YUIDoc itself saw its last major update (0.10.0) in 2016 and the Ember community has largely transitioned to more modern documentation solutions like `ember-cli-addon-docs` (which offers more robust support for contemporary JavaScript features and Ember specifics, even if it can use a modified YUIDoc internally), this theme is no longer actively maintained. Its key differentiator was providing an Ember-specific look for YUIDoc output at a time when YUIDoc was more prevalent.","status":"abandoned","version":"1.0.4","language":"javascript","source_language":"en","source_url":"https://github.com/Turbo87/yuidoc-ember-cli-theme","tags":["javascript","yuidoc","ember-cli","theme"],"install":[{"cmd":"npm install yuidoc-ember-cli-theme","lang":"bash","label":"npm"},{"cmd":"yarn add yuidoc-ember-cli-theme","lang":"bash","label":"yarn"},{"cmd":"pnpm add yuidoc-ember-cli-theme","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required for generating documentation; this package provides a theme for it.","package":"yuidocjs","optional":false},{"reason":"Used in an Ember CLI project context; often via an addon like 'ember-cli-yuidoc'.","package":"ember-cli","optional":true}],"imports":[{"note":"This package provides a theme and helpers for YUIDoc, which are configured via the `yuidoc.json` file. It does not expose JavaScript modules for direct import using `import` or `require` statements in application code.","symbol":"Theme Configuration","correct":"{ \"themedir\": \"node_modules/yuidoc-ember-cli-theme\", \"helpers\": [\"node_modules/yuidoc-ember-cli-theme/helpers.js\"] }"}],"quickstart":{"code":"{\n  \"name\": \"my-ember-app\",\n  \"version\": \"0.0.1\",\n  \"description\": \"My Ember CLI Application\",\n  \"options\": {\n    \"paths\": [\"app\", \"addon\"],\n    \"exclude\": \"vendor,tests\",\n    \"outdir\": \"docs\"\n  },\n  \"themedir\": \"node_modules/yuidoc-ember-cli-theme\",\n  \"helpers\": [\"node_modules/yuidoc-ember-cli-theme/helpers.js\"]\n}\n\n// To generate the documentation, run this command in your terminal:\n// yuidoc","lang":"javascript","description":"Demonstrates the `yuidoc.json` configuration required to use the theme and the command to generate documentation."},"warnings":[{"fix":"Consider migrating to more modern documentation tools like `ember-cli-addon-docs` or `JSDoc`/`ESDoc` directly, which have better support for contemporary JavaScript and Ember-specific paradigms.","message":"YUIDoc (the underlying documentation tool) is an older project, with its last major release in 2016. It may have compatibility issues with newer Node.js versions or modern JavaScript syntax features (e.g., ES modules, class fields).","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Evaluate adopting `ember-cli-addon-docs` for new projects or refactoring existing documentation to use it for better long-term support and feature sets.","message":"The Ember ecosystem has largely moved away from YUIDoc for API documentation. The current recommended approach for Ember CLI addons and applications is `ember-cli-addon-docs`, which provides a more integrated and feature-rich documentation experience.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Use with caution in legacy projects. For new development, strongly consider alternatives that are actively maintained.","message":"This theme package (`yuidoc-ember-cli-theme`) is unmaintained, with its last activity on GitHub dating back to late 2016. This means it will not receive updates for bugs, security vulnerabilities, or compatibility with newer Ember or Node.js versions.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-23T00:00:00.000Z","next_check":"2026-07-22T00:00:00.000Z","problems":[{"fix":"Run `npm install -g yuidocjs` to install it globally, or `npm install --save-dev yuidocjs` in your project.","cause":"`yuidocjs` (the YUIDoc generator) is not installed globally or locally.","error":"Error: Cannot find module 'yuidocjs'"},{"fix":"Verify that `node_modules/yuidoc-ember-cli-theme` exists and contains the theme files. Ensure the path in `yuidoc.json` is exactly `node_modules/yuidoc-ember-cli-theme` relative to your project root.","cause":"The `themedir` path in `yuidoc.json` is incorrect or the `yuidoc-ember-cli-theme` package is not correctly installed in `node_modules`.","error":"YUIDoc: themedir is not a directory or does not contain a theme"},{"fix":"Ensure the path `node_modules/yuidoc-ember-cli-theme/helpers.js` is correct and the file exists within the installed package. Re-install the package if necessary: `npm uninstall yuidoc-ember-cli-theme && npm install yuidoc-ember-cli-theme`.","cause":"The `helpers` file path in `yuidoc.json` is incorrect, or the file is missing from the installed package.","error":"Error: ENOENT: no such file or directory, stat 'node_modules/yuidoc-ember-cli-theme/helpers.js'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}