Flutter Gradle Doctor #

A CLI tool to automatically fix common Gradle & Android Gradle Plugin (AGP) issues in Flutter projects, especially when using Java versions 8–24.

Features #

• 🔍 Detects your Java version and required Gradle version.
• 🛠 Checks & fixes Gradle/AGP issues automatically.
• 💾 Creates .bak backups before modifying.
• 🔄 Optional flutter clean && pub get.
• 🧹 Cleanup and restore commands.

📦 Installation #

Add this to your dev_dependencies in pubspec.yaml:

dev_dependencies:
  flutter_gradle_doctor: ^0.0.1

Then run: dart pub get

🚀 Usage Run from your Flutter project root:

Check the project #

dart run gradle_doctor check

Fix Gradle & AGP issues #

dart run gradle_doctor fix

Cleanup old backups #

dart run gradle_doctor cleanup

Restore files from backups #

dart run gradle_doctor restore

⚠️ Notes Supports Java versions 8–24. Versions 25+ are not officially supported.

.bak backups are created before any modification.

If unexpected issues occur, run restore to revert changes.

🌟 Coming Soon: Flutter Gradle Doctor Pro #

Looking for a one-click solution to fix all Gradle & AGP issues without touching the command line?
Flutter Gradle Doctor Pro will include:

• ✅ Beautiful Desktop GUI (Windows, macOS, Linux)
• ✅ Drag & Drop your Flutter project folders
• ✅ One-click Fix for all Gradle & AGP problems
• ✅ Detailed visual reports and logs
• ✅ Auto-update

💌 Don’t miss out! Sign up now to get notified when Flutter Gradle Doctor Pro launches: Sign up here

📄 License MIT License © 2025 [Mohamed Fawzy]