![Deptrack Logo](https://deptrack.netlify.app/dep_track_logo.png)

**Visualize why a dependency is in your Node.js project**  

[![License](https://img.shields.io/npm/l/deptrack)](LICENSE)
[![npm](https://img.shields.io/npm/v/deptrack)](https://npmjs.com/package/deptrack)
<!-- ![CI](https://github.com/yourusername/deptrack/actions/workflows/test.yml/badge.svg) -->

Tired of digging through `npm explain` or `yarn why`? **DepTrack** generates an interactive dependency tree to show:  
- **Why** a package is installed  
- **Which** parent dependencies brought it in  
- **How** versions were resolved  

## Get Started
```bash
npx deptrack <package-name>  # Try it now!
```


## Anatomy of the report
![Demo GIF](https://deptrack.netlify.app/depchain_demo.png)


## Why DepTrack?  
🔍 **Debug faster** – No more guessing why `left-pad` is in your `node_modules`.  
🌳 **Visual tree** – Understand complex dependency chains at a glance.  
⚡ **Zero-config** – Works locally without external servers.  

## Usage  
1. Run in any Node.js project:  
   ```bash
   npx deptrack <package-name> # replace <package-name> with the package you are trying to analyze
   ```  
2. Opens the report in your browser.  

<!-- ### Flags  
| Flag           | Description                     |  
|----------------|---------------------------------|  
| `--depth=5`    | Limit tree depth (default: ∞)   |  
| `--dev`        | Include devDependencies         |   -->

## Use Cases  
- 🛡️ Audit security vulnerabilities  
- 📦 Reduce bundle size by finding unnecessary deps  
- 🧠 Learn how your dependency graph works  

<!-- ## Roadmap  
- [ ] Support for `pnpm` and `bun`  
- [ ] GitHub Action for CI/CD dependency checks   -->

<!-- ## Contributing  
PRs welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).   -->

---
📜 **License**: MIT

made with ♥️ by [appsparklers](https://www.appsparklers.com)
<!-- 🐛 **Report Issues**: [GitHub Issues](https://github.com/yourusername/deptrack/issues)  
✨ **Star This Project**: [![GitHub Stars](https://img.shields.io/github/stars/yourusername/deptrack?style=social)](https://github.com/yourusername/deptrack) -->