Skip to main content

Migrate Command

The migrate command helps you upgrade your framework (Angular, React, Vue) to a newer version with automatic dependency alignment.

Usage

npx depfixer migrate [options]

Options

OptionDescription
--path <dir>Project directory (default: current)

How It Works

1. Framework Detection

DepFixer automatically detects your framework:
  ██████╗  ███████╗ ██████╗ ███████╗██╗██╗  ██╗███████╗██████╗
  ██╔══██╗ ██╔════╝ ██╔══██╗██╔════╝██║╚██╗██╔╝██╔════╝██╔══██╗
  ██║  ██║ █████╗   ██████╔╝█████╗  ██║ ╚███╔╝ █████╗  ██████╔╝
  ██║  ██║ ██╔══╝   ██╔═══╝ ██╔══╝  ██║ ██╔██╗ ██╔══╝  ██╔══██╗
  ██████╔╝ ███████╗ ██║     ██║     ██║██╔╝ ██╗███████╗██║  ██║
  ╚═════╝  ╚══════╝ ╚═╝     ╚═╝     ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
           Upgrade Fearlessly. We Handle the Rest.

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

📦 PROJECT: my-angular-app
   Framework: Angular 16.0.0

Fetching available versions...

2. Version Selection

Use arrow keys to select your target version:
Select target version:

    Angular 19 (Latest)
      -> 19.0.0 - Latest stable

  > Angular 18 (LTS)
      -> 18.2.0 - Long-term support

    Angular 17
      -> 17.3.0 - Stable

Up/Down Navigate  Enter Select  Esc Cancel

3. Migration Plan

Review what will change:
🚀 MIGRATION PLAN: Angular 16 → 18
──────────────────────────────────────────────────

📊 Projection:
    • Health:     65/100 → 95/100 (Estimated)
    • Packages:   12 updates
    • Breaking:   ⚠️  2 Major Changes

PACKAGE                            CURRENT       TARGET        TYPE
---------------------------------------------------------------------------
@angular/core                      16.0.0        18.2.0        Major
@angular/cli                       16.0.0        18.2.0        Major
@angular/compiler                  16.0.0        18.2.0        Major
typescript                         4.9.5         5.4.5         Major
zone.js                            0.13.0        0.14.0        Minor
rxjs                               7.5.0         7.8.1         Patch

+--------------------------------------------------+
|                                                  |
|  MIGRATION COST:   35 CREDITS                    |
|  PLAN SIZE:        Tier: Standard                |
|                                                  |
+--------------------------------------------------+

4. Apply Migration

After confirmation and payment:
✨ SUCCESS
──────────────────────────────────────────────────

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

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

    $ npm install

Supported Migrations

Angular

FromToNotes
12.x15-19Multi-version jump supported
13.x16-19TypeScript upgrade included
14.x17-19Standalone components available
15.x18-19Signals API available
16.x18-19Control flow syntax
17.x18-19Latest features

React

FromToNotes
16.x17-19Concurrent mode available
17.x18-19Automatic batching
18.x19React Compiler ready

Vue

FromToNotes
2.x3.xComposition API, major rewrite
3.03.4+Script setup, improved reactivity

What Gets Updated

The migrate command updates:
  • Core framework packages - Main framework and related packages
  • TypeScript - Version compatible with target framework
  • Build tools - CLI, webpack plugins, etc.
  • Ecosystem packages - Router, state management, UI libraries
  • Type definitions - @types/* packages

Migration vs Analyze

FeatureAnalyzeMigrate
Fix current issuesYesNo
Upgrade frameworkNoYes
Version selectionNoYes
Multi-version jumpNoYes
Tip: Run npx depfixer (analyze) first to fix current issues, then use migrate to upgrade your framework version.