📦 Bundle Visualizer

A powerful Dart CLI tool for analyzing Flutter project assets, bundle size, dependencies, and optimization opportunities.

Detect duplicate assets • Find unused assets • Analyze bundle health • Generate optimization suggestions

---

✨ Features

• 📁 Scan Flutter project assets
• 📊 Bundle Health Score
• 🔍 Detect duplicate assets
• 🗑 Detect unused assets
• 🖼 Image optimization suggestions
• 📦 Dependency analysis
• 🎨 Beautiful terminal interface
• ⚡ Fast parallel scanning
• 📈 Optimization recommendations
• 🌈 Colored CLI output
• 📜 Scan history
• ⚙ Configurable project scanning

---

🚀 Installation

Activate globally

dart pub global activate bundle_visualizer

Run locally

dart run

---

💻 Usage

Analyze the current Flutter project

bundle_visualizer scan

Analyze another project

bundle_visualizer scan --project "/path/to/flutter_project"

Generate HTML report

bundle_visualizer html

Export JSON

bundle_visualizer json

Compare previous scans

bundle_visualizer compare

Display help

bundle_visualizer help

---

📸 CLI Preview

---

📋 Example Output

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Bundle Visualizer Analysis
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Project
sample_flutter_app

Bundle Health
91 / 100

Assets
148

Images
122

Fonts
3

Total Size
18.7 MB

Duplicate Assets
4

Unused Assets
7

Potential Savings
2.4 MB

Top Recommendation

Convert PNG images to WebP
Estimated Saving: 640 KB

Completed in 312 ms

---

📊 Bundle Health Score

Bundle Visualizer calculates an overall project health score based on multiple optimization factors.

Category	Included
Asset Organization	✅
Duplicate Assets	✅
Unused Assets	✅
Image Optimization	✅
Font Optimization	✅
Dependency Count	✅
Bundle Size	✅
Large Files	✅
Project Cleanliness	✅

---

📂 Supported Asset Types

• PNG
• JPG
• JPEG
• WebP
• SVG
• GIF
• Lottie
• Fonts
• JSON
• Audio
• Video

---

🛣 Roadmap

Version 1.0

• ✅ Asset Scanner
• ✅ Duplicate Detection
• ✅ Unused Asset Detection
• ✅ Bundle Health Score
• ✅ Image Analysis
• ✅ Progress Indicators
• ✅ Colored Terminal UI

Upcoming

• HTML Dashboard
• Interactive Charts
• Bundle History Dashboard
• Auto Fix Suggestions
• GitHub Action
• VS Code Extension
• Flutter Analyze Size Integration
• CI Reports

---

🤝 Contributing

Contributions are welcome.

If you'd like to improve Bundle Visualizer:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

---

⭐ Support

If you find this project useful, consider giving it a ⭐ on GitHub.

It helps other Flutter developers discover the project.

---

📄 License

MIT License

Copyright © 2026 Aamir Ali