NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
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.
feat(layers): let a drawing draw itself stroke by stroke, release 14.26.0 by @hm21 in https://github.com/hm21/pro_image_editor/pull/916
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.25.2...v14.26.0
LayerAnimationType.drawOn to draw a paint layer's strokes in the order they were drawn, or take them away in reverse; a switch over LayerAnimationType must handle the new value.ExportedLayer.drawOnBytes, at ImageGenerationConfigs.drawOnFrameRate.fix(audio_editor): wrap fallback AudioTrackListTile in transparent Material to prevent ink splash assertion by @Faizan18506 in https://github.com/hm21
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.25.1...v14.25.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
fix(video): hide a layer, filter or tune adjustment at its exact end time by @hm21 in https://github.com/hm21/pro_image_editor/pull/914
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.25.0...v14.25.1
endTime ([startTime, endTime)), matching the video export.fix(sub-editors): show layers at the video's playback position by @hm21 in https://github.com/hm21/pro_image_editor/pull/913
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.24.0...v14.25.0
Layer.isWithinTimeRange.feat(paint-editor): let apps add their own freehand brushes by @hm21 in https://github.com/hm21/pro_image_editor/pull/912
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.23.1...v14.24.0
PaintEditorConfigs.freeStyleCustomModes so a custom paint mode records the whole stroke, like PaintMode.freeStyle, and its custom path builder can draw a brush.PathBuilderFreestyle and add PathBuilderBase.drawInLayer, so a custom brush that overrides draw with several draw calls keeps the opacity and the eraser working.fix(main-editor): keep textLayerWrapsAtBounds from throwing while the editor is deactivated by @hm21 in https://github.com/hm21/pro_image_editor/pull/
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.23.0...v14.23.1
textLayerWrapsAtBounds returns false instead of throwing while the editor is out of the tree.feat(layers): per-layer move and scale limits by @hm21 in https://github.com/hm21/pro_image_editor/pull/910
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.22.0...v14.23.0
LayerInteraction.bounds, minScale and maxScale to keep one layer inside an area and within a scale range.feat(layers): spin and flip layer animations by @hm21 in https://github.com/hm21/pro_image_editor/pull/909
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.21.1...v14.22.0
LayerAnimationType.spin and LayerAnimationType.flip (around a FlipAxis) to turn a layer by LayerAnimation.turns; a switch over LayerAnimationType must handle the new values.fix(text-editor): keep huge text from corrupting the glyph atlas by @hm21 in https://github.com/hm21/pro_image_editor/pull/908
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.21.0...v14.21.1
feat(layers): animate a shape mask with keyframes by @hm21 in https://github.com/hm21/pro_image_editor/pull/907
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.20.0...v14.21.0
LayerMask.keyframes to animate a shape mask over time (LayerMask.at, Layer.maskAt); Layer.captureAsPng leaves a keyframed mask to the renderer.setLayerTimeline takes a mask to rebase its keyframes with a trimmed start.ExportedLayer.boxSize, the unturned box a renderer places a mask in.fix(layers): stop text layers from shifting on hover by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/906
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.19.0...v14.20.0
TextLayerBoxOverflow.visible and TextEditorConfigs.boxOverflow to draw lines that do not fit past a text box; a switch over TextLayerBoxOverflow must handle the new value.InlineTextEditSession.setFontScale to resize the text while typing on the canvas.feat(text-editor): let text layers reach and run past the layer bounds by @hm21 in https://github.com/hm21/pro_image_editor/pull/902
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.18.0...v14.19.0
TextLayer.gradient to fill the letters of a text with a linear TextGradient.TextLayer.wrapAtLayerBounds to let a text run past TextEditorConfigs.layerBounds; ProImageEditorState.textLayerWrapsAtBounds tells whether the bounds wrap a layer.TextEditorConfigs.layerBounds; only what a layer draws has to fit.feat(layers): add star, triangle, diamond, hexagon and speech bubble masks by @hm21 in https://github.com/hm21/pro_image_editor/pull/901
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.17.0...v14.18.0
LayerMaskShape. A switch over LayerMaskShape has to handle the new values.Feat/inline text editing by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/899
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.16.0...v14.17.0
TextEditorConfigs.enableInlineEditing to type into a text layer on the canvas instead of opening the full-screen text editor; InlineTextEditChrome keeps a custom format bar from ending the edit.feat(layers): blend a layer with what is beneath it by @hm21 in https://github.com/hm21/pro_image_editor/pull/900
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.15.0...v14.16.0
Layer.blendMode to blend a layer with the image and the layers beneath it, such as multiply or screen; LayerBlendModeBox blends any widget the same way, a video Texture included.feat(main-editor): resizable text boxes by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/898
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.14.3...v14.15.0
TextLayer.box to lay a text out in a fixed box that clips or shrinks text that does not fit; LayerInteractionConfigs.enableTextBoxResize shows handles that resize the box without scaling the text, and TextEditorState.setBoxEnabled puts the edited text into a box.perf(import-export): share unchanged paint strokes across history steps by @hm21 in https://github.com/hm21/pro_image_editor/pull/897
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.14.2...v14.14.3
PaintedModel.copy now shares offsets with the original.perf(paint-editor): share censor backdrop passes instead of one per area by @hm21 in https://github.com/hm21/pro_image_editor/pull/896
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.14.1...v14.14.2
fix(import-export): stop rewriting every stroke in each history step by @hm21 in https://github.com/hm21/pro_image_editor/pull/895
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.14.0...v14.14.1
maxDecimalPlaces and enableMinify, and a merged paint layer that lost strokes no longer gets them back on import.feat(layers): show a layer only inside a shape by @hm21 in https://github.com/hm21/pro_image_editor/pull/894
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.13.1...v14.14.0
Layer.mask to show a layer only inside an ellipse, a rounded rectangle or a heart, or faded out across a soft linear edge; LayerMaskBox applies it to any widget and LayerMask.toImage renders it as an alpha matte.fix(main-editor): let maybePop close the editor right after done by @hm21 in https://github.com/hm21/pro_image_editor/pull/892
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.13.0...v14.13.1
maybePop right after editing is done; the fading loading dialog no longer blocks it.feat(text-editor): allow submit shortcuts by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/889
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.12.0...v14.13.0
TextEditorConfigs.enableSubmitShortcut to save the text with Ctrl+Enter or Cmd+Enter.feat(layers): let the host capture layers it does not need at full resolution smaller by @hm21 in https://github.com/hm21/pro_image_editor/pull/891
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.11.1...v14.12.0
ImageGenerationConfigs.layerCapturePixelRatio lets the host capture individual layers at a lower pixel ratio.fix(import-export): keep widget layer settings changed after the layer was added by @hm21 in https://github.com/hm21/pro_image_editor/pull/890
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.11.0...v14.11.1
exportConfigs changed after the layer was added survive a history export and import instead of reverting to their first value.feat(main-editor): reorder layers within the current history step by @hm21 in https://github.com/hm21/pro_image_editor/pull/887
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.10.2...v14.11.0
moveLayerListPosition takes skipUpdateHistory to reorder layers within the current history step and redraws them in their new order.moveLayerListPosition ignores a newIndex past the last layer instead of throwing a RangeError.fix(main-editor): report the tune editor to the sub-editor callbacks by @hm21 in https://github.com/hm21/pro_image_editor/pull/886
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.10.1...v14.10.2
onOpenSubEditor, onStartCloseSubEditor and onEndCloseSubEditor report the tune editor as SubEditor.tune instead of SubEditor.unknown.fix(paint-editor): erase under the pointer when the layer stack is scaled by @hm21 in https://github.com/hm21/pro_image_editor/pull/885
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.10.0...v14.10.1
feat(layers): move, scale, turn and fade layers between keyframes by @hm21 in https://github.com/hm21/pro_image_editor/pull/884
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.9.0...v14.10.0
Layer.keyframes to move, scale, turn and fade a layer over time in the video editor, matching pro_video_editor 2.29.0; transform gestures edit the keyframe at the playhead.LayerKeyframe.effects to play loop animations between two keyframes (Layer.keyframeEffects).Layer.opacity for every layer type; captureAsPng bakes it in and captures keyframed layers at their largest size.setLayerTimeline takes keyframes, replaceLayer takes skipUpdateHistory; add LayerTimelineConfigs.keyframeTolerance.feat(layers): reveal text letter by letter or word by word, add wiggle, bounce and loop animations by @hm21 in https://github.com/hm21/pro_image_edito
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.8.0...v14.9.0
LayerAnimationType.typewriter and wordByWord to reveal a text layer letter by letter or word by word, exported as one image per step in ExportedLayer.revealBytes.LayerAnimationType.wiggle, bounce and AnimationPhase.loop, matching pro_video_editor 2.27.0.RoundedBackgroundText.visibleLength to draw only the start of a text while laying out all of it.pro_video_editor export.feat(paint-editor): measure censor areas in their own pixels and give each its own strength by @hm21 in https://github.com/hm21/pro_image_editor/pull/
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.7.0...v14.8.0
CensorConfigs.pixelateInLayerSpace to measure pixelate blocks in the censor area's own pixels, so they scale with the layer like the blur does.PaintedModel.censorStrength and PaintEditor.setCensorStrength to give each censor area its own blur sigma or pixel block size.feat(text-editor): wrap text layers at the canvas edges by @hm21 in https://github.com/hm21/pro_image_editor/pull/881
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.6.2...v14.7.0
TextEditorConfigs.layerBounds to wrap text layers at the canvas edges instead of letting them run past them when scaled up or moved.RoundedBackgroundText.maxWidth and softMaxWidth to limit the width of the whole widget.fix(layers): stop hidden timed layers from catching touches by @hm21 in https://github.com/hm21/pro_image_editor/pull/877
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.6.1...v14.6.2
fix(main-editor): keep layers on the image point when cropping and re… by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/874
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.6.0...v14.6.1
editorBodySize.feat(layers): highlight parts of a text layer while the video plays through them by @hm21 in https://github.com/hm21/pro_image_editor/pull/876
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.5.0...v14.6.0
TextLayer.highlights / highlightColor to light up words of a text layer while the video plays through them; ExportedLayer.highlightBytes and ExportedLayer.frames carry them into the export (#876).feat(text-editor): add an outline to text layers and scale shadows with the text by @hm21 in https://github.com/hm21/pro_image_editor/pull/875
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.4.1...v14.5.0
TextLayer.outlineWidth / outlineColor and TextEditorState.setOutline to outline text; its shadows are cast by the outlined glyphs.scale and fontScale like the text, instead of keeping their unscaled offset and blur.TextEditorStyle.inputShadows: null, the input previews the shadows at the size the layer draws them.height.fix(crop-rotate-editor): ignore setState after dispose and color undo/redo with appBarColor by @hm21 in https://github.com/hm21/pro_image_editor/pull/
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.4.0...v14.4.1
Bad state: Cannot add new events after calling close (#858).setState calls that arrive after dispose.appBarColor instead of a hardcoded white (#856).perf(filter-editor): skip the identity color filter and per-frame rebuilds by @hm21 in https://github.com/hm21/pro_image_editor/pull/872
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.3.1...v14.4.0
ColorFilterLayer when no filter or tune adjustment is active, and stop rebuilding the filter on every video frame (#872).filterStates or play-time notifier is replaced.fix(main-editor): skip replacing a background screenshot when the lis… by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/870
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.3.0...v14.3.1
WidgetLayer without exportConfigs no longer throws when background or isolate generation is off, and rasterizes it once as PNG instead of once per history step (#870).ci: test the Flutter 3.44 leg against the material_ui floor by @hm21 in https://github.com/hm21/pro_image_editor/pull/869
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.2.0...v14.3.0
TuneEditorWidgets.slider now receives the value it reported through onChanged instead of the value from the last drag end.TuneEditorStyle.bottomBarActiveItemDecoration to decorate the selected bottom bar item.localizationsDelegates an app that still uses the SDK MaterialApp needs so the editor's material_ui widgets find their localizations.perf(layers): draw static paint layers from a cached raster by @hm21 in https://github.com/hm21/pro_image_editor/pull/867
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.1.1...v14.2.0
MainEditorConfigs.enablePaintLayerRasterCache, which draws static paint layers from a cached raster instead of re-stroking them on every frame.fix(layers): keep a slide's start point in step with the layer on canvas resize by @hm21 in https://github.com/hm21/pro_image_editor/pull/866
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.1.0...v14.1.1
slideFrom point now follows the layer when the canvas is resized or a state history recorded at another size is imported. Only Layer.offset was rescaled before, so the preview travelled a different distance than the one the point was placed for.feat(layers): let a layer slide animation start from a point of its own by @hm21 in https://github.com/hm21/pro_image_editor/pull/865
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v14.0.0...v14.1.0
LayerAnimation.slideFrom to start a slide from a point of your own instead of a canvas edge. It uses the same coordinates as Layer.offset, may sit outside the canvas, and overrides slideDirection.perf(paint-editor): stop paint layers from burning CPU per hit test by @hm21 in https://github.com/hm21/pro_image_editor/pull/863
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.5.0...v14.0.0
package:flutter/material.dart and package:flutter/cupertino.dart to the standalone material_ui and cupertino_ui packages, which Flutter is decoupling from the SDK. Apps must migrate their own imports as well (dart fix --apply --code=migrate_design_widgets), because types such as ThemeData are no longer interchangeable with the SDK ones.feat(helper-lines): add smart alignment and paint snap opt-out by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/860
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.4.0...v13.5.0
HelperLineConfigs.enableSmartAlignment (opt-in) so same-type layers snap matching edges, mixed types snap center to center, and only nearby or shared axes act as guides. Tune the reach via smartAlignmentNeighborLimit and smartAlignmentSharedAxisMin.HelperLineConfigs.enablePaintLayerSnapping to exclude paint layers from snapping.feat(paint-editor): allow zoom while drawing by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/857
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.3.1...v13.4.0
PaintEditorConfigs.enableZoomWhileDrawing (opt-in). Pinch, trackpad and mouse wheel zoom; secondary/middle mouse buttons pan.HelperLineConfigs.enableEdgeSnapping to let text and paint layers snap from their center only instead of from every edge.fix(crop-rotate): stop crop handles, pinch and tilt from jumping by @hm21 in https://github.com/hm21/pro_image_editor/pull/855
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.3.0...v13.3.1
feat(layers): rasterize layers outside a live editor session by @hm21 in https://github.com/hm21/pro_image_editor/pull/853
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.2.3...v13.3.0
LayerRasterizer and LayerRasterizerHost.feat(layer-interaction): enhance alignment guide behavior during drag interactions by @hm21 in https://github.com/hm21/pro_image_editor/pull/852
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.2.2...v13.2.3
fix(main-editor): ignore spurious scale-end on mid-gesture pointer change (#850) by @hm21 in https://github.com/hm21/pro_image_editor/pull/851
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.2.1...v13.2.2
_dependents.isEmpty assertion (#850).fix(text-editor): reserve hit-box padding in editing preview so the text box doesn't jump on done by @hiake21cUs in https://github.com/hm21/pro_image_
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.2.0...v13.2.1
feat: combine paint layers + flatten filters by @hm21 in https://github.com/hm21/pro_image_editor/pull/847
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.1.0...v13.2.0
mergeSelectedLayers() / canMergeSelectedLayers. PaintLayer now holds multiple items, baking each source transform into a shared frame so the drawing looks identical after merging.FilterState via mergeFilters() / canMergeFilters (appearance-identical; skipped for video-timeline filters).chore: migrate Android module to Flutter's built-in Kotlin and update version to 13.1.0 by @hm21 in https://github.com/hm21/pro_image_editor/pull/846
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v13.0.0...v13.1.0
feat(tune)!: replace luminance with tint, remove sharpness, fix colorOverlay/fade by @hm21 in https://github.com/hm21/pro_image_editor/pull/844
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.11.1...v13.0.0
luminance control (which only desaturated) with a real tint green–magenta adjustment, the natural complement to temperature.colorOverlay tinting towards the complementary color instead of the overlay color (inverted sign), and rebuild fade as a proper fade (lower contrast + lifted black point) instead of a desaturation.sharpness control (a per-pixel color matrix cannot sharpen) and rename luminance → tint across ColorFilterAddons, TuneEditorIcons and I18nTuneEditor; saved histories using the old tune ids are no longer recognized.fix(layers): anchor timeline scale animation on layer visual center by @hm21 in https://github.com/hm21/pro_image_editor/pull/843
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.11.0...v12.11.1
scale layer animation on the layer's visual center. Combining scale with a slide (e.g. slide-in from the top) previously drifted the layer in diagonally instead of straight, because scaling used the layout-box center while the layer content is painted off-center.Nothing published for this version
feat(crop-rotate): perspective tilt/skew with auto-zoom bounds (#525) by @hm21 in https://github.com/hm21/pro_image_editor/pull/842
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.10.0...v12.11.0
CropRotateTool.tilt with rotate/horizontal/vertical rulers (TiltConfigs); the crop stays inside the tilted image via auto-zoom, and tilt is hidden in the video editor by default.feat(helper-lines): custom snapping guides + edge snapping for text & paint (#833, #834) by @hm21 in https://github.com/hm21/pro_image_editor/pull/841
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.9.0...v12.10.0
HelperLineConfigs.customGuides accepts a list of HelperGuideLines (vertical or horizontal, positioned with absolute editor-body pixels or a normalized 0.0-1.0 fraction) that participate in layer snapping and are drawn - using the new HelperLineStyle.customGuideColor - while a layer snaps to them. Useful for safe areas, thirds, columns or any layout-specific alignment points. See the new Custom-Guide-Lines example.feat(editors): support onKeyboardEvent & enableKeyboardShortcuts in sub-editors (#837) by @hm21 in https://github.com/hm21/pro_image_editor/pull/840
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.8.2...v12.9.0
onKeyboardEvent callback is now available on every standalone editor's callbacks (crop-rotate, paint, filter, tune, blur) via StandaloneEditorCallbacks; returning true consumes the event and skips the built-in shortcut. The crop-rotate and paint editors additionally gain an enableKeyboardShortcuts option (default true) to disable their built-in shortcuts (e.g. R/F in the crop-rotate editor). Previously these callbacks and the option only affected the main editor, so the crop-rotate R/F shortcuts could not be intercepted or disabled.fix(crop-rotate): honor initAspectRatio for the initial oval cropper (#828) by @hm21 in https://github.com/hm21/pro_image_editor/pull/839
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.8.1...v12.8.2
initAspectRatio for the oval cropper in the main editor's initial state. Opening the editor directly in CropMode.oval with a fixed initAspectRatio (e.g. 1.0) previously rendered and exported an ellipse stretched to the full image bounds for non-square images, because the initial (un-transformed) state never consulted initAspectRatio and fell back to the full image aspect ratio. The initial oval mask now uses a centered crop of the requested ratio in the overlay, the capture overlay and the export clip (so 1.0 produces a circle), while a free (-1) or original (0.0) ratio keeps the previous full-image behavior.fix(crop-rotate): cover image edge with crop overlay when panned (#776) by @hm21 in https://github.com/hm21/pro_image_editor/pull/838
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.8.0...v12.8.1
One column per month.