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
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
dependentBuild
✓ import { dependentBuild } from 'dependent-build'
✗ const dependentBuild = require('dependent-build')
The package does not export a default. The named export 'dependentBuild' is the main function.
default
✓ import { dependentBuild } from 'dependent-build'
✗ import dependentBuild from 'dependent-build'
No default export exists. Use named import.
run
✓ import { run } from 'dependent-build'
✗ const run = require('dependent-build').run
'run' is another named export for programmatic execution.
Shows programmatic usage: import named function, call with options, and handle promise resolution.
import { dependentBuild } from 'dependent-build';
// Configuration example (dependent-build.yml):
// projects:
// - name: lib-a
// depends:
// - lib-b
// - name: lib-c
// depends:
// - lib-a
// - lib-b
dependentBuild({
config: 'dependent-build.yml',
cwd: process.cwd(),
silent: false
}).then(() => {
console.log('Build order resolved and triggered');
}).catch(err => {
console.error('Build failed:', err);
});
dependent-build --version
Debug
Known issues
breakingConfiguration format and API may change without warning in future versions.fixPin to a specific minor version (e.g., 0.1.x) and test upgrades.
affects: <1.0.0
deprecatedNo deprecated features documented yet.
gotchaOnly supports Node >= 4. If CI matrix includes older Node versions, builds will fail.fixUse node-version-check to skip dependent-build on older Node versions.
affects: >=0
breakingYAML configuration file must exist at the project root; otherwise, the tool throws an error.fixCreate a 'dependent-build.yml' file or provide custom path via options.
affects: *
Errors
Common errors & fixes
Error: Cannot find module 'js-yaml'
Missing dependency js-yaml when using dependent-build programmatically without installing it.
fixRun 'npm install js-yaml' as the package declares it as a peer dependency.
dependent-build: config file not found: dependent-build.yml
Configuration file is missing or not located at the expected path.
fixEnsure a 'dependent-build.yml' file exists in the root directory or pass a custom 'config' path.
dependent-build: Project 'X' dependency cycle detected
Circular dependency in the YAML configuration (e.g., A depends on B, B depends on A).
fixRemove circular dependency by restructuring project dependencies.
Audit
Dependencies
js-yamlrequiredparsing YAML configuration file
minimistrequiredcommand-line argument parsing