platform_adaptive_widgets 1.0.5

A spiritual continuation of flutter_platform_widgets library

Platform Adaptive Widgets

A spiritual rewrite and continuation of flutter_platform_widgets library.

Platform-adaptive widgets that automatically render Material widgets on Android and Cupertino widgets on iOS — with zero platform checks in your app code.

---

Widgets Catalog

Dialogs

Widget / Function	Material	Cupertino	Data Classes
showPlatformDatePicker()	showDatePicker	CupertinoDatePicker + showCupertinoModalPopup	MaterialDatePickerData, CupertinoDatePickerData
showPlatformTimePicker()	showTimePicker	CupertinoDatePicker (time mode) + showCupertinoModalPopup	MaterialTimePickerData, CupertinoDatePickerData
PlatformMenuPicker<T>	DropdownMenu + DropdownMenuEntry	PullDownButton / PullDownMenuItem (≤5 items) or CupertinoPicker + showCupertinoModalPopup (>5 items)	MaterialMenuPickerData, CupertinoMenuPickerData
showPlatformDialog<T>()	showDialog + Dialog / Dialog.fullscreen	showCupertinoDialog	PlatformDialogData, MaterialDialogData
showPlatformAlertDialog<T>() + PlatformAlertDialogActionButton	AlertDialog + TextButton	CupertinoAlertDialog + CupertinoDialogAction	MaterialAlertDialogData, CupertinoAlertDialogData
showPlatformModalBottomSheet<T>()	showModalBottomSheet	showCupertinoModalPopup	—
showPlatformSimpleAlert()	SnackBar via ScaffoldMessenger	CupertinoAlertDialog via showCupertinoDialog	PlatformDialogData

---

Interaction

Widget	Material	Cupertino	Data Classes
PlatformButton	TextButton, ElevatedButton, OutlinedButton, FilledButton (via MaterialButtonVariant)	CupertinoButton, CupertinoButton.filled, CupertinoButton.tinted (via CupertinoButtonVariant)	MaterialButtonData, CupertinoButtonData
PlatformCheckbox	Checkbox	CupertinoCheckbox	PlatformCheckboxData, MaterialCheckboxData, CupertinoCheckboxData
PlatformExpansionTile	ExpansionTile	CupertinoExpansionTile	MaterialExpansionTileData, CupertinoExpansionTileData
PlatformRadioGroup<T>	RadioGroup + Radio	RadioGroup + CupertinoRadio	PlatformRadioGroupData<T>, PlatformRadioData<T>, MaterialRadioData<T>, CupertinoRadioData<T>
PlatformScrollbar	Scrollbar	CupertinoScrollbar	MaterialScrollbarData, CupertinoScrollbarData
PlatformSearchBar	SearchBar	CupertinoSearchTextField	PlatformSearchBarData, MaterialSearchBarData, CupertinoSearchBarData
PlatformSegmentButton<T>	SegmentedButton + ButtonSegment	CupertinoSlidingSegmentedControl	MaterialSegmentButtonData<T>, CupertinoSegmentButtonData<T>
PlatformSlider	Slider	CupertinoSlider	PlatformSliderData, MaterialSliderData
PlatformSwitch	Switch	CupertinoSwitch	PlatformSwitchData, MaterialSwitchData, CupertinoSwitchData
PlatformTextField	TextField	CupertinoTextField	PlatformTextFieldData, MaterialTextFieldData, CupertinoTextFieldData

---

Layout

Widget	Material	Cupertino	Data Classes
PlatformApp / PlatformApp.router	MaterialApp / MaterialApp.router	CupertinoApp / CupertinoApp.router	AppData, PlatformAppRouterData, MaterialAppData, MaterialAppRouterData, CupertinoAppData, CupertinoAppRouterData
PlatformAppBar	AppBar	CupertinoNavigationBar	MaterialAppBarData, CupertinoNavigationBarData
PlatformScaffold	Scaffold	CupertinoPageScaffold	MaterialScaffoldData, CupertinoScaffoldData
PlatformTabScaffold	Scaffold + NavigationBar + NavigationDestination	CupertinoTabScaffold + CupertinoTabBar + CupertinoTabView	MaterialTabScaffoldData, CupertinoTabScaffoldData, TabDestination

---

Painting

Widget	Material	Cupertino	Data Classes
PlatformListTile	ListTile	CupertinoListTile / CupertinoListTile.notched	MaterialListTileData, CupertinoListTileData
PlatformProgressIndicator	CircularProgressIndicator	CupertinoActivityIndicator	MaterialProgressIndicatorData, CupertinoProgressIndicatorData

---

Utilities

Generic Platform Widgets

Widget	Description
PlatformWidget	Takes materialBuilder and cupertinoBuilder callbacks to render any custom widget per platform.
PlatformWidgetBuilder	Same as PlatformWidget but also passes a shared child widget to both builders.

Platform Theme

PlatformTheme.of(context) — provides unified access to theme properties across platforms:

Property	Material	Cupertino
barBackgroundColor	Theme.of(context).appBarTheme.backgroundColor	CupertinoTheme.of(context).barBackgroundColor
primaryColor	Theme.of(context).primaryColor	CupertinoTheme.of(context).primaryColor
primaryContrastingColor	Theme.of(context).colorScheme.onPrimary	CupertinoTheme.of(context).primaryContrastingColor
scaffoldBackgroundColor	Theme.of(context).scaffoldBackgroundColor	CupertinoTheme.of(context).scaffoldBackgroundColor
selectionHandleColor	Theme.of(context).colorScheme.onSurface	CupertinoTheme.of(context).selectionHandleColor

Context Extensions

Extensions on BuildContext for inline platform-specific values:

Extension	Description
platformValue<T>(material:, cupertino:)	Returns the value matching the current platform.
platformValueNullable<T>(material:, cupertino:)	Nullable variant of platformValue.
platformLazyValue<T>(material:, cupertino:)	Lazily evaluates only the callback for the current platform.
platformLazyNullable<T>(material:, cupertino:)	Nullable variant of platformLazyValue.
platformIcon(material:, cupertino:)	Convenience for selecting platform-specific IconData.

Other Extensions

Extension	Description
DateTimeExtensions.toDate()	Converts DateTime → Date.
TimeOfDayExtensions.toDateTime()	Converts TimeOfDay → DateTime.

Models

Model	Description
Date	An immutable gregorian calendar date (year, month, day) with comparison, arithmetic, and conversion utilities.
PlatformAdaptiveIcons	A class that provides adaptive icons based on the current platform.

---

Base Classes

All platform widgets extend one of these base classes, which use compile-time defaultTargetPlatform resolution:

Base Class	Description
PlatformWidgetBase	Core abstract StatelessWidget with buildMaterial() and buildCupertino().
PlatformWidgetKeyedBase	Adds an optional widgetKey for the underlying platform widget.
PlatformWidgetBuilderBase	Adds a required child widget passed through to the platform builder.
PlatformWidgetKeyedBuilderBase	Combines both widgetKey and child.

---

Contributors

Made with contrib.rocks.

Authors

• @LahaLuhem

Used By

This project is used by the following companies:

• Didata Automatisering B.V
• Dimerce B.V

License

MIT