NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #2953 most downloaded on pub.dev
An easy to use side menu (navigation rail) in flutter and can used for navigation
Last release 4 months ago
21 May 2026
Release timing varies
gaps range from 2 weeks to 12 months
Nearly every release is documented
notes for 16 of 16 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
16 releases · first in 2021
One column per quarter.
MIGRATION.md documents every breaking change with before/after examples
This is a full rewrite. See MIGRATION.md for a step-by-step upgrade guide.
>=3.4.0, Flutter >=3.22.0provider removed: no longer a transitive dependencySideMenuStyle removed: replaced by SideMenuThemeData (a ThemeExtension)SideMenuController: now extends ChangeNotifier; changePage(i) → goTo(i), currentPage → currentIndex, stream-based listener removedSideMenuItemType interface renamed to SideMenuItemBaseSideMenuExpansionItem.initialExpanded renamed to initiallyExpandedSideMenuItem.badgeContent renamed to badge; badgeColor removed (style the badge widget directly)SideMenuItemWithGlobal, Global, DisplayModeNotifier removed from public exportsSideMenuThemeData is a full ThemeExtension — register once in ThemeData.extensions for app-wide defaults, or pass to SideMenu.theme per-widgetmenuDecoration: BoxDecoration? — full decoration control (gradient, shadow, border) for the menu containerbackdropSigma: double? — enables glassmorphism via BackdropFilter; wrap the menu in a transparent menuDecoration to see through to the backgroundselectedItemDecoration: BoxDecoration? — full decoration for the selected item (gradient pill, left-border indicator, glow)SideMenuThemeData.resolve(context) — fills null fields from the ambient ColorScheme/TextTheme (Material 3)SideMenu.height now stretches to available space (double.infinity) so the widget works correctly inside a Padding wrapperdispose() — no more widget-test timer leaksSideMenuExpansionItem children receive correct stable flat indices via SideMenuItemIndex InheritedWidgetprovider dependency dropped entirelySideMenuScope (InheritedNotifier) replaces provider globalsMIGRATION.md documents every breaking change with before/after examplesFix: Preserve menu state on hot reload #89
Refactored the Global class to extend ChangeNotifier.
Global class to extend ChangeNotifier.itemsUpdate MechanismSideMenuItemType as a base interface for SideMenuItem and SideMenuExpansionItem.SideMenuExpansionItem: add onTap event by @kwavnet in #85
Full Changelog: 0.6.0...0.6.1
New Features
SideMenuExpansionItem #85Removed Badge dependencies and use Flutter builtin Badge
Fix RTL issues
fix: fix width not being returned on 2nd load by @Coder-Manuel in #61
Full Changelog: 0.5.0...0.6.0
Braking : priority has been removed from SideMenuItem
SideMenuItemSideMenuItemBadge import conflict by @hemangjoshi37a in #43Full Changelog: 0.4.0...0.5.0
SideMenuItemSideMenuItemFix issue #46: the width is not properly calculated when the widget is drawn a second time - #58
Custom builder available for SideMenuItem
SideMenuItemFix Badge error on flutter 3.7.0
fix unnecessary null checks in flutter 3.0.0 and above by @gnassro in #11
Full Changelog: 0.3.0...0.4.0
Fix null exception on onDisplayModeChanged
onDisplayModeChangedWidgetsBinding.instance null checker in flutter 3Add listener to SideMenuDisplayMode changed
flutter_lints by @myConsciousness in #8Full Changelog: 0.2.0...0.3.0
SideMenuDisplayMode changedAdd decoration to SideMenuStyle
decoration to SideMenuStyleadd badge support to the sidemenu
* Add readme to package
First release of easy_sidemenu
Your coding agent can read these notes before it upgrades. Set up the MCP server →