Skip to main content
Generate an interactive visualization of your codebase. fallow viz runs the analysis once and writes a single self-contained HTML file (no server, no external assets) that you can open in any browser or share. 
fallow viz
The HTML opens in your browser automatically. It has two linked views:
  • Treemap: every file as a box sized by its byte count and colored by status (entry point, clean, has unused exports, fully unused). Click a directory to drill in; the breadcrumb walks back out.
  • Graph: a force-directed import graph with directory or import-community clustering. Drag nodes to reposition them, scroll to zoom, drag the background to pan, and hover a node to highlight its neighborhood.
Both views support search, filters, dark mode, and keyboard navigation.

​
Options

FlagDescription
--out <PATH>Write the output to this path (default: fallow-viz.html in the project root)
--no-openDo not open the output in the browser after writing it
--viz-format <FORMAT>Output format: html (default), dot (Graphviz), mermaid
fallow viz also respects the global flags --production, --config, --no-cache, --root, and --threads. It is read-only and never modifies your project.

​
Examples

# Open an interactive visualization in your browser
fallow viz

# Write to a specific path without opening it
fallow viz --out docs/codebase.html --no-open
The HTML is a single self-contained file with the analysis data embedded inline, so you can commit it, attach it to a PR, or open it offline. Nothing is uploaded.