DOCUMENTATION
GETTING STARTED
Get ImageWrangler running on your repository in under 2 minutes.
QUICK START
01
Install the GitHub App
Visit the GitHub Marketplace and install ImageWrangler on your repositories.
Install Now02
Push Images
Commit and push images to your repository as you normally would.
03
Review & Merge
ImageWrangler creates a PR with optimized images. Review the savings and merge.
SUPPORTED FORMATS
| FORMAT | EXTENSIONS | LOSSLESS (DEFAULT) | LOSSY |
|---|---|---|---|
| JPEG | .jpg, .jpeg | Optimizes encoding without quality loss | Configurable quality (1-100) |
| PNG | .png | Maximum compression, full color preserved | Palette conversion (reduces colors) |
| WebP | .webp | Native lossless codec | Configurable quality (1-100) |
| GIF | .gif | Always lossless | Lossless only |
| SVG | .svg | Removes unnecessary markup | Lossless only |
• Default behavior preserves exact image quality while reducing file size
• Lossy compression achieves higher compression ratios with slight quality reduction
• Lossy mode can be enabled globally or per-format in the config file
NEXT STEPS
Configuration Options
Customize optimization settings, branch filters, PR behavior, and more with a simple YAML config file.