Assets Optimizer 📦 #

A powerful CLI tool that magically shrinks your app size by optimizing images. Supports recursive directory optimization with intelligent compression.

Features 🚀 #

• Optimizes JPG, JPEG, and PNG files
• Supports recursive directory scanning
• Maintains original directory structure
• Smart compression based on file type
• Progress indicator with real-time feedback
• Detailed size reduction statistics
• Video file detection (.mp4, .mov)

Installation 📥 #

Global Installation (Recommended) #

1. Make sure you have Dart SDK installed. If not, install it from here.

2. Run the following command:

dart pub global activate assets_optimizer

3. Add the pub cache bin directory to your PATH:

   For Mac/Linux:

   # Add this to your ~/.bashrc, ~/.zshrc, or similar
   export PATH="$PATH":"$HOME/.pub-cache/bin"
   

   For Windows:

   # Add this to your PATH environment variable
   %LOCALAPPDATA%\Pub\Cache\bin
   

Project-specific Installation #

Add to your pubspec.yaml:

dev_dependencies:
  assets_optimizer: ^1.0.0

Then run:

dart pub get

Usage 🛠️ #

If installed globally: #

# Optimize all images in the assets directory
assets_optimizer custom/

# Default will work for assets/
assets_optimizer

# Get help
assets_optimizer --help

If installed in project: #

# From your project root
dart run assets_optimizer optimize assets/

Compression Settings ⚙️ #

• PNG files: Level 6 compression (balanced between size and quality)
• JPG/JPEG files: 70% quality (visually lossless in most cases)

Example Output 📊 #

⠋ [1/5] profile.jpg 📦 1024KB → 412KB 💾 Saved: 59.8% [============>
⠙ [2/5] background.png 📦 2048KB → 890KB 💾 Saved: 56.5% [============>
...
🎉 All images processed!
📦 Total Original: 10240 KB
💾 Total Compressed: 4096 KB
🎊 Total Saved: 6144 KB

Contributing 🤝 #

Contributions are welcome! Please feel free to submit a Pull Request.

License 📄 #

MIT License - see the LICENSE file for details