@wuyuchentr/dependency-graph-viz

Generate a dependency graph of your Node.js project in Mermaid or DOT format.

Usage

npx dep-graph > deps.md
npx dep-graph --format dot > deps.dot
npx dep-graph --format mermaid --depth 3 --dev > full-deps.md

Options

| Flag | Description | |------|-------------| | -f, --format <mermaid\|dot> | Output format (default: mermaid) | | -d, --depth <n> | Traversal depth (default: 2, use 0 for unlimited) | | --dev | Include both prod + dev deps | | --only-dev | Only devDependencies | | --only-prod | Only dependencies (default) | | -e, --exclude <name> | Exclude a package (repeatable) | | -r, --root <path> | Project root directory |

Examples

# Quick mermaid graph (prod deps, depth 2)
npx dep-graph > deps.md

# Full graph with dev deps, unlimited depth
npx dep-graph --dev --depth 0 > full.md

# DOT format for Graphviz
npx dep-graph --format dot --only-prod > graph.dot
dot -Tpng graph.dot -o graph.png

# Exclude a package
npx dep-graph --exclude @types --exclude eslint > deps.md

Output example (Mermaid)

graph LR
  lodash-->is-array
  react-->loose-envify
  react-->object-assign
  loose-envify-->js-tokens

Output example (DOT)

digraph G {
  "react" -> "loose-envify";
  "react" -> "object-assign";
}