dependency-smell-reporter/README.md

A CLI tool that detects unused, outdated, and missing dependencies with reporting.

# 🧠 Dependency Smell Reporter

A minimal, effective CLI tool to analyze your project dependencies and catch common "dependency smells":

- 🚫 Unused dependencies
- ❌ Missing packages
- 📉 Outdated versions
- 📦 Node modules size
- 📚 Dependency overuse warning

Ideal for developers who want to keep their codebase clean and production-ready.

---


## 📦 Installation

Install globally:

npm install -g dependency-smell-reporter

Use with npx (no global install):

npx dependency-smell-reporter


🚀 Usage ->
Run it inside any Node.js project:

dsr

Or:

npx dependency-smell-reporter


🧪 Example Output

🔍 Running Dependency Smell Reporter...

🛠 Analyzing path: /your/project/path

⚠️ Unused Dependencies
- axios
- chalk

📉 Outdated Dependencies
- lodash

📦 Node_modules size: 41.84 MB
📚 Total Dependencies in use: 12

📊 Summary:
- 2 unused dependencies
- 1 outdated
- 0 missing

✅ Dependency Smell Check Complete!
📝 Log saved to dependency-smell-log.json



🔧 Features ->

Detects unused dependencies using depcheck

Checks for outdated versions using npm-check-updates

Reports missing packages

Calculates node_modules size

Warns if dependency count or size is high

Automatically writes a dependency-smell-log.json file

🤝 Why Use This?
✅ Keep your project clean
✅ Reduce bloat and build size
✅ Improve performance and maintainability
✅ Impress reviewers during code audits and interviews

👨‍💻 Author
Mihir 
Built with Node.js, powered by open-source tools like depcheck, npm-check-updates, and fast-folder-size.

📜 License
MIT