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 10 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(layers): make video-timeline slide layer animation edge-aware to ensure off-center layers leave the visible area completely by @hm21 in https://gi
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.7.0...v12.8.0
slide layer animation edge-aware. Previously the layer was only translated by its own width/height (a single layer size), so a layer that did not sit against the canvas edge stayed partially visible while sliding in/out. The slide now uses the layer's center and the canvas size to push the layer's nearest edge exactly onto (or off) the canvas border, so off-center layers leave the visible area completely. The preview math mirrors the matching native renderer change in pro_video_editor (ApplyAnimation.kt / ApplyAnimation.swift). Use this together with the corresponding pro_video_editor release so the in-editor preview keeps matching the exported video. Prerelease.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
feat: Add per-layer animations support for PaintLayer, TextLayer, and WidgetLayer by @hm21 in https://github.com/hm21/pro_image_editor/pull/835
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.6.0...v12.7.0
LayerAnimation model (type fade/slide/scale, phase animateIn/animateOut/animateInOut, duration, curve, optional slideDirection and scaleFrom) can be attached to any layer via the new Layer.animations list (or set on an existing layer through ProImageEditor.setLayerTimeline(animations: …)), mirroring the pro_video_editor model so the in-editor preview matches the exported result. The video-layer-timeline preview is now phase-aware: it composes fade (opacity), slide (per-direction translation) and scale effects across a layer's enter and exit windows, so the enter and leave phases can use distinct animation types. The legacy enterDuration / exitDuration / enterCurve / exitCurve fade fields are kept as a back-compat convenience and can be read as a unified animation list via Layer.effectiveAnimations. animations is serialized in toMap / fromMap and carried through copyWith, equality and layer cloning. Non-breaking, additive change.Nothing published for this version
feat(import-export): add optional widgetLoader and widgetRecords parameters to CompleteParameters for improved layer reconstruction by @hm21 in https:
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.5.3...v12.6.0
widgetLoader (and widgetRecords) parameters to CompleteParameters.fromMap and CompleteParameters.fromJson so widget/sticker layers exported with an exportConfigs.id can be reconstructed. This is a non-breaking, additive change; existing callers are unaffected.Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.5.2...v12.5.3
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.5.2...v12.5.3
fix: prevent layer scale compounding during multiple layer additions in paint sessions by @hm21 in https://github.com/hm21/pro_image_editor/pull/831
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.5.1...v12.5.2
Nothing published for this version
feat(interactive-viewer): add clip behavior configuration for interactive content by @hm21 in https://github.com/hm21/pro_image_editor/pull/830
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.5.0...v12.5.1
interactiveViewerClipBehavior option to MainEditorConfigs (default Clip.hardEdge) to control clipping of the editor's interactive content area.feat(crop-rotate): keep aspect ratio orientation on rotate by @hm21 in https://github.com/hm21/pro_image_editor/pull/829
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.8...v12.5.0
enableKeepAspectRatioOnRotate option to keep the selected aspect ratio orientation when rotating (e.g. 9:16 stays 9:16 instead of becoming 16:9), zooming the image in so it still fully covers the crop area.chore: update Flutter version and fix deprecated APIs by @hm21 in https://github.com/hm21/pro_image_editor/pull/827
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.7...v12.4.8
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.6...v12.4.7
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.6...v12.4.7
supabase_flutter dependency to 2.14.1.fix(darwin): broken SPM implementation by @jonafeucht in https://github.com/hm21/pro_image_editor/pull/826
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.5...v12.4.6
fix(layer): improve exported layer resolution to avoid blurry output (#820) by @hm21 in https://github.com/hm21/pro_image_editor/pull/824
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.4...v12.4.5
FilterQuality.high when rendering layer images with transforms.fix(layer): improve exported layer resolution to avoid blurry output by @hm21 in https://github.com/hm21/pro_image_editor/pull/820
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.3...v12.4.4
fix: update activeFilters and activeTuneAdjustments to directly use historyPointer by @hm21 in https://github.com/hm21/pro_image_editor/pull/819
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.2...v12.4.3
feat: implement replaceHistory() method to allow replacing history entries in the stack by @hm21 in https://github.com/hm21/pro_image_editor/pull/818
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.1...v12.4.2
replaceHistory() to replace an existing history entry in the stack (current pointer by default, or a custom index).Nothing published for this version
fix: resolve stateHistory and generation issues by @hm21 in https://github.com/hm21/pro_image_editor/pull/817
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.4.0...v12.4.1
captureImageOnDone to MainEditorConfigs (default true) to make final captureEditorImage() on done optional._isProcessingFinalImage from getting stuck by guarding done-flow cleanup with try/finally.feat: refactor audio handling to support multiple audio tracks and deprecate customAudioTrack by @hm21 in https://github.com/hm21/pro_image_editor/pul…
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.3.6...v12.4.0
volume, loop, audioStartTime, audioEndTime, and endTime fields to AudioTrack.audioTracks field (List<AudioTrack>) to CompleteParameters for multiple audio track support.customAudioTrack — use audioTracks instead.enableLoop parameter in AudioTrack.copyWith — use loop instead.feat: export user-defined metadata in CompleteParameters by @hm21 in https://github.com/hm21/pro_image_editor/pull/815
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.3.5...v12.3.6
meta field in CompleteParameters so user-defined metadata is available in the onCompleteWithParameters callback.feat: add optional initialization delay for background processor setup by @hm21 in https://github.com/hm21/pro_image_editor/pull/814
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.3.4...v12.3.5
initializationDelay to ProcessorConfigs to optionally defer isolate/thread startup and avoid jank during page transition animations.fix: preserve active filters, tune adjustments, and metadata in history management by @hm21 in https://github.com/hm21/pro_image_editor/pull/811
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.3.3...v12.3.4
filters, tuneAdjustments, and meta in addHistory() when values are not explicitly provided.filters/tuneAdjustments/meta in history entries to prevent shared-reference mutations across undo/redo states.Nothing published for this version
Nothing published for this version
Nothing published for this version
feat: add unique identifier support to FilterState class by @hm21 in https://github.com/hm21/pro_image_editor/pull/810
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.3.2...v12.3.3
id to FilterState, export/import it, and generate backward-compatible IDs when missing in older history payloads.feat: add filter name support by @hm21 in https://github.com/hm21/pro_image_editor/pull/809
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.3.1...v12.3.2
name field to FilterState to carry the filter name through the editor, history, and import/export.activeMeta as a public field, updated on every undo/redo alongside activeLayers.feat: enhance export functionality with user-defined metadata and improved layer capture resolution by @hm21 in https://github.com/hm21/pro_image_edit
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.3.0...v12.3.1
meta field (Map<String, dynamic>) to EditorStateHistory for user-defined data that is preserved across undo/redo and import/export.basePixelRatio parameter to captureAsPng, captureAllLayers, and captureAllLayersWithMeta for image-relative layer export resolution.captureAsPng works for timeline-dismissed layers.imageInfos.pixelRatio instead of device pixel ratio for layer capture in doneEditing, ensuring correct export resolution relative to the source image.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: add timeline support for filters and tune adjustments, including metadata handling by @hm21 in https://github.com/hm21/pro_image_editor/pull/807
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.2.2...v12.3.0
meta field to FilterState and TuneAdjustmentMatrix for storing arbitrary metadata on filters and tune adjustments.copyWith() to FilterState and TuneAdjustmentMatrix.setFilterTimeline() and setTuneTimeline() methods for updating timeline properties of filters and tune adjustments.skipUpdateHistory in setFilterTimeline() and setTuneTimeline() for live trimming without history overhead.setLayerTimeline with skipUpdateHistory now copies only the affected layer instead of the entire layer list.setLayerTimeline entirely when no values would change.activeFilters and activeTuneAdjustments to public fields.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: expose public methods for editing layers by @hm21 in https://github.com/hm21/pro_image_editor/pull/806
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.2.1...v12.2.2
editTextLayer, editPaintLayer, applyTextLayerChanges, removeFilter, and clearFilters as public methods.editTextLayer, editPaintLayer, applyTextLayerChanges, removeFilter, and clearFilters.fix: recalculate layer visibility on time changes by @hm21 in https://github.com/hm21/pro_image_editor/pull/805
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.2.0...v12.2.1
startTime, endTime, enterDuration, or exitDuration change while the video is paused.feat: add timeline support for layers and tune adjustments by @hm21 in https://github.com/hm21/pro_image_editor/pull/804
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.1.0...v12.2.0
startTime, endTime, enter/exit durations and curves.filterStates, tuneAdjustments, and capturedLayers to CompleteParameters. Add captureLayersOnDone config to MainEditorConfigs.chore: add GitHub release workflow to automate releases by @hm21 in https://github.com/hm21/pro_image_editor/pull/801
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.0.13...v12.1.0
Layer.captureAsPng() for single layers or Layer.captureAllLayers() for batch export with shared isolate reuse. The main editor exposes captureAllLayers() and captureAllLayersWithMeta() convenience methods.ExportedLayer model containing the source layer, encoded image bytes, and logical size metadata.FEAT(text-editor): Add composingTextDecoration to TextEditorConfigs to control the text decoration of the IME composing region. Defaults to TextDecora
composingTextDecoration to TextEditorConfigs to control the text decoration of the IME composing region. Defaults to TextDecoration.none to remove the underline shown when enableSuggestions is active.feat(text-editor): add spellCheckConfiguration to TextEditorConfigs for enabling spell checking by @hm21 in https://github.com/hm21/pro_image_editor/p
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.0.11...v12.0.12
spellCheckConfiguration to TextEditorConfigs for enabling spell checking in the text input field.feat(helper-lines): allow lines override by @saif-ellafi in https://github.com/hm21/pro_image_editor/pull/794
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.0.10...v12.0.11
inputLetterSpacing and inputShadows to TextEditorStyle for customizing letter spacing and text shadows.onLayerInteractionEnd callback to MainEditorCallbacks, triggered when layer interaction ends.BottomAppBar SafeArea gap in sub-editors.FIX(iOS, macOS): Restore CocoaPods compatibility for the native Darwin plugin alongside Swift Package Manager support.
Nothing published for this version
FIX(text-editor): Disable system text scale factor in RoundedBackgroundTextField to ensure consistent text sizing regardless of user accessibility set
RoundedBackgroundTextField to ensure consistent text sizing regardless of user accessibility settings.PERF(paint-editor): Optimize freestyle path building by reducing redundant moveTo calls, eliminating intermediate list allocations, and using distance
moveTo calls, eliminating intermediate list allocations, and using distanceSquared instead of distance.Opacity widget wrapping when layer opacity is 1.0.done() with Map-based O(1) lookup.updateActiveItems() calls via new skipUpdateActiveItems parameter on addHistory().feat(text-editor): add configurable leadingDistribution to TextEditorStyle by @faizahmaddae in https://github.com/hm21/pro_image_editor/pull/789
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.0.6...v12.0.7
leadingDistribution property to TextEditorStyle for configuring how extra line height is distributed. Use TextLeadingDistribution.even to vertically center text within rounded background rects at non-default line heights. Defaults to proportional for backward compatibility.FEAT(platform): Add shared Darwin (iOS/macOS) native plugin implementation using Swift Package Manager.
FEAT(editor-audio): Add safeFilePath method to EditorAudio that returns a file path for the audio source. For file sources, it returns the path direct
safeFilePath method to EditorAudio that returns a file path for the audio source. For file sources, it returns the path directly. For memory, asset, and network sources, it writes the data to a temporary file. File extension is automatically extracted from asset paths and network URLs.Nothing published for this version
fix(isolate-manager): add stub implementation for web/WASM platforms by @hm21 in https://github.com/hm21/pro_image_editor/pull/785
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.0.3...v12.0.4
dart:isolate import. The IsolateManager is now loaded via a conditional import, so web/WASM builds use a stub that falls back to single-threaded processing.Nothing published for this version
feat(crop-rotate-editor): add helperLineWidth to customize grid line thickness by @hm21 in https://github.com/hm21/pro_image_editor/pull/783
Full Changelog: https://github.com/hm21/pro_image_editor/compare/v12.0.2...v12.0.3
exportOvalMask to CropRotateEditorConfigs (default true). When set to false, the exported image uses a plain rectangular crop even if CropMode.oval is active, while the oval UI remains visible inside the crop editor.helperLineWidth to CropRotateEditorStyle, allowing the grid line thickness to be customized or hidden entirely by setting it to 0.One column per month.