🧼 image_cleaner_cli #

A Dart CLI tool to detect, preview, and delete unused image assets in your Flutter project.

Clean up your codebase with an interactive, browser-based preview of unused images.

⭐ Found this helpful? Give it a star on GitHub!

🎬 Demo #

✅ Features #

• 🔍 Detect unused images in your Flutter project's assets/ folder by default (e.g., running image_cleaner_cli example will only check assets/). If assets/ doesn't exist, it will check images/. To scan a custom folder, pass its relative path as an argument.
• 🧪 Dry-run mode (--dry-run) to preview without deleting
• 🌐 Automatically launches a local interactive HTML preview
• 🗑️ Delete selected images directly via the browser UI
• 💻 Works on macOS, Windows, and Linux
• ⚙️ Simple CLI, no setup or config required

🚀 Installation #

📦 Global Activation #

dart pub global activate image_cleaner_cli

Then run the tool from anywhere:

image_cleaner_cli

🔁 Make sure your Dart bin path (e.g., ~/.pub-cache/bin) is in your system's PATH.

📌 Installing a Specific Version #

dart pub global activate image_cleaner_cli <version>

Example:

dart pub global activate image_cleaner_cli 0.0.5

▶️ Run Locally Without Global Install #

Clone or open your local project and run:

dart run bin/image_cleaner_cli.dart

📂 Scan a Specific Project Folder #

image_cleaner_cli /path/to/your/flutter/project

Or, when running locally:

dart run bin/image_cleaner_cli.dart /path/to/your/flutter/project

▶️ Usage Arguments: #

<project_folder>
Path to your Flutter/Dart project root or to a specific assets/images folder. You can pass either a relative or absolute path.

Examples:

image_cleaner_cli example/assets
image_cleaner_cli example/images
image_cleaner_cli example

If omitted, the current working directory will be used.

By default, the tool checks for an assets/ folder; if none is found, it checks for an images/ folder.

If you want to scan a custom folder, pass it as an argument:

image_cleaner_cli example/customFolder

⚙️ CLI Options #

🛠 How It Works #

1. Checks if an assets/ folder exists in the target path, if yes, scans it; if not, scans images/.
2. You can also pass a custom folder’s relative path to scan instead.
3. Finds image files not referenced in any .dart files.
4. Starts a local web server (http://localhost:8080).
5. Opens an interactive UI where you can:
   • ✅ Review all unused images.
   • 🗑️ Select and delete them safely with a single click.

💡 Sample Output (Dry Run) #

📂 Using folder: /your/flutter/project
🧪 Performing dry run...
🗂️ Found 4 unused images:

  assets/images/old_logo.png
  assets/icons/unused_icon.svg
  assets/images/temp/banner.jpg
  assets/icons/trash.png

📁 Requirements #

• Flutter project with images stored under assets/ or images/
• Image paths must be referenced directly in .dart files as strings (no dynamic paths)

📌 Version #

Current: 0.0.5
Check pub.dev → image_cleaner_cli for latest.

👨‍💻 Maintainer #

Built with ❤️ by Sumit Dabral

🔗 GitHub #

github.com/I-SumitDabral/image_cleaner_cli

🧰 Use as a Dart Package #

You can also use image_cleaner_cli programmatically in your project:

In pubspec.yaml #

dependencies:
  image_cleaner_cli: ^0.0.5

Then run: #

dart pub get
# or
flutter pub get

🔖 Tags #

flutter
dart
cli
image-cleaner
asset-cleaner
flutter-cli
flutter-asset
tooling
developer-tools

🙌 Support #

If this CLI saves you time and clutter, please consider:

• ⭐ Starring the project on GitHub
• 📢 Sharing it with fellow developers
• 🐛 Reporting issues or suggesting features