# sverweij/dependency-cruiser

Validate and visualize dependencies. Your rules. JavaScript, TypeScript, CoffeeScript. ES6, CommonJS, AMD.

Repository: https://github.com/sverweij/dependency-cruiser
Canonical: https://ross.abutalabs.com/products/dependency-cruiser
Homepage: https://npmjs.com/dependency-cruiser
Language: JavaScript
License: MIT
License Family: permissive
Topics: dependency-cruiser, typescript, javascript, static-analysis, dependency-analysis, dependency-graph, circular-dependencies, jsx, tsx, dependencies, architecture-diagram, vue
Last push: 2026-08-21T19:10:37+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 97, longevity 100
- inputs: {"age_days": 3573, "days_push": 12, "days_rel": 23, "gap_med": 18.0, "n_releases_24m": 35}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7104, forks 298 (observed 2026-08-28T04:09:55.922757+00:00)

## What it is
A CLI tool that analyzes and validates dependencies in JavaScript, TypeScript, LiveScript, and CoffeeScript projects against user-defined rules. It reports rule violations for builds and generates dependency graph visualizations in formats like dot, mermaid, JSON, CSV, and HTML.

## Use cases
- detect circular dependencies in a javascript or typescript project
- enforce architecture rules on module imports
- generate a dependency graph visualization of my codebase
- lint import rules in CI builds
- visualize dependencies of an npm package
- prevent forbidden module dependencies in a monorepo

## When to choose
- you need customizable dependency rules validated in builds or CI
- you want visual dependency graphs for JavaScript/TypeScript projects
- you need to detect and prevent circular dependencies

## When to avoid
- you work in a non-JavaScript language like Python, Go, or Java
- you need runtime dependency analysis rather than static analysis
- you only need a quick one-off dependency list without rule validation

## Facets
- artifact type: cli-tool
- maturity: active
- function: static-site-generator, linter, developer-tools, data-visualization
- domain: developer-tools, version-control, testing
- platform: cli, cross-platform
- tags: dependency-analysis, dependency-graph, circular-dependencies, static-analysis, architecture-rules, typescript, javascript, graphviz, architecture-diagram, nodejs

## Member repositories
- sverweij/dependency-cruiser (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:55.922757+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:40:08.481606+00:00, confidence not recorded.
  - readme: https://github.com/sverweij/dependency-cruiser (fetched 2026-08-28T04:09:55.922757+00:00, sha fa712024be26)
  - homepage: https://npmjs.com/dependency-cruiser (fetched 2026-08-29T08:36:04.175496+00:00, sha dda04a2792ab)
- Data as of 2026-08-30T08:39:29.467469+00:00.