NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2505 most downloaded on pub.dev
Adaptive platform-specific widgets for Flutter. Auto renders native iOS 26+ liquid glass designs, traditional Cupertino widgets for older iOS versions, Material Design for Android.
Latest stable
1.0.2
Last release 1 months ago
08 Oct 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 36 of 36 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
36 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
FIX : iOS 26: the fixed toolbar's automatic back button is now a 44-point circle like the native one, instead of a 38-point rounded square, and sits l
cannot find 'VerticalBarEdgeStreamHandler' in scope, run pod install in your ios/ folderSafeArea stay clear of the bar. The controls start near the top of the pane, since there is no camera there (@sergi-labhouse)SemanticsNode._replaceChildren with a screen reader on. Every layer of the fixed chrome now keeps its semantics attached, and the layer that is not in front is excluded explicitly, so VoiceOver never lands on invisible items. Reported and diagnosed by @Anderzzon (#166)resizeToAvoidBottomInset is now honored on the plain page branch (no app bar, no tab bar) and in the drawer wrapper, so a body anchored to the bottom is no longer lifted above the keyboard when it is set to false (@Danilo-Mota, #158)IndexedStack tab layout showed the bar of the last mounted tab instead of the selected one (@DFelten, #164)AdaptiveRadio is drawn as a ring with an inner dot, as in UIKit, instead of a filled circle (@luflow, #154)borderColor and borderWidth on AdaptiveCard for iOS; the default stays a hairline separator (@luflow, #153)CupertinoTheme.primaryColor instead of a hardcoded system blue (@Qian-Samuel, #121)badgeText, badgeColor and badgeTextColor on AdaptiveNavigationDestination. Arbitrary badge text and colors on the iOS 26+ native tab bar (UITabBarItem.badgeValue / badgeColor), and the same fields drawn through AdaptiveBadge on iOS <26 and Android; a transparent badgeColor with a glyph gives a dot indicator (@terrykang90, #127)menuItems and onMenuItemSelected on AdaptiveAppBarAction turn an app bar action into a menu button: a native UIMenu on iOS 26+ (in the fixed toolbar and the iPhone Duo capsule too), an action sheet on iOS <26, a popup menu on Android (@DFelten, #163)AdaptivePopupMenuDivider(title:) names the group that follows it: an inline section title in the native iOS 26 menu, a heading in the action sheet on iOS <26, a heading row on Android (@luflow, #149)selected on AdaptivePopupMenuItem shows the current choice: the system checkmark in native iOS menus, a trailing check on Android, a leading check in the iOS <26 action sheet (@gem85247, #147)AdaptiveButton in child mode (icon or custom child): minSize is now a minimum instead of a fixed width (a Size(0, h) no longer collapses the button), and the content gets the same 16pt horizontal padding as the other platforms, so such buttons can come out slightly wider than before (@gem85247, #147)traitOverrides.layoutDirection, so the selected Liquid Glass item follows the app locale when it differs from the device locale (@KhalidSaud, #140)AdaptiveContextMenu on iOS 26+ is a native UIContextMenuInteraction with Liquid Glass: the child lifts as the preview and the actions are a UIMenu (title, SF Symbol, disabled, destructive). iOS <26 and Android are unchanged. Pass an SF Symbol name as icon for the iOS 26 menu (@itsatifsiddiqui, #161)iOS26ContextMenuView; CocoaPods users on a path or git dependency may need pod install to pick up the new Swift filesAdaptiveAppBar.actions within the same page now reaches the iOS 26 native toolbar even when the list starts out null. Before, the change only showed after leaving and re-entering the page (#84)AdaptiveScaffold with a native tab bar mounted its body once per destination, so every page's initState ran as many times as there were tabs, and again on each tab switch. The body is now mounted once and kept across tab switches (#76)AdaptiveSwitch on iOS 18 and below is system green again instead of the theme's blue tint, matching every other switch on those versions (#94)AdaptiveScaffold.extendBody lets the body run under a custom floating bottom bar on Android and iOS 18 and below, so the bar's margins show the content instead of the scaffold background (#144)AdaptiveScaffold.backgroundColor sets the page background on every platform, including the iOS 26 native scaffold (#60, #95)AdaptivePopupMenuButton.icon takes iconSize, the glyph's point size on Android, iOS 18 and the iOS 26 native button (#139)AdaptiveTabBarView labels are readable on every background: on Android a custom or transparent backgroundColor now gets contrasting labels instead of white, and on iOS the selected segment's label contrasts with selectedColor (black thumb, white text). unselectedColor now reaches the iOS segments, and selectedLabelColor sets the selected label explicitly (#37)AdaptiveScaffold.backgroundColor also sets the status bar style, so a dark page in a light theme keeps light status icons. A page's own AnnotatedRegion<SystemUiOverlayStyle> still takes precedence (#77)Thanks to everyone who shaped this release with code, reports and reviews: @luflow, @sergi-labhouse, @DFelten, @gem85247, @Anderzzon, @itsatifsiddiqui, @Danilo-Mota, @terrykang90, @KhalidSaud, @Qian-Samuel, @goalbypro, @bryandelgado99, @primer03, @pento, @Crucialjun, @robert-virkus and the reporters of #76, #84, #94, #144, #37, #77, #50, #139, #60 and #95. Who did what is in CONTRIBUTORS.md.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
FIX : 📱 iPhone Duo: the tab bar now lives in the vertical bar , at the bottom of it, the way the system lays it out. In 1.0.0 it stayed at the bottom
spacerAfter), with the back button as a round control on top, matching the system's sizes and spacing. The title moves to the leading edge, and content scrolling under it is blurred and faded like the system's scroll edge effectlabel on AdaptiveAppBarAction, a short name such as "Undo". It names the action in the iPhone Duo overflow menu, for VoiceOver on iOS, and as the tooltip on Android. Unlike title, it never replaces the icon with text. Give every icon action oneicon or iconWidget (no iosSymbol) showed up empty in the vertical baruseNativeBottomBar: false) is left where it is on iPhone Duo; only the native tab bar moves into the vertical barBREAKING : The minimum iOS deployment target is now 15.0 (was 13.0). Xcode 27 no longer builds below 15.0. Set platform :ios, '15.0' in your ios/Podfi
platform :ios, '15.0' in your ios/Podfile and IPHONEOS_DEPLOYMENT_TARGET = 15.0 in the Runner projectAdaptiveApp, every AdaptiveScaffold with AdaptiveAppBar(useNativeToolbar: true) hands its app bar to one fixed toolbar above the navigator. No code change is needed for ordinary pages. AdaptiveAppBar.leading, titleWidget and AdaptiveAppBarAction.iconWidget are now built above the navigator, so they must not look up Navigator.of(context) or page-level inherited widgets from their own context; capture the page's context in the callback instead. useHeroBackButton has no effect while the fixed toolbar is in use, because the back button already stays in place. See "Migrating to 1.0.0" in the READMESafeArea no longer runs underneath the status cluster and the vertical barAdaptiveToolbarHost, for apps that do not use AdaptiveApp. Install it in the app builder. It is router-agnostic: it relies on the widget tree only, not on a NavigatorObserver, so it works with Navigator, GoRouter (including StatefulShellRoute), auto_route, nested navigators and tabsuseFixedToolbar on AdaptiveScaffold (default true). Set it to false for a scaffold that does not fill the screen from the top, such as one pane of a side by side layout, so it keeps its own toolbar. Scaffolds shown in a sheet, dialog or popup do this automaticallyfoldable ^1.0.3 for the iPhone Duo reserved regionsPackage.swift now declares its FlutterFramework dependencyNEW : Custom SF Symbols on iOS. AdaptiveAppBarAction , native buttons, and the tab bar now fall back to a bundle asset ( UIImage(named:) ) when a name
AdaptiveAppBarAction, native buttons, and the tab bar now fall back to a bundle asset (UIImage(named:)) when a name is not a system SF Symbol, so custom symbols or images from the app's asset catalog work (@hieutbui)iconWidget on AdaptiveAppBarAction for a custom fallback widget (e.g. an SVG) on iOS <26 and Android (@hieutbui)AdaptiveNavigationDestination.selectedIcon now accepts a distinct SF Symbol name for the selected state (outline when unselected, filled when selected) (@hieutbui, @philipgiuliani)minuteInterval on AdaptiveTimePicker and AdaptiveDatePicker restricts selectable minutes to a fixed grid (e.g. 15-minute steps). iOS uses the native minuteInterval; Android snaps the picked value onto the grid (@luflow)AdaptiveDatePicker now honors dateAndTime and monthYear modes on Android too, with use24HourFormat support (@luflow)NEW : subtitle and titleWidget on AdaptiveAppBar . Show a smaller subtitle below the title, or replace the title area with any widget. Works on iOS 26
subtitle and titleWidget on AdaptiveAppBar. Show a smaller subtitle below the title, or replace the title area with any widget. Works on iOS 26+ native toolbar (centered overlay), iOS <26 CupertinoNavigationBar, and Material AppBar (@luflow)subtitle and imageBytes on AdaptivePopupMenuItem. Subtitles render natively via UIAction.subtitle on iOS 15+, and image bytes (e.g. avatars) are shown clipped to a circle on iOS 26+ native menus, Material popup menus, and the iOS <26 action-sheet fallback (@luflow)SafeArea/SliverSafeArea inside a page clear the Liquid Glass toolbar automatically, matching how CupertinoPageScaffold handles a translucent navigation bar. Removes the need for per-screen top-offset hacks (@luflow)ThemeMode differs from the system brightness (@luflow)preferredMenuElementOrder = .fixed, so items keep their declared order (@Sahil-Kundaliya)Row, before its native intrinsic width has been measuredNEW: Added resizeToAvoidBottomInset prop to AdaptiveScaffold for explicit control over keyboard-driven scaffold resizing across all platform paths (iO
resizeToAvoidBottomInset prop to AdaptiveScaffold for explicit control over keyboard-driven scaffold resizing across all platform paths (iOS 26+, iOS <26, Android) (@philasmar)NEW: Added ImageProvider support (AssetImage, FileImage, NetworkImage) for AdaptiveBottomNavigationBar icons — including async network image loading w
ImageProvider support (AssetImage, FileImage, NetworkImage) for AdaptiveBottomNavigationBar icons — including async network image loading with caching and circular avatar rendering for iOS 26+ native tab bar (@philasmar)textColor and selectedTextColor props to AdaptiveSegmentedControl for explicit label color customization across iOS 26+, iOS <26, and Android (@philasmar)UIAlertController dim is used (@ctrl-Felix)NEW: Added ImageIcon / AssetImage support for iOS 26+ native tab bar — custom asset icons (with optional per-state selected icon) can now be used alon
ImageIcon / AssetImage support for iOS 26+ native tab bar — custom asset icons (with optional per-state selected icon) can now be used alongside SF Symbols (@Mohamed-7018)Directionality.of(context) (@Mohamed-7018)hideBottomDivider prop to AdaptiveListTile for removing the bottom separator, useful for the last tile in a grouped list (@ctrl-Felix)separatorColor prop to AdaptiveListTile for customizing the iOS bottom separator color (@philasmar)NEW: Added tabBarHidden prop to AdaptiveScaffold to hide the native iOS 26+ tab bar — prevents native UITabBar from bleeding through showModalBottomSh
tabBarHidden prop to AdaptiveScaffold to hide the native iOS 26+ tab bar — prevents native UITabBar from bleeding through showModalBottomSheet (@DmitriiSer)tintColor support for iOS 26+ native toolbar and prominent button style for AdaptiveAppBarAction (@luflow)FIX: Fixed iOS 18 navigation bar not being displayed (@adrianorios)
IMPROVEMENT: Adjusted back button leading position on iOS 26+ native toolbar for better alignment
cupertinoDecoration property to AdaptiveTextField and AdaptiveTextFormField for customizable iOS stylingNEW: Added enableToolbarGradient option to AdaptiveScaffold for iOS 26+ toolbar gradient customization (@nadavfima)
enableToolbarGradient option to AdaptiveScaffold for iOS 26+ toolbar gradient customization (@nadavfima)extendBodyBehindAppBar option to AdaptiveScaffold (@Crucialjun)scaffoldMessengerKey parameter to AdaptiveApp (@Crucialjun)autofillHints support to AdaptiveTextFormField (@Crucialjun)onTapOutside callback to AdaptiveTextFormFieldFIX: Theme color support across all components
CupertinoTheme.of(context).primaryColorTheme.of(context).colorScheme.primaryelevatedButtonTheme, textButtonTheme, etc.mainAxisAlignment: MainAxisAlignment.spaceBetweensuffixIcon internally to prevent extra vertical spaceisDense: true to reduce paddingNEW: Added AdaptiveBlurView widget - iOS 26+ Liquid Glass blur effects
AdaptiveBlurView widget - iOS 26+ Liquid Glass blur effects
unselectedItemColor behavior in AdaptiveBottomNavigationBar
unselectedItemColor is null, now uses theme's default color instead of forcing a color.alwaysTemplate rendering mode when no custom color providedCupertinoColors.inactiveGray fallbackNEW : Added selectedItemColor and unselectedItemColor support for AdaptiveBottomNavigationBar
selectedItemColor and unselectedItemColor support for AdaptiveBottomNavigationBar
.alwaysOriginal for unselected, .alwaysTemplate for selected)useSmoothRectangleBorder parameter to AdaptiveButton (iOS 26+)
true: Smooth rectangle cornersfalse: Perfect circular/capsule shape for icon buttonsshow() - Standard dialog (returns void)inputShow() - Text input dialog (returns String?)NEW : Added spacerAfter parameter (ToolbarSpacerType) to AdaptiveAppBarAction for iOS 26+ Liquid Glass toolbar grouping
spacerAfter parameter (ToolbarSpacerType) to AdaptiveAppBarAction for iOS 26+ Liquid Glass toolbar grouping
ToolbarSpacerType.fixed - 12pt fixed space using UIBarButtonItem.fixedSpace() for spacing within groupsToolbarSpacerType.flexible - Flexible space using UIBarButtonItem.flexibleSpace() for left/right group separationToolbarSpacerType.none - No spacer (default)AdaptiveAppBarAction(iosSymbol: 'arrow.uturn.forward', onPressed: () {}, spacerAfter: ToolbarSpacerType.flexible)FIX: Added automatic localization support for AdaptiveDatePicker, AdaptiveTimePicker, and popup menu buttons
BREAKING CHANGE : Renamed AdaptiveAppBarAction.androidIcon to icon
AdaptiveTabBarView widget - Platform-specific swipeable tab bar view with color customizationAdaptiveFloatingActionButton widget - Platform-specific FAB with custom colors, mini size, hero transitionsAdaptiveFormSection widget - Platform-specific form sections (iOS: CupertinoFormSection, Android: Card)
AdaptiveExpansionTile widget - Modern expandable/collapsible content
AdaptiveAppBarAction.androidIcon to icon
iosSymbol for iOS 26+ only, icon for iOS <26 and AndroidandroidIcon: with icon:AdaptiveSegmentedControl for iOS <26 to use CupertinoSlidingSegmentedControlNEW: Added AdaptiveTextField for platform-specific text input
AdaptiveTextField for platform-specific text input
CupertinoTextField with tertiarySystemBackground color and rounded cornersTextField with outlined borderAdaptiveTextFormField for form validation support
FormField wrapper with CupertinoTextField for proper validationTextFormFieldIOS26Button.child now wrapped with IgnorePointerAdaptiveButton.icon had limited tap areaiconColor parameter to AdaptiveButton.icon
textColor remains for label buttons, iconColor for icon buttonsAdaptiveNavigationDestinationbadgeCount parameter to AdaptiveNavigationDestination classUITabBarItem.badgeValue for native badge displayAdaptiveBadge widget for cross-platform badge displayfix: improve pub.dev score and CI compatibility
AdaptiveSegmentedControl now renders icons directly based on platform.
Enhance AdaptivePopupMenuButton to support dynamic icon types for iOS and Android
NEW: Added text input support to AdaptiveAlertDialog
AdaptiveAlertDialog
AdaptiveAlertDialogInput class for input configurationFuture<String?> with user inputAdaptiveContextMenu widget for long-press context menus
CupertinoContextMenu.builder with native animationsPopupMenuButton with Material Design stylingAdaptiveAlertDialog icon parameter to dynamic type
BREAKING CHANGE: AdaptiveScaffold bottom navigation parameters refactored
AdaptiveBottomNavigationBar class for cleaner bottom navigation configuration
bottomNavigationBar parameter in AdaptiveScaffolddestinations, selectedIndex, onDestinationSelected parametersbottomNavigationBar is null, no bottom navigation will be shownAdaptiveBottomNavigationBar
items parameter: Navigation items (renamed from destinations)selectedIndex parameter: Currently selected item indexonTap parameter: Callback when item is tapped (renamed from onDestinationSelected)useNativeBottomBar parameter: Control iOS 26+ native bottom bar (default: true)cupertinoTabBar parameter: Provide custom CupertinoTabBar for iOSbottomNavigationBar parameter: Provide custom NavigationBar or BottomNavigationBar for AndroiduseNativeBottomBar priority behavior on iOS
useNativeBottomBar: true: Native UITabBar with Liquid Glass effect is shown, custom cupertinoTabBar is ignoreduseNativeBottomBar: false: Custom cupertinoTabBar is used if provided, otherwise auto-generated from itemscupertinoTabBar is used if provided, otherwise auto-generated from items (useNativeBottomBar is ignored)AdaptiveScaffold bottom navigation parameters refactored
destinations, selectedIndex, onDestinationSelected parametersbottomNavigationBar parameter of type AdaptiveBottomNavigationBar?AdaptiveBottomNavigationBar()// Before
AdaptiveScaffold(
destinations: [...],
selectedIndex: 0,
onDestinationSelected: (index) {},
)
// After
AdaptiveScaffold(
bottomNavigationBar: AdaptiveBottomNavigationBar(
items: [...],
selectedIndex: 0,
onTap: (index) {},
),
)
BREAKING CHANGE: AdaptiveScaffold parameters refactored
AdaptiveAppBar class for cleaner app bar configuration
appBar parameter in AdaptiveScaffoldtitle, actions, leading, useNativeToolbar parametersappBar is null, no app bar or toolbar will be shownAdaptiveAppBar
cupertinoNavigationBar parameter: Provide custom CupertinoNavigationBar for iOSappBar parameter: Provide custom AppBar for AndroiduseNativeToolbar priority behavior on iOS
useNativeToolbar: true: Native iOS 26 toolbar is shown, custom cupertinoNavigationBar is ignoreduseNativeToolbar: false or not set: Custom cupertinoNavigationBar is used if providedAdaptiveScaffold parameters refactored
title, actions, leading, useNativeToolbar parametersappBar parameter of type AdaptiveAppBar?AdaptiveAppBar()// Before
AdaptiveScaffold(
title: 'My App',
actions: [...],
useNativeToolbar: true,
)
// After
AdaptiveScaffold(
appBar: AdaptiveAppBar(
title: 'My App',
actions: [...],
useNativeToolbar: true,
),
)
* Updated README.md
NEW: Added AdaptivePopupMenuButton.widget() constructor for custom widget support
AdaptivePopupMenuButton.widget() constructor for custom widget support
BREAKING CHANGE: iOS 26 Native Toolbar is now optional due to stability issues with GoRouter and other router packages
AdaptiveSnackBar widget for platform-specific notifications
useNativeToolbar: true parameter in AdaptiveScaffoldCupertinoNavigationBar for better compatibilityuseNativeToolbar: falseuseNativeToolbar: false
* Updated README.md
* Updated README.md
NEW: Added AdaptiveCard widget for platform-specific card styling
AdaptiveCard widget for platform-specific card styling
AdaptiveRadio widget for radio button groups
AdaptiveBadge widget for notification badges
AdaptiveTooltip widget for platform-specific tooltips
AdaptiveCheckbox widget (Cupertino & Material only)
IOS26NativeSearchTabBar for iOS 26+ native search tab bar
* Updated README.md
BREAKING CHANGE: Renamed AdaptiveScaffold.child parameter to body to match standard Scaffold API
AdaptiveScaffold.child parameter to body to match standard Scaffold APIAdaptiveApp widget for automatic platform-specific app configuration
AdaptiveApp() - Constructor for normal navigationAdaptiveApp.router() - Constructor for router-based navigation (GoRouter, etc.)themeMode, materialLightTheme, materialDarkTheme, cupertinoLightTheme, cupertinoDarkThemematerial() and cupertino() for advanced configurationdebugShowCheckedModeBanner: false)body parameterFix image links in README.md to use GitHub raw URLs
Added comprehensive README with images for all widgets
Initial release with iOS 26+ support
AdaptiveScaffold - Platform-adaptive scaffold with native iOS 26 toolbar and tab barAdaptiveButton - Adaptive buttons with iOS 26 Liquid Glass designAdaptiveSegmentedControl - Native segmented controls for all platformsAdaptiveSwitch - Platform-adaptive switchesAdaptiveSlider - Platform-adaptive slidersAdaptiveAlertDialog - Native alert dialogsAdaptivePopupMenuButton - Platform-adaptive popup menusOne column per month.