NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #1942 most downloaded on pub.dev
Create and display a customizable context menus in your app.
Last release 7 months ago
26 Feb 2026
Release timing varies
gaps range from 8 days to 10 months
Most releases are documented
notes for 13 of 15 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
15 releases · first in 2023
One column per quarter.
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com
MenuEntryWidget state (Fixes #50, #51)Hover Behavior: Fixed hover state management in menu items to prevent items from remaining highlighted after mouse exit (Fixes #45)
BuildContextExtensions to dedicated build_context_ext.dartSingleActivatorExtensions to single_activator_ext.dartitems parameter in MenuItem.submenu constructor for better code organizationMenuItem.label changed from String to Widget.
MenuItem.label changed from String to Widget.MenuItem.icon changed from IconData? to Widget?.MenuItem.color renamed to MenuItem.textColor.ContextMenuRegion.enableGestures renamed to enableDefaultGestures.ContextMenuRegionBuilder: the showMenu callback changed from void Function() to
void Function(Offset position).ContextMenuItem.onSelected changed from VoidCallback? to ValueChanged<T?>? — the callback
now receives the selected value.ContextMenuItem.items changed from List<ContextMenuEntry>? to List<ContextMenuEntry<T>>?.ContextMenuState is now generic (ContextMenuState<T>). Custom ContextMenuEntry subclasses
that reference ContextMenuState directly must add the type parameter.ContextMenuRegion.onItemSelected changed from ValueChanged<T>? to ValueChanged<T?>?.shortcut) and trailing widgets (trailing) in
MenuItem. (closes #33)SingleActivatorExtensions for human-readable shortcut strings (e.g., "Ctrl+O").onItemSelected callback on ContextMenuRegion and showContextMenu for immediate selection
handling without awaiting the route result.kMenuItemHeight and kMenuItemIconSize constants for consistent MenuItem layout.mediaQuery extension on BuildContext to simplify MediaQuery access.ContextMenu<T>, ContextMenuItem<T>, ContextMenuEntry<T>, and
ContextMenuState<T> are now strongly typed throughout.spawnAnchor for submenus to improve positioning.debugLabel now uses describeIdentity for consistent element identification, and MenuItem
includes its label in the output.ContextMenuWidgetView for cleaner separation of concerns.showContextMenu now uses the root navigator by default, ensuring the menu displays above
nested navigators and preventing multiple instances. (Fixes #21)hasSameFocusNodeId, getScreenRect, and parentMenuKey.See https://dart.dev/go/flutter-upper-bound-deprecation
The Flutter SDK constraint in pubspec.yaml has been changed from ^3.27.0 to >=3.27.0.
Solving the issue:
The Flutter constraint should not have an upper bound.
In your pubspec.yaml the constraint is currently ^3.27.0.
You can replace that with just the lower bound: >=3.27.0.
requestFocus parameter has been added to MenuRouteOptions and is utilized in the
showMenu helper function.ContextMenuWidget, MenuHeader, and MenuItem to use Color.withValues().sdk: ^3.6.00.2.6 instead.Replaced Color.withValues() with color.withOpacity() for compatibility with Flutter 3.0–3.26.
Color.withValues() with color.withOpacity() for compatibility with Flutter 3.0–3.26.ContextMenuWidget, MenuHeader, and MenuItem work on older Flutter versions.sdk: '>=3.0.0 <3.6.0'Refactor: Improve/Fix submenu positioning logic.
FIX: enable/disable context menu based on web platform.
Fix context menu is not showing in web (closes #7 ).
Add generic types to base classes and widgets (closes #3 ).
README.md.ContextMenuRegion for simplified gesture handling. (closes #4)ContextMenuRegion to be more customizable with builder. (closes #6)Add maybeOf to the context menu state
maybeOf to the context menu statecalculateSubmenuPosition to utils.dartcolor variable to the context menu item, allowing the item text and icon colors to be
customized.enabled variable to the context menu item, allowing the item to be disabled if needed.maybeOf(BuildContext) to the context menu state.calculateSubmenuPosition to the utils file (lib/src/core/utils.dart).Removed provider and equatable dependencies as they are no longer needed.
provider and equatable dependencies as they are no longer needed.Overlay widget with the new OverlayPortal widget.shortcuts property in the ContextMenu class for custom context menu shortcuts.added ContextMenuRegion widget to show a context menu when a user right-clicks or long-presses on a widget.
ContextMenuRegion widget to show a context menu when a user right-clicks or long-presses
on a widget.README.md.added a preview gif to "README" file.
DefaultContextMenuDivider in components.DefaultContextMenuItem in components.DefaultContextMenuTextHeader in components.Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →