Peer Dependency Helper
Audit and fix peer dependency issues with ease
Audit and fix peer dependency issues with ease
Install and start using Peer Dependency Helper in seconds:
npm install -g peer-dep-helper# Audit peer dependencies
peer-dep-helper audit
# Fix peer dependency issues
peer-dep-helper fix
# Check version
peer-dep-helper --versionPeer Dependency Helper is a powerful CLI tool designed to solve one of the most frustrating problems in Node.js development: peer dependency issues.
Peer dependencies are dependencies that your package expects to be installed by the consuming application. When they're missing, outdated, or conflicting, you get:
Peer Dependency Helper automatically:
See how Peer Dependency Helper stands out from other approaches and tools:
Automated detection and fixing saves hours of manual work
Intelligent version resolution prevents compatibility issues
Catch issues before they reach production or break builds
Beautiful, customizable output makes dependency management enjoyable
Peer Dependency Helper is designed to complement security tools like npm audit, yarn audit, and pnpm audit. While those tools focus on security vulnerabilities, Peer Dependency Helper specializes in dependency compatibility and structure issues. Use both for comprehensive dependency management!
Analyzes your package.json files, node_modules, and workspace configurations to understand your dependency structure.
Identifies missing peer dependencies, version conflicts, and outdated packages that could cause problems.
Offers intelligent fixes with proper version resolution, considering compatibility across all your packages.
Automatically installs missing dependencies and updates package.json files to resolve conflicts.
Stop wasting hours debugging peer dependency issues. Get instant, accurate diagnosis and fixes.
Catch dependency issues before they reach production. Ensure your builds and deployments succeed.
Compatible with npm, yarn, and pnpm. Supports monorepos, workspaces, and complex project structures.
Beautiful, customizable CLI output with themes, emojis, and helpful tips. Makes dependency management enjoyable.
JSON output, exit codes, and configurable behavior make it perfect for automated workflows and CI/CD pipelines.
25+ themes, config files, environment variables, and CLI flags let you tailor the experience to your needs.
Detect missing, outdated, and conflicting peer dependencies across your entire project
Fix common peer dependency issues with intelligent suggestions and automated resolution
25+ beautiful themes with customizable colors, box styles, and emoji support
Smart caching and efficient algorithms for fast scanning of large projects
Built for complex projects with multiple packages, workspaces, and nested dependencies
Customize behavior with config files, environment variables, and CLI flags
Customize the look and feel with 25+ beautiful themes:
Our signature theme with modern cyan & magenta colors, round boxes, and a friendly vibe!
--theme peerdephelper
Clean and modern with cyan and green accents
--theme default
Classic dark theme with blue and cyan accents
--theme dark
Clean light theme with blue and gray
--theme light
Minimalist output with no emojis
--theme minimal
Vibrant rainbow colors with emojis
--theme colorful
Monokai-inspired with bold boxes
--theme monokai
GitHub dark theme with double boxes
--theme githubdark
GitHub light theme with single boxes
--theme githublight
Nature-inspired green and brown
--theme forest
Rose-pine color palette
--theme rosepine
Night Owl theme with double boxes
--theme nightowl
Playful theme with arrow boxes
--theme playful
Professional corporate theme
--theme corporate
Dark and elegant with magenta and yellow
--theme dracula
Classic terminal green with no emoji
--theme matrix
Soft and friendly with blue and magenta
--theme pastel
Warm and vibrant with red and yellow
--theme sunset
Cool and calming with cyan and blue
--theme ocean
Bright and futuristic with green and cyan
--theme neon
Traditional terminal style with no emoji
--theme classic
Colorful and playful with magenta and cyan
--theme rainbow
Arctic, icy blue and gray inspired by Nord theme
--theme nord
Warm retro orange, yellow, and brown (Gruvbox)
--theme gruvbox
Solarized dark: blue, cyan, yellow, base03
--theme solarizeddark
Solarized light: base3, yellow, blue, cyan
--theme solarizedlight
Ayu dark: orange, yellow, gray
--theme ayudark
Ayu light: light yellow, blue, gray
--theme ayulight
Catppuccin: mauve, peach, teal, latte
--theme catppuccin
One Dark: blue, cyan, magenta, gray
--theme onedark
Dracula Pro: pink, purple, cyan, yellow
--theme draculapro
Arc Dark: blue, teal, gray
--theme arcdark
Everforest: green, brown, yellow
--theme everforest
Material: blue, teal, orange
--theme material
High contrast: black, white, yellow
--theme highcontrast
Retro terminal: yellow, green, classic boxes, no emoji
--theme retro
Elegant: white, gray, single-double boxes, no emoji
--theme elegant
Choose from multiple box border styles to customize your CLI output:
Default style with smooth rounded corners
Clean single-line border style
Elegant double-line border style
Strong, prominent border style
Traditional terminal ASCII boxes
Mixed single and double borders
Reverse mixed border style
Dynamic arrow-style borders
Explore and customize themes with these powerful commands:
peer-dep-helper theme list
View all available theme presets with descriptions
peer-dep-helper theme preview dark
See how a specific theme looks before using it
peer-dep-helper audit --theme peerdephelper
Apply a theme to any command
peer-dep-helper audit --theme dark --box-style bold
Override the theme's default box style
peer-dep-helper audit --theme colorful --no-emojis
Use a theme without emoji icons
peer-dep-helper audit --theme dark --minimal
Get clean, minimal output for CI/CD
Set your default theme preferences in a configuration file:
{
"theme": "peerdephelper",
"primaryColor": "cyan",
"secondaryColor": "magenta",
"boxStyle": "round",
"useEmojis": true,
"minimal": false
}See Peer Dependency Helper in action with real examples:
Check for peer dependency issues in your project:
peer-dep-helper audit╭────────────────────────────────────────────────────╮
│ │
│ ┌───────────────────────────────┐ │
│ │ │ │
│ │ 🔍 Peer Dependency Helper │ │
│ │ │ │
│ └───────────────────────────────┘ │
│ Audit and fix peer dependency issues with ease │
│ │
╰────────────────────────────────────────────────────╯
✔ ✅ Scan complete!
┌─────────────────────┐
│ │
│ 📊 Audit Report │
│ │
└─────────────────────┘
❌ Found 2 peer dependency issues:
┌─────────────────────────────────────────────────┐
│ │
│ 🚨 Missing Peer Dependencies │
│ │
└─────────────────────────────────────────────────┘
• react@^18.0.0 (required by @emotion/react@11.11.0)
• react-dom@^18.0.0 (required by @emotion/react@11.11.0)
┌─────────────────────────────────────────────────┐
│ │
│ 🔧 Fix Suggestions │
│ │
└─────────────────────────────────────────────────┘
Run: peer-dep-helper fixAutomatically install missing peer dependencies:
peer-dep-helper fix🔧 Installing 2 packages...
📦 Installing react@^18.0.0
📦 Installing react-dom@^18.0.0
✅ Fixes applied successfully!
🔄 Re-auditing to verify fixes...
✅ All peer dependencies are valid!
┌─────────────────────────────────────────┐
│ │
│ 🎉 All issues resolved successfully! │
│ │
└─────────────────────────────────────────┘Use beautiful themes to customize your CLI experience:
peer-dep-helper audit --theme-preset dracula┌─────────────────────────────────────────────────┐
│ │
│ 🔍 Peer Dependency Helper │
│ │
└─────────────────────────────────────────────────┘
📊 Audit Report
✅ No peer dependency issues found.
🎉 Your project is in perfect shape!Get structured output for automated workflows:
peer-dep-helper audit --json{
"issues": [
{
"package": "react",
"status": "missing",
"requiredBy": "my-component-library",
"requiredVersion": "^18.0.0",
"installedVersion": null,
"latestVersion": "18.2.0"
}
],
"summary": {
"total": 1,
"missing": 1,
"outdated": 0,
"valid": 0
}
}