flutter_upgradex 0.1.1

Upgrade Flutter dependencies one by one — safely. Runs flutter analyze after each upgrade and auto-rolls back anything that breaks.

flutter_upgradex

Upgrade your Flutter dependencies one by one — safely.

No guesswork. No broken builds.
Just run flutter upgradex and let every dependency upgrade itself — safely.

---

Why flutter_upgradex?

flutter pub upgrade upgrades everything at once. When something breaks, you have no idea which package caused it.

flutter_upgradex does it one at a time:

✦ Upgrades each dependency individually — pinpoints exactly what breaks
✦ Skips packages already on the latest version — no unnecessary work
✦ Runs flutter analyze after every upgrade — catches issues immediately
✦ Auto-rollback — broken packages revert to their original version
✦ Failure log — every rollback is recorded with the error that caused it
✦ FVM aware — works with flutter or fvm flutter automatically
✦ Zero config — install once, run from any Flutter project

---

Installation

dart pub global activate flutter_upgradex

That's it. No config files, no project setup.

---

Usage

flutter_upgradex

Run it from the root of your Flutter project. It walks through every dependency automatically:

  ╔══════════════════════════════════════════╗
  ║          🔼  flutter upgradex            ║
  ╚══════════════════════════════════════════╝

  ── Upgrading dependencies ─────────────────

  [1/4] dio
        ^4.0.6 → ^5.7.0
        Running flutter analyze... ✅ kept

  [2/4] go_router
        already latest (^14.6.3)

  [3/4] some_package
        ^1.9.4 → ^2.1.0
        Running flutter analyze... ❌ failed
        Rolling back to ^1.9.4

  [4/4] flutter_bloc
        ^8.1.6 → ^9.1.0
        Running flutter analyze... ✅ kept

  ── Done ───────────────────────────────────

  2 upgraded   1 rolled back   1 already latest

  See flutter_upgradex_logs.txt for rollback details.

---

What it covers

Scope	Upgraded?
dependencies	✅
dev_dependencies	✅
Transitive / overrides	Planned for a future release

---

Output

After a run you'll have:

File	What it contains
pubspec.yaml	All safe upgrades applied, broken ones reverted
flutter_upgradex_logs.txt	Created only if ≥1 package failed — package name + error

---

How It Works

you run: flutter_upgradex
         └── reads your pubspec.yaml
                  └── detects fvm (.fvmrc / .fvm) → uses fvm flutter, otherwise flutter
                           └── for each dependency:
                                    └── fetches latest version from pub.dev
                                             ├── already latest → skip ⏭️
                                             └── new version available:
                                                      └── writes new version constraint
                                                               └── runs flutter analyze
                                                                        ├── passes → keep ✅
                                                                        └── fails  → rollback + log ❌

dart pub global activate places the flutter_upgradex binary on your PATH. Run it directly — no shell tricks, no aliases needed. FVM is auto-detected from your project directory.

---

Requirements

• Dart SDK >=3.0.0
• Flutter installed — flutter or fvm flutter (auto-detected)
• A valid pubspec.yaml in the current directory

---

Note

flutter analyze catches static analysis errors only. A package that passes may still affect runtime behaviour or tests — review your upgrades before shipping.

---

Contributing

Contributions are welcome! Please make sure your commits follow the conventional commits format.

---

Made with 🎯 by @moulibheemaneti
MIT License