# 📦 MigratorX – The Futuristic Framework Migration Engine 🚀

Upgrade Angular projects across versions **safely, automatically and with maximum transparency**

Migrating large Angular projects is time-consuming and risky — breaking changes, deprecated modules, Protractor removal, Ivy migration leftovers, RxJS updates, tsconfig changes, and unexpected build failures.

---

## 🚀 Installation

### Option 1: Run via `npx` (recommended)
You don’t need to install it globally if you use `npx`.

```bash
npx migratorx
```

### Option 2: Run via `npm`
```bash
npm install -g migratorx
```


---


## 🚀 Quick Start

Inside any Angular project (v10+):
```bash
npx migratorx
```

---

## 📌 Example Migration (Angular 11 → 18)

```bash
npx migratorx
```

---

## 🧠 What MigratorX Automates

| Category | Included |
|---------|---------|
| Update Angular packages | ✔ |
| Run CLI migrations (`ng update`) | ✔ (with confirmation) |
| Apply code-level autofixes | ✔ |
| Detect deprecated APIs | ✔ |
| Generate migration logs | ✔ |
| Modify TypeScript configs | ✔ |

MigratorX never performs an irreversible action without your confirmation.
## 🔧 Supported Code Autofixes

| Autofix | Angular version range |
|--------|------------------------|
| Remove `entryComponents` | 8 → 9+ |
| Replace `HttpModule` with `HttpClientModule` | 4 → 5+ |
| Add missing generics to `ModuleWithProviders` | 9 → 10+ |
| Modernize TS target in `tsconfig` | 16+ |
| Remove IE11 config from `browserslist` | 12+ |

> More autofixes will be added for each major Angular release.
## 🗺 Roadmap

| Version | Goal |
|--------|------|
| v1.x | Full Angular migration automation |
| v2.x | Preview mode + rollback support |
| v3.x | React / Next.js / Vue migration support |
| v4.x | Migration dashboard + PDF/HTML reports |

## ❤️ Final Note

MigratorX was created to eliminate the pain and fear of framework upgrades.
If this tool helped you — star ⭐ the repo and share it with your team!

Happy upgrading! ⚡

## 🤝 Contributing

Contributions are welcome!  
If you encounter an issue or want to request a feature:

➡ https://github.com/prashantd-17/MigratorX

To contribute:
1. Fork repo
2. Create feature branch
3. Submit PR with detailed explanation