NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1843 most downloaded on pub.dev
A popover is a transient view that appears above other content onscreen when you tap a control or in an area.
Latest stable
0.5.1
Last release 1 months ago
12 Oct 2026
Release timing varies
gaps range from 3 weeks to 1.2 years
Nearly every release is documented
notes for 27 of 27 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
27 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Text between the grays Color(0xFF858585) and Color(0xFF9D9D9D) in luminance, such as #8E8E93 , #999999 or the iOS system blue #0A84FF , now gets the d
Color(0xFF858585) and Color(0xFF9D9D9D) in luminance, such as #8E8E93, #999999 or the iOS system blue #0A84FF, now gets the dark background by default instead of the light one. The switch moved from a luminance of 0.34 to 0.23, where the text has the same contrast against both backgrounds. #999999 text was 2.9:1 on the white triangle and is 4.9:1 on the dark one.showPopover no longer takes key or the deprecated isParentAlive . PopoverTransitionBuilder , the type of popoverTransitionBuilder , is now exported. T…
PopoverStyle, passed as style: to showPopover and Popover: arrowStyle, backgroundColor, brightness, barrierColor, radius, shadow, arrowWidth, arrowHeight, transition and transitionDuration. The new PopoverTheme sets a style for a whole subtree, and the style at the call wins over it. showPopover no longer takes key or the deprecated isParentAlive. PopoverTransitionBuilder, the type of popoverTransitionBuilder, is now exported. The README has a before and after.package:flutter/widgets.dart and works with package:flutter/material.dart, package:flutter/cupertino.dart, package:material_ui and package:cupertino_ui. 0.4.0 threw No MaterialLocalizations found in a CupertinoApp (#113).(thanks @livtanong).
Material. Wrap it in the Material of your UI library if it contains Material widgets that require one, such as InkWell, ListTile, TextField, Checkbox or Switch, with MaterialType.transparency so the glass background shows.barrierLabel defaults to 'Dismiss' instead of MaterialLocalizations.modalBarrierDismissLabel. Pass a localized label if you need one.Theme, DefaultTextStyle, IconTheme and others) are captured from the calling context and applied to the body. The body text and icon styles are the ones in effect at context: the AppBar foreground color when opened from an AppBar action, and MaterialApp's red debug text without a Material ancestor. A Material around the body resets the text to textTheme.bodyMedium.backgroundColor is painted once under the body instead of twice, so the body looks more transparent than before.UIPopoverPresentationController and NSPopover measured on iOS 26 simulators and macOS 26.
NSPopover.width, height and constraints are capped by the space available.triangle arrow stops short of the rounded corners. The apple arrow merges into a nearby corner, as UIKit and AppKit do.arrowStyle style field takes PopoverArrowStyle.apple, triangle or adaptive, the default, which is apple on Apple platforms and triangle elsewhere. Flutter web follows the host OS here too, so Safari on a Mac or an iPhone gets the apple shape.
apple outline repeats the mask path of UIPopoverPresentationController on iOS 26 element for element: continuous corners with a 34 point radius, a 26 by 13 arrow with a rounded tip and filleted sides, and the corner next to the arrow merging into it. A test compares it with 31 paths dumped from a simulator. Its default shadow, BoxShadow(color: Color(0x6B000000), blurRadius: 210), matches the iOS shadow within one level of brightness.NSPopover outline of macOS 26: 20 point corners, a 25.42 by 13 arrow with an arc for a tip, and AppKit's blend of the arrow into a nearby corner. A test compares it with 171 paths dumped from macOS. The default shadow, BoxShadow(color: Color(0x40000000), blurRadius: 12, offset: Offset(0, 3.6)), is fitted to a screenshot of NSPopover.arrowWidth, arrowHeight, radius and shadow are now nullable and default per style. Set PopoverStyle(arrowStyle: PopoverArrowStyle.triangle) for the previous look.apple shape the default background is the Liquid Glass of iOS 26 and macOS 26, a blur of the content behind with a tint and a light rim, fitted to native popovers captured over 22 backgrounds in light and dark mode. backgroundColor is now nullable, and a color passed in replaces the glass. The triangle default stays white, or Color(0xFF2C2C2E) in dark mode.
brightness style field picks light or dark. By default the background contrasts with the text color the body inherits from context, so an app that forces a light theme on a phone in dark mode gets a light popover. Without an inherited text color it follows the system setting.barrierColor is now nullable. It defaults to transparent for the apple shape, since iOS and macOS do not dim the screen behind a popover, and to Color(0x80000000) for the triangle.BoxShadow in shadow, every shadow after the first was shifted by the popover's position again.apple shape on iOS the popover opens and closes like an iOS 26 popover: it scales up from the arrow tip while its outline grows from 100 points to its full height, then shrinks back. The springs, 494 ms to open and 516 ms to close, are read from the CASpringAnimation objects UIKit attaches to a popover. On macOS it scales up from the tip and fades in on a spring over 440 ms and shrinks back over 200 ms, fitted to a recording of NSPopover. transitionDuration is now nullable, and a duration passed in applies to both directions.skills/popover-usage/SKILL.md, which dart run skills@ get installs for coding agents, and pub.dev topics.Popover widget and PopoverController, which keep a popover in the widget tree with its anchor as child. show, hide and toggle open and close it, and the controller follows when the user closes it.semanticsLabel, which names the popover for screen readers. Tests now cover Esc closing the popover, Tab staying inside it, focus going back to where it was, and screen readers seeing only the popover and its barrier.Mutation Test CI workflow over lib/ that fails below the 75% threshold in mutation_test.xml. It runs in parallel shards and, on a pull request, mutates only the changed declarations.E2E CI workflow that runs the example's integration test on iPhone, iPad, macOS, Windows and Linux, in Chrome and on an Android emulator, with screenshots and rotation.E2E workflow renders a demo image of the example on every platform.Your coding agent can read these notes before it upgrades. Set up the MCP server →
feat: Allow clicking on widgets behind the barrier by @mcquenji in https://github.com/minikin/popover/pull/101
Full Changelog: https://github.com/minikin/popover/compare/v0.3.1...v0.4.0
Full Changelog: https://github.com/minikin/popover/compare/v0.3.0...v0.3.1
Full Changelog: https://github.com/minikin/popover/compare/v0.3.0...v0.3.1
fix: Use logical pixels for popover offset calculation by @zwett in https://github.com/minikin/popover/pull/84
Full Changelog: https://github.com/minikin/popover/compare/v0.2.9...v0.3.0
Update web example to use flutter.js service worker bootstrapping.
fix: Added contentdxOffset by @kasyanyukd1995 in https://github.com/minikin/popover/pull/80
Full Changelog: https://github.com/minikin/popover/compare/v0.2.8...v0.2.9
Fix/popover render by @VictorOhashi in https://github.com/minikin/popover/pull/56
Full Changelog: https://github.com/minikin/popover/compare/v0.2.7...v0.2.8
isParentAlive parameter was deprecated. (thanks @VictorOhashi).fix:background color by @minikin in https://github.com/minikin/popover/pull/60
Full Changelog: https://github.com/minikin/popover/compare/v0.2.8...v0.2.8+1
Fix exception when enabling widget-selection mode in Widget Inspector when the popover is opened by @moescs in https://github.com/minikin/popover/pull
Full Changelog: https://github.com/minikin/popover/compare/v0.2.8+1...v0.2.8+2
Fix_Error_when_parent_removed : DONE by @ajaxspace in https://github.com/minikin/popover/pull/43
Full Changelog: https://github.com/minikin/popover/compare/v0.2.6.2...v0.2.7
popoverTransitionBuilder. Users can provide custom animation transition now. (thanks @sanjidbillah).Fix constraints size for PopoverDirection.top & PopoverDirection.bottom.
PopoverDirection.top & PopoverDirection.bottom.Set minimum dart version to 2.12.0.
Fixed the bug that appears when you change window size while popover is opened (thanks @whitebug).
Fixed the bug that appears when the parent widget from which Popover was presented has been removed from a widget tree (thanks @ajaxspace).
Popover was presented has been removed from a widget tree (thanks @ajaxspace).Recalculate popover shape on context changes.
Parametrs arrowDyOffset, arrowDxOffset and contentDyOffset now can be apply again.
arrowDyOffset, arrowDxOffset and contentDyOffset now can be apply again.Add RouteSettings? routeSettings parameter.
RouteSettings? routeSettings parameter.Rebuild Popover on device orientation changes (thanks @SanekLic, @shcherbuk96).
Lower minimum version requirements for Dart and Flutter to pass pub.dev validation.
- Migrate to NNBD.
BREAKING: Refactor popover implementation to have identical API to included in Flutter modal dialogs e.g. showCupertinoDialog
showCupertinoDialogAdd Key key, barrierDismissible and showPopover.
Key key, barrierDismissible and showPopover.Add arrowDyOffset, arrowDxOffset and contentDyOffset public parameters.
arrowDyOffset, arrowDxOffset and contentDyOffset public parameters.A child widget can be wrapped in InkWell or GestureDetector.
child widget can be wrapped in InkWell or GestureDetector.Add PopoverDirection to exports.
PopoverItem.PopoverDirection to exports.- Initial release.
One column per quarter.