Registry / devops / ember-cli-dependency-checker

ember-cli-dependency-checker

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.

devops testing

npm install ember-cli-dependency-checker

github ↗package ↗

INSTALL

IMPORT

SIG · EMBER-CLI-DEPENDEN

ember-cli-dependency-checker

devopsjavascriptv3.3.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

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 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

Addon Definition Object

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

✗ import addon from 'ember-cli-dependency-checker';

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.

Checker

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

✗ const Checker = require('ember-cli-dependency-checker/lib/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.

isGitRepo

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

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

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.

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 issues

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.

fix

Ensure `ember-cli-dependency-checker` is on a compatible version with your `ember-cli` installation, as specified in its `peerDependencies`.

affects: >=3.x

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.

fix

Migrate any remaining Bower dependencies to npm or yarn packages. Remove `bower.json` and any related Bower tooling from your project.

affects: >=1.0

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.

fix

Always use a Node.js version officially supported by your current `ember-cli` version. Refer to the Ember CLI documentation for recommended Node.js versions.

affects: <=3.3.3

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.

fix

Upgrade to `ember-cli-dependency-checker@3.4.0` or newer for improved pnpm support. Verify your monorepo setup is standard and consider checking the addon's source or issues for specific monorepo configurations if problems persist.

affects: <3.4.0

Errors

Common errors & fixes

Missing: [package-name] (expected in `devDependencies` or `dependencies`)

The addon detected a package listed in your `package.json` (or `bower.json`) that is not installed in `node_modules` (or `bower_components`).

fix

Run `npm install`, `yarn install`, or `pnpm install` to install all listed dependencies. If the package is intentionally removed, ensure it's also removed from `package.json`.

Error: The `ember-cli-dependency-checker` addon could not be found or loaded.

The addon was not correctly installed or its entry in `package.json` is corrupted, preventing `ember-cli` from loading it.

fix

Ensure the addon is listed in your `package.json` `devDependencies` and run `npm install` (or `yarn install`/`pnpm install`). If issues persist, try `npx ember uninstall ember-cli-dependency-checker` followed by `npx ember install ember-cli-dependency-checker`.

Upgrade

Version history

3.3.3latest on npm

Audit

Dependencies

ember-clirequiredThis is an Ember CLI addon and requires ember-cli to function. It specifies a peer dependency for compatibility.

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/adopted-ember-addons/ember-cli-dependency-checker ↗

packagehttps://www.npmjs.com/package/ember-cli-dependency-checker ↗