pnpm-viz

Visual companion for pnpm

pnpm-viz parses your pnpm-lock.yaml and pnpm-workspace.yaml to generate interactive dependency graphs, version conflict heatmaps, and workspace flow diagrams.

Features

• Interactive CLI: View workspace structure and duplicate stats directly in your terminal.
• Heatmap Analysis: Identify duplicate packages and potential version conflicts.
• Web Dashboard: Explore your dependency graph interactively in the browser.
• Export: Export your dependency graph to JSON for further analysis.

Installation

npm install -g pnpm-viz
# OR run directly
npx pnpm-viz

Usage

CLI Overview

Run in your project root:

pnpm-viz .

Heatmap Mode

View duplicate packages in the terminal:

pnpm-viz . --heatmap

Web Dashboard

Launch the interactive web visualization:

pnpm-viz serve

Export Data

Export the parsed graph to JSON:

pnpm-viz export . -o graph.json

Development

1. Clone the repo.
2. Install dependencies: npm install
3. Build the project: npm run build
4. Run locally: node dist/cli/index.js .

Publishing

To publish a new version to npm:

1. Login to npm (if not already logged in):

   npm login

2. Bump the version:

   npm version patch # or minor, major

3. Publish:

   npm publish

   (This will automatically run npm run build before publishing)

License

MIT