![\"madge\"](\"http://pahen.github.io/madge/logo.svg\"){kind=logo}
\n\n \n
![\"graph\"](\"http://pahen.github.io/madge/madge.svg\")
\n\n\n> A graph with circular dependencies. Blue has dependencies, green has no dependencies, and red has circular dependencies.\n\n\n ![\"graph-circular\"](\"http://pahen.github.io/madge/simple.svg\")
\n\n\n## See it in action\n\n\n ![\"in-action\"](\"https://asciinema.org/a/l9tM7lIraCpmzH0rdWw2KLrMc.png\")
\n\n\n# Installation\n\n```sh\nnpm -g install madge\n```\n\n## Graphviz (optional)\n\n> [Graphviz](http://www.graphviz.org/) is only required if you want to generate visual graphs (e.g. in SVG or DOT format).\n\n### Mac OS X\n\n```sh\nbrew install graphviz || port install graphviz\n```\n\n### Ubuntu\n\n```sh\napt-get install graphviz\n```\n\n# API\n\n## madge(path: string|array|object, config: object)\n\n> `path` is a single file or directory, or an array of files/directories to read. A predefined tree can also be passed in as an object.\n\n> `config` is optional and should be the [configuration](#configuration) to use.\n\n> Returns a `Promise` resolved with the Madge instance object.\n\n## Functions\n\n#### .obj()\n\n> Returns an `Object` with all dependencies.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js').then((res) => {\n\tconsole.log(res.obj());\n});\n```\n\n#### .warnings()\n\n> Returns an `Object` of warnings.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js').then((res) => {\n\tconsole.log(res.warnings());\n});\n```\n\n#### .circular()\n\n> Returns an `Array` of all modules that have circular dependencies.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js').then((res) => {\n\tconsole.log(res.circular());\n});\n```\n\n#### .circularGraph()\n\n> Returns an `Object` with only circular dependencies.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js').then((res) => {\n\tconsole.log(res.circularGraph());\n});\n```\n\n#### .depends()\n\n> Returns an `Array` of all modules that depend on a given module.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js').then((res) => {\n\tconsole.log(res.depends('lib/log.js'));\n});\n```\n\n#### .orphans()\n\n> Return an `Array` of all modules that no one is depending on.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js').then((res) => {\n\tconsole.log(res.orphans());\n});\n```\n\n#### .leaves()\n\n> Return an `Array` of all modules that have no dependencies.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js').then((res) => {\n\tconsole.log(res.leaves());\n});\n```\n\n#### .dot([circularOnly: boolean])\n\n> Returns a `Promise` resolved with a DOT representation of the module dependency graph. Set `circularOnly` to only include circular dependencies.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js')\n\t.then((res) => res.dot())\n\t.then((output) => {\n\t\tconsole.log(output);\n\t});\n```\n\n#### .image(imagePath: string, [circularOnly: boolean])\n\n> Write the graph as an image to the given image path. Set `circularOnly` to only include circular dependencies. The [image format](http://www.graphviz.org/content/output-formats) to use is determined from the file extension. Returns a `Promise` resolved with a full path to the written image.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js')\n\t.then((res) => res.image('path/to/image.svg'))\n\t.then((writtenImagePath) => {\n\t\tconsole.log('Image written to ' + writtenImagePath);\n\t});\n```\n\n#### .svg()\n\n> Return a `Promise` resolved with the XML SVG representation of the dependency graph as a `Buffer`.\n\n```javascript\nconst madge = require('madge');\n\nmadge('path/to/app.js')\n\t.then((res) => res.svg())\n\t.then((output) => {\n\t\tconsole.log(output.toString());\n\t});\n```\n\n# Configuration\n\nProperty | Type | Default | Description\n--- | --- | --- | ---\n`baseDir` | String | null | Base directory to use instead of the default\n`includeNpm` | Boolean | false | If shallow NPM modules should be included\n`fileExtensions` | Array | ['js'] | Valid file extensions used to find files in directories\n`excludeRegExp` | Array | false | An array of RegExp for excluding modules\n`requireConfig` | String | null | RequireJS config for resolving aliased modules\n`webpackConfig` | String | null | Webpack config for resolving aliased modules\n`tsConfig` | String\\|Object | null | TypeScript config for resolving aliased modules - Either a path to a tsconfig file or an object containing the config\n`layout` | String | dot | Layout to use in the graph\n`rankdir` | String | LR | Sets the [direction](https://graphviz.gitlab.io/_pages/doc/info/attrs.html#d:rankdir) of the graph layout\n`fontName` | String | Arial | Font name to use in the graph\n`fontSize` | String | 14px | Font size to use in the graph\n`backgroundColor` | String | #000000 | Background color for the graph\n`nodeShape` | String | box | A string specifying the [shape](https://graphviz.gitlab.io/_pages/doc/info/attrs.html#k:shape) of a node in the graph\n`nodeStyle` | String | rounded | A string specifying the [style](https://graphviz.gitlab.io/_pages/doc/info/attrs.html#k:style) of a node in the graph\n`nodeColor` | String | #c6c5fe | Default node color to use in the graph\n`noDependencyColor` | String | #cfffac | Color to use for nodes with no dependencies\n`cyclicNodeColor` | String | #ff6c60 | Color to use for circular dependencies\n`edgeColor` | String | #757575 | Edge color to use in the graph\n`graphVizOptions` | Object | false | Custom Graphviz [options](https://graphviz.gitlab.io/_pages/doc/info/attrs.html)\n`graphVizPath` | String | null | Custom Graphviz path\n`detectiveOptions` | Object | false | Custom `detective` options for [dependency-tree](https://github.com/dependents/node-dependency-tree) and [precinct](https://github.com/dependents/node-precinct#usage)\n`dependencyFilter` | Function | false | Function called with a dependency filepath (exclude subtrees by returning false)\n\nYou can use configuration file either in `.madgerc` in your project or home folder or directly in `package.json`. Look [here](https://github.com/dominictarr/rc#standards) for alternative locations for the file.\n\n> .madgerc\n\n```json\n{\n \"fontSize\": \"10px\",\n \"graphVizOptions\": {\n \"G\": {\n \"rankdir\": \"LR\"\n }\n }\n}\n```\n\n> package.json\n\n```json\n{\n \"name\": \"foo\",\n \"version\": \"0.0.1\",\n ...\n \"madge\": {\n \"fontSize\": \"10px\",\n \"graphVizOptions\": {\n \"G\": {\n \"rankdir\": \"LR\"\n }\n }\n }\n}\n```\n\n# CLI\n\n## Examples\n\n> List dependencies from a single file\n\n```sh\nmadge path/src/app.js\n```\n\n> List dependencies from multiple files\n\n```sh\nmadge path/src/foo.js path/src/bar.js\n```\n\n> List dependencies from all *.js files found in a directory\n\n```sh\nmadge path/src\n```\n\n> List dependencies from multiple directories\n\n```sh\nmadge path/src/foo path/src/bar\n```\n\n> List dependencies from all \\*.js and \\*.jsx files found in a directory\n\n```sh\nmadge --extensions js,jsx path/src\n```\n\n> Finding circular dependencies\n\n```sh\nmadge --circular path/src/app.js\n```\n\n> Show modules that depends on a given module\n\n```sh\nmadge --depends wheels.js path/src/app.js\n```\n\n> Show modules that no one is depending on\n\n```sh\nmadge --orphans path/src/\n```\n\n> Show modules that have no dependencies\n\n```sh\nmadge --leaves path/src/\n```\n\n> Excluding modules\n\n```sh\nmadge --exclude '^(foo|bar)\\.js$' path/src/app.js\n```\n\n> Save graph as a SVG image (requires [Graphviz](#graphviz-optional))\n\n```sh\nmadge --image graph.svg path/src/app.js\n```\n\n> Save graph with only circular dependencies\n\n```sh\nmadge --circular --image graph.svg path/src/app.js\n```\n\n> Save graph as a [DOT](http://en.wikipedia.org/wiki/DOT_language) file for further processing (requires [Graphviz](#graphviz-optional))\n\n```sh\nmadge --dot path/src/app.js > graph.gv\n```\n\n> Using pipe to transform tree (this example will uppercase all paths)\n\n```sh\nmadge --json path/src/app.js | tr '[a-z]' '[A-Z]' | madge --stdin\n```\n\n# Debugging\n\n> To enable debugging output if you encounter problems, run madge with the `--debug` option then throw the result in a gist when creating issues on GitHub.\n\n```sh\nmadge --debug path/src/app.js\n```\n\n# Running tests\n\n```sh\nnpm install\nnpm test\n```\n\n# Creating a release\n\n```sh\nnpm run release\n```\n\n# FAQ\n\n## Missing dependencies?\n\nIt could happen that the files you're not seeing have been skipped due to errors or that they can't be resolved. Run madge with the `--warning` option to see skipped files. If you need even more info run with the `--debug` option.\n\n## Using both Javascript and Typescript in your project?\n\nMadge uses [dependency-tree](https://www.npmjs.com/package/dependency-tree) which uses [filing-cabinet](https://www.npmjs.com/package/filing-cabinet) to resolve modules. However it requires configurations for each file type (js/jsx) and (ts/tsx). So provide both `webpackConfig` and `tsConfig` options to madge.\n\n## Using mixed import syntax in the same file?\n\nOnly one syntax is used by default. You can use both though if you're willing to take the degraded performance. Put this in your madge config to enable mixed imports.\n\nFor ES6 + CommonJS:\n\n```json\n{\n \"detectiveOptions\": {\n \"es6\": {\n \"mixedImports\": true\n }\n }\n}\n```\n\nFor TypeScript + CommonJS:\n\n```json\n{\n \"detectiveOptions\": {\n \"ts\": {\n \"mixedImports\": true\n }\n }\n}\n```\n\n## How to ignore `import type` statements in ES6 + Flow?\n\nPut this in your madge config.\n\n```json\n{\n \"detectiveOptions\": {\n \"es6\": {\n \"skipTypeImports\": true\n }\n }\n}\n```\n\n## How to ignore `import` in type annotations in TypeScript?\n\nPut this in your madge config.\n\n```json\n{\n \"detectiveOptions\": {\n \"ts\": {\n \"skipTypeImports\": true\n }\n }\n}\n```\n\n## How to ignore dynamic imports in Typescript?\n\nPut this in your madge config.\n\n```json\n{\n \"detectiveOptions\": {\n \"ts\": {\n \"skipAsyncImports\": true\n },\n \"tsx\": {\n \"skipAsyncImports\": true\n }\n }\n}\n```\n\nNote: `tsx` is optional, use this when working with JSX.\n\n## Mixing TypesScript and Javascript imports?\n\nEnsure you have this in your `.tsconfig` file.\n\n```json\n{\n \"compilerOptions\": {\n \"module\": \"commonjs\",\n \"allowJs\": true\n }\n}\n```\n\n## What's the \"Error: write EPIPE\" when exporting graph to image?\n\nEnsure you have [installed Graphviz](#graphviz-optional). If you're running Windows, note that Graphviz is not added to the `PATH` variable during install. You should add the folder of `gvpr.exe` (typically `%Graphviz_folder%/bin`) to the `PATH` variable manually.\n\n## How do I fix the \"Graphviz not built with triangulation library\" error when using sfdp layout?\n\nHomebrew doesn't include GTS by default. Fix this by doing:\n\n```sh\nbrew uninstall graphviz\nbrew install gts\nbrew install graphviz\n```\n\n## The image produced by madge is very hard to read, what's wrong?\n\nTry running madge with a different layout, here's a list of the ones you can try:\n\n* **dot** \"hierarchical\" or layered drawings of directed graphs. This is the default tool to use if edges have directionality.\n\n* **neato** \"spring model'' layouts. This is the default tool to use if the graph is not too large (about 100 nodes) and you don't know anything else about it. Neato attempts to\nminimize a global energy function, which is equivalent to statistical multi-dimensional scaling.\n\n* **fdp** \"spring model'' layouts similar to those of neato, but does this by reducing forces rather than working with energy.\n\n* **sfdp** multiscale version of fdp for the layout of large graphs.\n\n* **twopi** radial layouts, after Graham Wills 97. Nodes are placed on concentric circles depending their distance from a given root node.\n\n* **circo** circular layout, after Six and Tollis 99, Kauffman and Wiese 02. This is suitable for certain diagrams of multiple cyclic structures, such as certain telecommunications networks.\n\n# Credits\n\n## Contributors\n\nThis project exists thanks to all the people who contribute.\n\n ![\"Contributors\"/](\"https://opencollective.com/madge/contributors.svg?width=890&button=false\")
\n\n\n## Donations â¤ď¸\n\nThanks to the awesome people below for making donations! đ[Donate](https://paypal.me/pahen)\n\n\n \n Bernard StojanoviÄ (24 Mars, 2021)\n ![\"BeroBurny\"](\"https://github.com/BeroBurny.png\")
\n \n
\n \n Ole Jørgen Brønner (Oct 8, 2020)\n ![\"olejorgenb\"](\"https://github.com/olejorgenb.png\")
\n \n
\n \n RxDB (Apr 1, 2020)\n ![\"RxDB\"](\"https://cdn.rawgit.com/pubkey/rxdb/ba7c9b80/docs/files/logo/logo_text.svg\"){kind=logo}
\n \n
![\"Last](\"https://img.shields.io/github/tag/pahen/madge.svg?style=flat-square\")
\n ![](\"http://img.shields.io/npm/dm/madge.svg?style=flat-square\")
\n ![\"Donate\"](\"https://img.shields.io/badge/donate-paypal-blue.svg?style=flat-square\"){kind=icon}
\n ![\"Ziriax\"](\"https://github.com/Ziriax.png\")
\n ![\"landonalder\"](\"https://github.com/landonalder.png\")
\n