NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #1296 most downloaded on pub.dev
A Flutter image editor: Seamlessly enhance your images with user-friendly editing features.
Latest stable
14.26.0
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
482 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
FIX(blur-editor): Resolve issue where the slider animation does not work in the blur editor.
vibration to 3.1.1.FIX(paint-editor): Resolve issue where the paint editor did not use appBarColor from the style configuration. More details in PR #333
appBarColor from the style configuration. More details in PR #333Your coding agent can read these notes before it upgrades. Set up the MCP server →
FIX(layer-interaction): Fix issue where layers remove-area still appear when attempting to move a layer, even when enableMove is set to false. Resolve
enableMove is set to false. Resolves issue #332enableEdit to the layer interaction options, allowing users to disable direct editing of text layers.feat(examples): add download button functionality by @hm21 in https://github.com/hm21/pro_image_editor/pull/299
dart:html and dart:js with package:web and dart:js_interop for WebAssembly support by @hm21 in https://github.com/hm21/pro_image_editor/pull/304Full Changelog: https://github.com/hm21/pro_image_editor/compare/v7.0.0...v8.0.0
Layer Interaction Overhaul:
enableInteraction property on layers with the new LayerInteraction class, introducing more specific configuration options:
enableMove, enableScale, enableRotate, and enableSelection.Customizable Interaction Widgets:
LayerInteractionWidgets with two new options:
children: Allows users to define their own interactive button designs when the layer is selected.border: Enables users to customize the border appearance of selected layers for a fully tailored design.TextLayerDataPaintingLayerDataEmojiLayerDataStickerLayerDataReactiveWidgetDataReactiveAppbarDataserializeStickerexportStickersCHORE(dependencies): Update emoji_picker_flutter to 4.3.0, vibration to 3.0.0 and http to 1.3.0.
emoji_picker_flutter to 4.3.0, vibration to 3.0.0 and http to 1.3.0.CHORE(vibration): Updated the vibration package to version 2.1.0.
vibration package to version 2.1.0.FIX(grounded-design): Fixed an issue where aspect ratios were incorrectly selected regardless of the canChangeAspectRatio flag.
canChangeAspectRatio flag.DOCS(readme): update readme to reflect latest changes
FIX(paint-editor): Resolved an issue where the freestyle painter didn't update the painting in real-time until the user finished painting.
FEAT(state-history): Improve internal state history to consume less RAM during in-app usage, enhancing performance in memory-constrained environments.
enableMinify option to ExportEditorConfigs (enabled by default), which further reduces the output file size by minifying key structures. Even with minification disabled, export sizes are notably smaller due to optimizations.features and shared directories for better maintainability.key_minifier to ensure reliability of the minification process.See pull request #322 for more details.
FEAT(export/import): Improve widget-layer import/export to enable setting up a widgetLoader inside the ImportEditorConfigs that loads widgets using cu
widgetLoader inside the ImportEditorConfigs that loads widgets using custom logic without converting them to Uint8List. See pull request #315 for more details.FEAT(emoji): Preload emoji font on web platforms when the main editor opens. This behavior can be enabled or disabled in the emojiEditor configuration
enablePreloadWebFont flag.FIX(web): Resolved performance issues after implementing changes for WASM compatibility. Replaced dartify with toDart, improving conversion performanc
dartify with toDart, improving conversion performance from an average of 600ms to 20ms.FIX(crop): Corrected an issue where cropping with specific aspect ratios did not work when the editor was embedded.
FEAT(dependencies): Update emoji_picker_flutter to 4.2.0 and image to 4.5.2. Adds support for custom translations in emoji editor for emoji search.
emoji_picker_flutter to 4.2.0 and image to 4.5.2. Adds support for custom translations in emoji editor for emoji search.FEAT(export-history): Introduce the serializeSticker parameter to ExportEditorConfigs to enable exporting only StickerLayerData without converting the
serializeSticker parameter to ExportEditorConfigs to enable exporting only StickerLayerData without converting the sticker to a Uint8List. This change incorporates the updates from pull request #306.FIX(android): Resolve crop-drag conflicts with navigation gestures on android. This resolves issue #303
FEAT(Wasm): Replaced the dart:html and dart:js packages with package:web and dart:js_interop to enable WebAssembly (Wasm) support. The current Flutter
dart:html and dart:js packages with package:web and dart:js_interop to enable WebAssembly (Wasm) support.
The current Flutter version 3.27.1 has an open issue with the ColorFiltered widget. As a result, the tune and filter editor will not function in Wasm. Once Flutter resolves this issue, the editor should work without requiring further updates.FIX(zoom): Corrected the layer rotation calculation when the user drags the rotation button. This resolves issue #266
Important: This restructuring introduces breaking changes, and you'll need to update your existing configurations accordingly.
In this release, I've restructured the configuration files to improve clarity and ease of use, especially for new users. This change addresses previous complexities and aims to reduce confusion when locating and modifying settings such as icons, styles, or widgets.
Important: This restructuring introduces breaking changes, and you'll need to update your existing configurations accordingly.
For detailed information on migrating your configurations, please refer to Discussion #298.
I've added a new example page to demonstrate the updated configuration structure and showcase best practices for setting up the editor. This resource is designed to assist both new and existing users in adapting to the changes introduced in this release.
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v6.0.0...v7.0.0
custom widgets, icons, and theme files into the configs directory for better organization.theme files to styles to better reflect their purpose.custom widgets, icons, and theme files are now located directly in the configs directory of the editor.Style for consistency.For more details on why these breaking changes were made and what improvements they bring, check out that GitHub discussion.
FIX(layer): Resolve issue that layer reposition correctly after screen rotation. This resolves issue #283
Fix(version): Set minimum Flutter version to 3.27.0. This resolves issue #287
3.27.0. This resolves issue #287FIX(lint): Resolve lint issues after upgrading to Flutter 3.27.0
3.27.0FEAT(Main-Editor): Added updateBackgroundImage method to update the editor's background image.
updateBackgroundImage method to update the editor's background image.- STYLE: Format dart code
FIX(import): Fixed an issue where imported layers didn't scale correctly on different screen sizes. This resolves issue #272
FIX(zoom): Fixed an issue where the minimum zoom level setting had no effect, ensuring proper enforcement of zoom boundaries in the viewer. This resol
FIX(keyboard): resolve issue that escape key throw an error when the context menu is open. This resolves issue #260
STYLE(AppBar): moved close action to AppBar's leading parameter for improved layout consistency.
FIX(CustomWidgets): resolve issue preventing user from using custom widget removeLayerArea.
removeLayerArea.FEAT(Layer): Introduce the enableInteraction configuration in the Layer class to toggle interaction capabilities.
enableInteraction configuration in the Layer class to toggle interaction capabilities.bodyItemsRecorded to all editors which can direct generate the final image. This option enables the recording of custom body widgets, enhancing frame functionality.FIX(Recorder): Resolve issue where the editor would incorrectly capture drawing boundaries if the user set captureOnlyDrawingBounds to true. This reso
captureOnlyDrawingBounds to true. This resolves issue #249FIX(Generation-Configs): Removed unnecessary assert for captureOnlyBackgroundImageArea and captureOnlyDrawingBounds, which was blocking certain combin
captureOnlyBackgroundImageArea and captureOnlyDrawingBounds, which was blocking certain combinations for generating transparent images. Details discussed here.Tune-Editor: Added new Tune Editor for image adjustments. (commit)
<h1>6.0.0 (2024-10-23)</h1>
importHistoryDemoData with tune adjustments. (commit)movable_background_image example displayed helper lines in the wrong position. (commit)FEAT(Tune-Editor): Introduced the new "Tune" editor, enabling users to adjust image contrast, saturation, and brightness for enhanced control over image tuning.
CHORE(Dependency): Update image dependency to version 4.3.0.
CHORE(Dependency): Update vibration dependency to version 2.0.1.
CHORE(Dependency): Update mime dependency to version 2.0.0.
FIX(Example): Resolve the issue where the movable_background_image example displays the helper lines in the wrong position.
FIX(Example): Resolve all linting issues in the example code.
FIX(Paint-Editor): Resolve issue where undo-redo action capturing the incorrect image. This resolves issue #239
FEAT(Emoji-Editor): Update the emoji-editor to version 3.1.0 with custom view order configuration support.
3.1.0 with custom view order configuration support.FEAT(Filter): Filter-preview widgets are now animated with a default fadeInUp effect.
hideToolbarOnInteraction to true in the layerInteraction settings.FEAT(Custom-Widgets): add custom widgets to replace layer interaction buttons (edit, remove, rotateScale)
FIX(Import): Ensure imported numbers are type-safe even if int and double are incorrect. This resolves issue #221
FIX(Frosted-Glass): Resolve issue that loading-dialog didn't use the text from the i18n class.
REFACTOR(vars): remove deprecated variables
BREAKING FEAT(Callback): Added the ImageInfos parameter to the onDone callback in the crop-rotate-editor.
ImageInfos parameter to the onDone callback in the crop-rotate-editor.copyWith method to all config classes.emoji_picker_flutter dependency to version 3.0.0.vibration dependency to version 2.0.0.mime dependency to version 1.0.6.FIX(Crop-Editor): Ensure the editor respect the maximum output size.
FIX(Crop-Editor): Occasionally, image generation may fail due to issues related to internal Flutter widget builds. In such cases, we immediately retry
FIX(Crop-Editor): Ensure custom aspect ratio is applied when no changes are made.
FIX(Frosted-Glass-Design): Ensure configuration options such as canReset function correctly.
canReset function correctly.FEAT(Layer Management): Added method replaceLayer to enable replacing an existing layer at a specified index, enhancing layer management and history t
replaceLayer to enable replacing an existing layer at a specified index, enhancing layer management and history tracking capabilities.onTapEditSticker to display an edit button on stickers when tapped, allowing for customizable sticker editing interactions. This was requested in #188.REFACTOR(config): Rename 'editorIsZoomable' to 'enableZoom'
initinalTransformConfigs to 'initialTransformConfigs'STYLE(lint): Add extensive lint tests across multiple components to enhance code quality
FIX(loading-dialog): The loading dialog will now close correctly regardless of the animation builder's state, preventing potential UI freezes or block
> Breaking Changes The package now supports Flutter 3.24, which changes the onPopInvoked method. Introduced a new loading dialog as a singleton class.
Breaking Changes The package now supports Flutter
3.24, which changes theonPopInvokedmethod. Introduced a new loading dialog as a singleton class.
Overlay instead of Navigator.push. This provides more control over the dialog's hide process and prevents it from affecting other widgets.transformConfigs to initTransformConfigs.awaitLoadingDialogContext configuration as it is no longer required.FEAT(text-editor): Enable access to FocusNode and TextControl for enhanced editor control.
FIX(frosted-glass): Adjust frosted glass example icon button size.
FIX(loading-dialog): close loading dialog after generation process completes.
FIX(layout): Resolve right overflow issue on small size phones in the paint-editor. This was merged from the pull request #178.
FIX(paint-validator): Resolve right overflow issue. This resolves the issue #177.
FEAT(crop-rotate-editor): Allow users to read and update the aspect ratio using custom methods. This was requested in #169.
FEAT(draw-opacity): Add an option to let the user change the opacity of the drawing. This was discussed in #167.
FIX(done-button): Disable 'Done' button until image is decoded. This resolves the issue #166.
FIX(dialog-mode): Resolve issue where the subEditorPage had the wrong size in the dialog. This resolves the issue #164.
One column per month.