croppy
A fully customizable image cropper for Flutter. Mobile-first, but supports Web and Desktop platforms.
1.5.3
8.6K downloads/mo
#3125 most downloaded on pub.dev
kekland/croppy
What this package is like to depend on
Last release 4 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
5 releases in the last 12 months
see the full history below
Release timeline
33 releases · May 2023 to Apr 2026
2024
2025
2026
Releases
latest 33-
1.5.321 Apr 2026 -
1.5.218 Apr 2026Release notes
Open source →- Fixed build issues where the FFI bindings' output names were C++ mangled, causing a runtime error when trying to lookup the functions.
Release notes
Open source →- Fixed build issues where the FFI bindings' output names were C++ mangled, causing a runtime error when trying to lookup the functions.
-
1.5.130 Mar 2026 -
1.4.120 Oct 2025Release notes
Open source →- Fixed a bug where tapping on the "rotate 90 degrees" button rapidly would result in a non-90 degree rotation (thanks @AdrianSima for reporting!)
- Added Polish localization (thanks @mekkolodziejski!)
- Added Romanian localization (thanks @AdrianSima!)
- Fixed a bug with perspective transformation being extremely exaggerated on large images. Now the perspective factor is scaled according to the image size. Please report if you find any issues with this new behavior! (thanks @AdrianSima for reporting!)
Contributors: @mekkolodziejski, @AdrianSima
Release notes
Open source →- Fixed a bug where tapping on the "rotate 90 degrees" button rapidly would result in a non-90 degree rotation (thanks @AdrianSima for reporting!)
- Added Polish localization (thanks @mekkolodziejski!)
- Added Romanian localization (thanks @AdrianSima!)
- Fixed a bug with perspective transformation being extremely exaggerated on large images. Now the perspective factor is scaled according to the image size. Please report if you find any issues with this new behavior! (thanks @AdrianSima for reporting!)
-
1.4.016 Sep 2025Release notes
Open source →- Updated
compileSdkVersionto36(thanks @jimmyff and @kaiquecruz)! - Updated
Gradleto8.13(thanks @jimmyff and @kaiquecruz)! - Updated
ndkVersionto27.0.12077973(thanks @jimmyff and @kaiquecruz)! - Updated
minSdkVersionto23(thanks @jimmyff and @kaiquecruz)! - Ensured 16kb memory page size compatibility on Android
- Added Turkish localization (thanks @BayramYARIM)!
- Fix a null-check operator issue on resize (thanks @tusharbhambere)!
Release notes
Open source →- Updated
compileSdkVersionto36(thanks @jimmyff and @kaiquecruz)! - Updated
Gradleto8.13(thanks @jimmyff and @kaiquecruz)! - Updated
ndkVersionto27.0.12077973(thanks @jimmyff and @kaiquecruz)! - Updated
minSdkVersionto23(thanks @jimmyff and @kaiquecruz)! - Ensured 16kb memory page size compatibility on Android
- Added Turkish localization (thanks @BayramYARIM)!
- Fix a null-check operator issue on resize (thanks @tusharbhambere)!
- Updated
-
1.3.612 Mar 2025Release notes
Open source →- Added a parameter called
showGestureHandlesOnto 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! - Added Persian localization (thanks @mdpe-ir)!
- Added an
showAdaptiveImageCroppermethod that will automatically launch the correct cropper depending on the platform. - Fixed a couple of issues with multiple transformations being applied at the same time.
Release notes
Open source →- Added a parameter called
showGestureHandlesOnto 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! - Added Persian localization (thanks @mdpe-ir)!
- Added an
showAdaptiveImageCroppermethod that will automatically launch the correct cropper depending on the platform. - Fixed a couple of issues with multiple transformations being applied at the same time.
- Added a parameter called
-
1.3.506 Mar 2025Release notes
Open source →- Added minimum crop dimension, which can be specified with the
minimumCropDimensionparameter. Defaults to 8.0. Any attempt to transform the crop rect to a size smaller than this will be ignored.
Release notes
Open source →- Added minimum crop dimension, which can be specified with the
minimumCropDimensionparameter. Defaults to 8.0. Any attempt to transform the crop rect to a size smaller than this will be ignored.
- Added minimum crop dimension, which can be specified with the
-
1.3.406 Mar 2025 -
1.3.320 Jan 2025Release notes
Open source →- Reverted changes to
.withValuesand.ausage on colors, since the package currently targets Flutter 3.24
Full Changelog: 1.3.2...1.3.3
Release notes
Open source →- Reverted changes to
.withValuesand.ausage on colors, since the package currently targets Flutter 3.24
- Reverted changes to
-
1.3.220 Jan 2025Release notes
Open source →- Added
showLoadingIndicatorOnSubmitparameter 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
-
1.3.101 Oct 2024 -
1.3.024 Sep 2024 -
1.2.131 Aug 2024Release notes
Open source →- 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 animated. - Updated localization guide in README.md (thanks @Cellaryllis)
- Fixed a bug where animated images would trigger a lot of exceptions in
-
1.2.020 Jul 2024Release notes
Open source →- Added Chinese localization (thanks @yohom and @zhushenwudi)
- Added Spanish localization (thanks @Thesergiolg99)
- Added Hebrew localization (thanks @kfiross)
- Fixed a bug where the reset button would ignore any aspect ratio constraints (thanks @talamaska)
- Added WASM support and Flutter 3.22 (thanks @raldhafiri)
- Updated dependencies and added Gradle namespace (thanks @orkun1675)
- Add support for passing custom themes to the croppers instead of the default generated one, and fixed some more reset issues.
-
1.1.422 Sep 2023Release notes
Open source →- Added Portuguese localization (thanks @JCKodel)
- Added documentation on how to save a cropped image to a file
-
1.1.316 Sep 2023 -
1.1.213 Sep 2023Release notes
Open source →- Croppy shouldn't fail when being launched with unsupported locales. Now it will default to English.
-
1.1.112 Sep 2023 -
1.1.021 Aug 2023Release notes
Open source →- Added localization! Currently supports English, Kazakh, and Russian.
- Added documentation on how to add your own localization, or override an existing one.
-
1.0.117 Aug 2023 -
1.0.017 Aug 2023 -
0.2.610 Aug 2023Release notes
Open source →- Fix: Disallow tapping the "Done" button twice. This could trigger some weird behavior if you're using custom asynchronous operations when the cropper is cropping images.
-
0.2.501 Aug 2023Release notes
Open source →- Fix: Rotating an image with a forced aspect ratio inverts the aspect ratio (#7). Thanks @maRci002 and @siranov for the bug reports!
-
0.2.425 Jun 2023Release notes
Open source →- Hotfix: Cupertino cropper's
TransformationFrictionMixinwas not respecting fixed aspect ratios
- Hotfix: Cupertino cropper's
-
0.2.318 Jun 2023Release notes
Open source →- You can now create your own custom croppers easily! Check out the documentation and the example app for more info.
- Added documentation
-
0.2.224 May 2023 -
0.2.122 May 2023 -
0.2.022 May 2023Release notes
Open source →- Added a Material image cropper
- FFI-based implementation for normalization of the image crop rect
- Performance improvements and bugfixes
-
0.1.018 May 2023Release notes
Open source →- Added custom shapes
- Added allowed aspect ratios
- Added supported transformations list
- Minor design tweaks
- Better image cropping algorithm (now uses Flutter's Canvas instead of a barebones bilinear interpolation)
- Bugfixes
-
0.0.417 May 2023Release notes
Open source →- Updated the example app
- Performance improvements to the Cupertino cropper
- Minor design tweaks
- Added an example webapp
-
0.0.316 May 2023Release notes
Open source →- Implemented a new UI for the Cupertino cropper
- Added
heroTagparameters - if passed, the cropper will be animated with a Hero animation
-
0.0.216 May 2023 -
0.0.116 May 2023