NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #1318 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 5 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(main-editor): prevent crash by checking widget mounted state before setState call by @hm21 in https://github.com/hm21/pro_image_editor/pull/771
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.0.1...v12.0.2
setState is called after widget disposal, preventing "Cannot add new events after calling close" error.FIX(layers): Resolve issue where layer interaction button tooltips would absorb pointer events in Flutter 3.41+, preventing scale and rotate gestures
Your coding agent can read these notes before it upgrades. Set up the MCP server →
feat: implement new audio and clips editor by @hm21 in https://github.com/hm21/pro_image_editor/pull/767
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.23.0...v12.0.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
FEAT(paint-editor): Add customPathBuilders to PaintEditorConfigs, allowing users to register custom PathBuilderBase implementations for any paint mode
customPathBuilders to PaintEditorConfigs, allowing users to register custom PathBuilderBase implementations for any paint mode.custom1, custom2, custom3 paint modes that require custom path builders to be registered. These can be fully customized with custom icons and i18n labels.FEAT(helper-lines): Helper line stroke width is now configurable via the configs.
FIX(layers): Resolve issue of layers always being clipped and unable to extend beyond the image editor.
FEAT(image-generation): Add captureImageByteFormat config to ImageGenerationConfigs to control the byte format used when capturing images. Defaults to
captureImageByteFormat config to ImageGenerationConfigs to control the byte format used when capturing images. Defaults to ImageByteFormat.rawStraightRgba which prevents black border artifacts around transparent edges when exporting to PNG.enableKeyboardShortcuts config to MainEditorConfigs to optionally disable library-side keyboard shortcuts, allowing apps to implement their own key bindings without conflicts.FEAT(video-editor): Add videoSetupLoadingIndicator widget to VideoEditorWidgets to allow customizing the loading indicator shown while the video playe
videoSetupLoadingIndicator widget to VideoEditorWidgets to allow customizing the loading indicator shown while the video player is initializing.feat(video-editor): add showControls config to VideoEditorConfigs by @hm21 in https://github.com/hm21/pro_image_editor/pull/759
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.21.1...v11.21.2
showControls config to VideoEditorConfigs to allow hiding the video editor controls UI.FEAT(text-editor): Add resizeToAvoidBottomInset config to control whether the editor resizes when the keyboard appears.
resizeToAvoidBottomInset config to control whether the editor resizes when the keyboard appears.fix(services): ignore Alt on Ctrl shortcuts by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/757
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.20.1...v11.21.0
FIX: Resolve issue where DeferPointer shows an error when the hero animations is running for the text layers from the custom screens.
FEAT(main-editor): Add the flag enableSubEditorPage which allows sub-editors to be opened with the same constraints as the editor itself. More details
enableSubEditorPage which allows sub-editors to be opened with the same constraints as the editor itself. More details in PR #752.FEAT(main-editor): Add onEditTextLayer callback to MainEditorCallbacks, allowing users to open a custom text editor when a text layer is tapped.
onEditTextLayer callback to MainEditorCallbacks, allowing users to open a custom text editor when a text layer is tapped.onCreateTextLayer callback to MainEditorCallbacks, allowing users to open a custom text editor when creating a new text layer.bodyItemsOverlay to TextEditorWidgets for placing custom widgets above all other content in the text editor body.textFieldPadding to TextEditorStyle for applying padding outside the scroll area of the text field.feat(text-editor): add custom text editor callback and overlay support by @hm21 in https://github.com/hm21/pro_image_editor/pull/751
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.18.4...v11.19.0
toMap, fromMap, toJson, fromJson).Nothing published for this version
FEAT(paint-editor): Add freestyle arrow modes (freeStyleArrowStart, freeStyleArrowEnd, freeStyleArrowStartEnd) to draw freehand paths with arrowheads
freeStyleArrowStart, freeStyleArrowEnd, freeStyleArrowStartEnd) to draw freehand paths with arrowheads at the start, end, or both ends.feat(editor-safe-area): add convenience constructors none, symmetric, and fromLTRB by @hm21 in https://github.com/hm21/pro_image_editor/pull/742
none, symmetric, and fromLTRB by @hm21 in https://github.com/hm21/pro_image_editor/pull/742Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.18.1...v11.18.2
none, symmetric, and fromLTRB for easier safe area configuration.fix(filter-editor): ensure filters can be removed by @hm21 in https://github.com/hm21/pro_image_editor/pull/741
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.18.0...v11.18.1
feat(filter-editor): add single-selection support for filters in editor by @hm21 in https://github.com/hm21/pro_image_editor/pull/740
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.17.0...v11.18.0
enableMultiSelection is disabled, allowing users to toggle between filters instant of stacking filters.Add Hexagon shape tool (drag-to-draw) using PathBuilder by @bhavjsh in https://github.com/hm21/pro_image_editor/pull/738
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.16.0...v11.17.0
feat: Add text shadow persistence in state history export/import by @faizahmaddae in https://github.com/hm21/pro_image_editor/pull/733
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.15.6...v11.16.0
feat(text-editor): allow background and borders by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/735
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.15.5...v11.15.6
Feat/network image headers by @bybabek in https://github.com/hm21/pro_image_editor/pull/729
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.15.4...v11.15.5
networkHeaders to the EditorImage. More details in PR #729.fix(widget-layer): correct application of optional width in layer calculations by @hm21 in https://github.com/hm21/pro_image_editor/pull/728
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.15.3...v11.15.4
width being applied incorrectly.fix(ifd_directory): simplify type checks for IfdValue assignment by @hm21 in https://github.com/hm21/pro_image_editor/pull/726
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.15.2...v11.15.3
FEAT(crop-rotate-editor): Add new callback onTransformUpdateEnd that returns all transformation changes whenever a value in the crop-rotate editor is
onTransformUpdateEnd that returns all transformation changes whenever a value in the crop-rotate editor is modified.FEAT(text-editor): Add config enableAutoWrapOnLayer to the TextEditorConfigs which allows for deciding whether the layer applies the editor's auto wra
enableAutoWrapOnLayer to the TextEditorConfigs which allows for deciding whether the layer applies the editor's auto wrapping or not. More details in PR #720.feat(crop-editor): add public setScale method by @hm21 in https://github.com/hm21/pro_image_editor/pull/717
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.14.2...v11.15.0
setScale method to cropRotateEditor for programmatically setting the scale factor.fix(main-editor): prevent get selectedLayer from throwing exception when layer is not found by @panuavakul in https://github.com/hm21/pro_image_editor
get selectedLayer from throwing exception when layer is not found by @panuavakul in https://github.com/hm21/pro_image_editor/pull/715onLayerTapUp is never called by @panuavakul in https://github.com/hm21/pro_image_editor/pull/716Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.14.1...v11.14.2
onLayerTapUp is never called.fix(main-editor): prevent dual editor opening with Apple pencil tap by @caghp94 in https://github.com/hm21/pro_image_editor/pull/712
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.14.0...v11.14.1
feat(crop-editor): add cropOverlayOpacity and cropOverlayInteractionOpacity for enhanced crop area control by @hm21 in https://github.com/hm21/pro_ima
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.13.0...v11.14.0
cropOverlayOpacity and cropOverlayInteractionOpacity to control the opacity outside the crop area when editing an image.fix(main-editor): apple pencil tap detection for text layer editing by @caghp94 in https://github.com/hm21/pro_image_editor/pull/705
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.12.2...v11.13.0
feat(main-editor): make scale actions proportional in desktop interactions by @DAAAAAAAAAAAAAAAAN in https://github.com/hm21/pro_image_editor/pull/701
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.12.1...v11.12.2
fix(rtl): resolve incorrect layer selection box location by @hm21 in https://github.com/hm21/pro_image_editor/pull/700
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.12.0...v11.12.1
refactor(layer): remove unused scale parameter from LayerWidgetPaintItem by @hm21 in https://github.com/hm21/pro_image_editor/pull/692
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.11.0...v11.12.0
enableTapOutsideToSave configuration to TextEditorConfigs to control whether tapping outside the text field saves the text annotation.feat(paint-editor): add dash-dot line mode and related configurations by @hm21 in https://github.com/hm21/pro_image_editor/pull/686
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.10.1...v11.11.0
fix(callbacks): resolve issue where the callback onDone in mainEditorCallbacks is not triggered by @hm21 in https://github.com/hm21/pro_image_editor/p
onDone in mainEditorCallbacks is not triggered by @hm21 in https://github.com/hm21/pro_image_editor/pull/682Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.10.0...v11.10.1
onDone in mainEditorCallbacks is not triggered. Resolves issue #681.feat(editor): add blank canvas support for image editors and update related configurations by @hm21 in https://github.com/hm21/pro_image_editor/pull/6
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.9.1...v11.10.0
ProImageEditor.blank constructor, allowing creation of editors without an initial image.fix(text-editor): Fix theme change during hero flight. by @DarkLink363 in https://github.com/hm21/pro_image_editor/pull/677
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.9.0...v11.9.1
feat(tools): introduce tools API and deprecate old flags by @hm21 in https://github.com/hm21/pro_image_editor/pull/676
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.8.0...v11.9.0
tools in MainEditorConfigs to configure available sub-editors and their order, replacing old enableModeX flags with a cleaner list-based API.tools in PaintEditorConfigs to define available paint modes and their order, deprecating individual enableModeX flags.tools in CropRotateEditorConfigs with a new CropRotateTool enum for rotate, flip, aspect ratio, and reset actions, deprecating the old showXButton flags.feat(callbacks): add onEditLayer to PaintEditorCallbacks for custom layer editing by @hm21 in https://github.com/hm21/pro_image_editor/pull/675
onEditLayer to PaintEditorCallbacks for custom layer editing by @hm21 in https://github.com/hm21/pro_image_editor/pull/675Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.7.0...v11.8.0
onEditLayer to PaintEditorCallbacks, allowing custom paint-layer editing logic (e.g., via a side menu). This was requested in #673.copyWith method to all layer classes for easier cloning and modification.feat(sub-editors): add enableGesturePop configuration to all sub-editors for improved navigation control by @hm21 in https://github.com/hm21/pro_image
enableGesturePop configuration to all sub-editors for improved navigation control by @hm21 in https://github.com/hm21/pro_image_editor/pull/671Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.6.0...v11.7.0
enableGesturePop config to all sub-editors to control whether user back navigation (hardware back button, predictive back swipe) is allowed.feat(eraser): implement dynamic eraser size and mode by @hm21 in https://github.com/hm21/pro_image_editor/pull/669
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.8...v11.6.0
Nothing published for this version
fix: added painted model comparison by id by @caghp94 in https://github.com/hm21/pro_image_editor/pull/666
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.7...v11.5.8
chore(example): update firebase_core and firebase_storage dependencies to latest versions by @hm21 in https://github.com/hm21/pro_image_editor/pull/65
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.6...v11.5.7
fix(main_editor): ensure screenshots are marked as broken when updating background images by @hm21 in https://github.com/hm21/pro_image_editor/pull/65
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.5...v11.5.6
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.4...v11.5.5
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.4...v11.5.5
maxDuration displayed an incorrect time span when its value exceeded the video duration. Resolves issue #648.fix(iOS): resolve scroll glitch in the bottom-bar by @hm21 in https://github.com/hm21/pro_image_editor/pull/647
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.3...v11.5.4
fix(video-editor): resolve issue where state history import didn't work in the video-editor by @hm21 in https://github.com/hm21/pro_image_editor/pull/
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.2...v11.5.3
feat(style): add editSheetColor to PaintEditorStyle by @hm21 in https://github.com/hm21/pro_image_editor/pull/645
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.1...v11.5.2
editSheetColor to paint-editor styles.fix(recorder): resolve slow image generation after transforming layers by @hm21 in https://github.com/hm21/pro_image_editor/pull/643
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v11.5.0...v11.5.1
debugFillProperties for better debugging.One column per month.