Skip to main content

​
Analyze Command

The default npx depfixer command runs a smart analysis that scans your project and offers to fix any issues found.

​
Usage

npx depfixer [options]

​
Options

OptionDescription
--path <dir>Project directory (default: current)
--jsonOutput as JSON
--ciCI mode with exit codes

​
How It Works

​
1. Free Audit

First, DepFixer performs a free audit showing your health score and issues: 
📊 ANALYSIS REPORT
──────────────────────────────────────────────────
🏥 Health:  [████████░░] 72/100 (WARNING)
⚠️  Issues:  10 Conflicts Found

SEVERITY BREAKDOWN
--------------------------------------------------
  CRITICAL   1 issue require attention
  HIGH       3 issues with compatibility problems
  MEDIUM     2 issues with version conflicts
  LOW        4 issues to review
    + 2 missing peer dependencies to install.
    Unlock to see details and recommended fixes.

💡 DIAGNOSIS:
    Deep dependency graph conflicts detected.
    Manual resolution is likely to fail.

🔒 SOLUTION:
    ✓ Deterministic fix calculated.
    [?] Unlock recommended versions?

​
2. Unlock Prompt

A cost box shows the credit cost: 
+--------------------------------------------------+
|                                                  |
|  COST TO ANALYZE:   15 CREDITS                   |
|  PLAN SIZE:         Tier: Small                  |
|                                                  |
+--------------------------------------------------+

​
3. Full Solution (After Payment)

Once paid, you see the complete fix with recommended versions: 
🔓 FULL ANALYSIS
──────────────────────────────────────────────────

PACKAGE                            CURRENT       TARGET        TYPE
---------------------------------------------------------------------------
@angular/core                      16.0.0        17.3.0        Major
@angular/cli                       16.0.0        17.3.0        Major
typescript                         4.9.5         5.4.5         Major
rxjs                               7.5.0         7.8.1         Minor
---------------------------------------------------------------------------
eslint                             -             8.57.0        Add

⚙️  Engine Requirements:
   • Node.js: >=18.13.0

📦 Packages to Add:
   + eslint
     Required as peer dependency by eslint-config-next (^8.0.0)

​
Issue Types Detected

TypeDescription
Peer Dependency ConflictPackage requires a different version of another package
Missing Peer DependencyRequired peer dependency not installed
Version MismatchPackages in same ecosystem have incompatible versions
Deprecated PackagePackage is deprecated, replacement available
Framework IncompatibilityPackage version incompatible with your framework

​
JSON Output

npx depfixer --json

{
  "mode": "audit",
  "analysisId": "abc123",
  "healthScore": 72,
  "totalPackages": 45,
  "summary": {
    "critical": 1,
    "high": 3,
    "medium": 2,
    "low": 4
  },
  "issueCount": 10,
  "conflicts": [...],
  "framework": { "name": "angular", "version": "16.0.0" },
  "cost": 15,
  "tierName": "Small"
}

​
CI Mode

npx depfixer --ci
Requires DEPFIXER_TOKEN environment variable: 
  CI Mode - Dependency Analysis
  ────────────────────────────────────────
  Health Score: 72/100
  Total Packages: 45
  Issues Found: 10
    Critical: 1
    High: 3
    Medium: 2
    Low: 4

  Pipeline should fail - critical/high issues detected
Exit codes:
  • 0 - No critical/high issues
  • 1 - Critical or high issues found
  • 2 - Error (auth, network)

​
Audit vs Full Mode

FeatureAudit (Free)Full (Paid)
Health score✓✓
Issue count✓✓
Severity breakdown✓✓
Package namesLimited✓
Recommended versions✗✓
Apply fixes✗✓