NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #3301 most downloaded on pub.dev
A fully customizable image cropper for Flutter. Mobile-first, but supports Web and Desktop platforms.
Last release 5 months ago
21 Apr 2026
Release timing varies
gaps range from 1 weeks to 10 months
Nearly every release is documented
notes for 33 of 33 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
33 releases · first in 2023
One column per quarter.
Fixed missing C++ shared library on Android.
Fixed build issues where the FFI bindings' output names were C++ mangled, causing a runtime error when trying to lookup the functions.
Fix minimum SDK constraint
Fixed a bug where tapping on the "rotate 90 degrees" button rapidly would result in a non-90 degree rotation (thanks @AdrianSima for reporting!)
Contributors: @mekkolodziejski, @AdrianSima
Updated compileSdkVersion to 36 (thanks @jimmyff and @kaiquecruz )!
compileSdkVersion to 36 (thanks @jimmyff and @kaiquecruz)!Gradle to 8.13 (thanks @jimmyff and @kaiquecruz)!ndkVersion to 27.0.12077973 (thanks @jimmyff and @kaiquecruz)!minSdkVersion to 23 (thanks @jimmyff and @kaiquecruz)!Added a parameter called showGestureHandlesOn to control for which crop shapes the gesture handles should be shown. This allows you to, for example, s
showGestureHandlesOn to control for which crop shapes the gesture handles should be shown. This allows you to, for example, show the rectangular gesture handles on a circular crop shape. Thanks @denysbohatyrov!showAdaptiveImageCropper method that will automatically launch the correct cropper depending on the platform.Added minimum crop dimension, which can be specified with the minimumCropDimension parameter. Defaults to 8.0. Any attempt to transform the crop rect
minimumCropDimension parameter. Defaults to 8.0. Any attempt to transform the crop rect to a size smaller than this will be ignored.Added mouse wheel and trackpad zooming (thanks @denysbohatyrov !).
Reverted changes to .withValues and .a usage on colors, since the package currently targets Flutter 3.24
.withValues and .a usage on colors, since the package currently targets Flutter 3.24Full Changelog: 1.3.2...1.3.3
Added showLoadingIndicatorOnSubmit parameter to show a loading indicator when the user presses the "Done" button. This is useful if you're doing some
showLoadingIndicatorOnSubmit parameter to show a loading indicator when the user presses the "Done" button. This is useful if you're doing some heavy processing on the cropped image and want to show the user that something is happening.Added German localization (thanks @jkoenig134)!
Updated to package:web version 1.0.0.
package:web version 1.0.0.Fixed a bug where animated images would trigger a lot of exceptions in obtainImage. Now, the cropper will just display a static image if the image is
obtainImage. Now, the cropper will just display a static image if the image is animated.Added Chinese localization (thanks @yohom and @zhushenwudi)
Added Portuguese localization (thanks @JCKodel)
Added Vietnamese localization (thanks @ptanhVNU)
Croppy shouldn't fail when being launched with unsupported locales. Now it will default to English.
Added Arabic localization (thanks @Milad-Akarie)
Added localization! Currently supports English, Kazakh, and Russian.
Loosened the constraint to 3.13.0-0.3.pre to pass Pub analysis
3.13.0-0.3.pre to pass Pub analysisMajor breaking version. Updated to support Flutter 3.13.
Fix: Disallow tapping the "Done" button twice. This could trigger some weird behavior if you're using custom asynchronous operations when the cropper
Fix: Rotating an image with a forced aspect ratio inverts the aspect ratio (#7). Thanks @maRci002 and @siranov for the bug reports!
Hotfix: Cupertino cropper's TransformationFrictionMixin was not respecting fixed aspect ratios
TransformationFrictionMixin was not respecting fixed aspect ratiosYou can now create your own custom croppers easily! Check out the documentation and the example app for more info.
* Added shouldPopAfterCrop
shouldPopAfterCropAccidentally dropped support for Web because of FFI - fixed.
FFI-based implementation for normalization of the image crop rect
Added supported transformations list
Performance improvements to the Cupertino cropper
Implemented a new UI for the Cupertino cropper
heroTag parameters - if passed, the cropper will be animated with a Hero animationFixed images not linking properly in README
* Initial release!
Your coding agent can read these notes before it upgrades. Set up the MCP server →