Flutter Gradle Doctor

pub package

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.

🌟 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

πŸ“¦ 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.

πŸ“„ License MIT License Β© 2025 Mohamed Fawzy

Libraries