Skip to main content

Quickstart

Prerequisites

  • Node.js 18 or higher
  • A JavaScript/TypeScript project with a package.json

Installation

Option 1: Use npx (no install)

npx depfixer

Option 2: Install globally

npm install -g depfixer
Then run:
depfixer

Step 1: Run DepFixer

Open your terminal in your project directory and run depfixer (or npx depfixer).

Step 2: Review the Analysis

DepFixer will display the ASCII logo and scan your dependencies:
  ██████╗  ███████╗ ██████╗ ███████╗██╗██╗  ██╗███████╗██████╗
  ██╔══██╗ ██╔════╝ ██╔══██╗██╔════╝██║╚██╗██╔╝██╔════╝██╔══██╗
  ██║  ██║ █████╗   ██████╔╝█████╗  ██║ ╚███╔╝ █████╗  ██████╔╝
  ██║  ██║ ██╔══╝   ██╔═══╝ ██╔══╝  ██║ ██╔██╗ ██╔══╝  ██╔══██╗
  ██████╔╝ ███████╗ ██║     ██║     ██║██╔╝ ██╗███████╗██║  ██║
  ╚═════╝  ╚══════╝ ╚═╝     ╚═╝     ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
           Dependency Hell? We've Got the Cure.

⚡ DepFixer CLI v1.0.0
──────────────────────────────────────────────────

📦 PROJECT: my-angular-app
   Framework: Angular

✓ Analysis complete

📊 ANALYSIS REPORT
──────────────────────────────────────────────────
🏥 Health:  [████████░░] 72/100 (WARNING)
⚠️  Issues:  10 Conflicts Found

Step 3: Review Issues

For smaller issue counts, you’ll see a severity breakdown:
SEVERITY BREAKDOWN
--------------------------------------------------
  CRITICAL   1 issue require attention
  HIGH       3 issues with compatibility problems
  MEDIUM     2 issues with version conflicts
  LOW        4 issues to review
    Unlock to see details and recommended fixes.

Step 4: Unlock Solutions

If issues are found, you’ll see a cost box:
+--------------------------------------------------+
|                                                  |
|  COST TO ANALYZE:   15 CREDITS                   |
|  PLAN SIZE:         Tier: Small                  |
|                                                  |
+--------------------------------------------------+
[?] Continue to login? (Enter/Esc)
Press Enter to proceed.

Step 5: Authenticate

First-time users will see the device code flow:
🔐 DEVICE CODE LOGIN
──────────────────────────────────────────────────

    Your verification code:

          ABCD-1234

    Opening browser to complete login...
    Waiting for authorization...
Enter the code in your browser to authenticate.

Step 6: Apply Fixes

Once authenticated with sufficient credits, you’ll see the full solution:
🔓 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

────────────────────────────────────────
  📝 Only package.json will be modified
  💾 A backup (package.json.bak) will be created
────────────────────────────────────────

Apply fix to package.json? (Enter/Esc)
Press Enter to apply.

Step 7: Done!

✨ SUCCESS
──────────────────────────────────────────────────

    ✓ 4 Packages Updated
    ✓ Backup: package.json.bak

    👉 NEXT STEP:
    Run the following command to finalize changes:

    $ npm install
Run npm install to install the updated dependencies.