Registry / devops / ember-cli-dependency-checker

ember-cli-dependency-checker

JSON →
library3.3.3jsnpmunverified

ember-cli-dependency-checker is an Ember CLI addon designed to safeguard development workflows by automatically detecting and alerting developers to missing npm, pnpm, and historically, bower dependencies within an Ember project. It executes these checks before crucial `ember` commands run, preventing common errors and ensuring a consistent development environment. The latest stable version is 3.4.0. Releases are irregular, driven primarily by bug fixes, internal dependency updates, and enhancements like new package manager support (e.g., pnpm). Its key differentiator is its deep integration into the Ember CLI ecosystem, providing pre-command validation that other generic dependency checkers might not offer in the same seamless way.

devopstesting
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18226 runs
build_error
glibc
node 18226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

For application developers, direct programmatic import of the main addon object is uncommon. Ember CLI consumes this addon's `index.js` directly as a CommonJS module. While modern Ember applications might transpile ESM syntax, the addon itself exports CJS at its root.

const addon = require('ember-cli-dependency-checker');

The core `Checker` class is available from an internal path. This is a CommonJS default export. While direct import of internal modules is generally discouraged due to potential breaking changes, modern Ember CLI tooling typically allows ESM import syntax for such files through transpilation.

import Checker from 'ember-cli-dependency-checker/lib/checker';

Internal utility functions like `isGitRepo` are provided as named CommonJS exports from their respective `lib/utils` modules. Use named import syntax. Again, accessing internal paths is not part of the public API and should be done with caution.

import { isGitRepo } from 'ember-cli-dependency-checker/lib/utils/git';

Illustrates how to add the `ember-cli-dependency-checker` addon to an Ember CLI project and explains its automatic operation.

npx ember install ember-cli-dependency-checker # After installation, the addon runs automatically before common Ember CLI commands. # For example, running: # npx ember serve # will trigger the dependency check. If dependencies are missing, it will display an error. # To demonstrate a missing dependency warning (DO NOT run in a production project): # 1. Add a non-existent package to package.json, e.g., '"some-non-existent-package": "^1.0.0"' # 2. Delete your node_modules directory. # 3. Run `npx ember s` to see the addon detect the missing dependency.
ember --version
Debug
Known footguns
breakingMajor version upgrades of `ember-cli` itself can sometimes introduce breaking changes that require updates to `ember-cli-dependency-checker` or its configuration. Always consult the release notes for both `ember-cli` and this addon.
gotcha`bower` dependency checking is supported, but Bower itself is deprecated. While the addon will check for bower dependencies if `bower.json` exists, developers should migrate away from Bower entirely.
gotchaThe `engines.node` requirement (`>= 6`) is quite old. While the addon might technically run on older Node versions, modern Ember CLI projects typically require much newer Node.js versions. Running on an outdated Node version can lead to other compatibility issues.
gotchaWhen using monorepos with Yarn or pnpm workspaces, ensure the addon correctly identifies the workspace root and checks dependencies for the active project. While recent versions added pnpm support, complex monorepo setups can still lead to misconfigurations.
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
21 hits · last 30 days
gptbot
4
ahrefsbot
4
amazonbot
4
bytedance
3
script
1
bingbot
1
Resources