NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #1737 most downloaded on pub.dev
Internationalized dialog for picking a single month from an infinite list of years.
Last release 27 days ago
10 Sep 2026
Release timing varies
gaps range from 1 weeks to 7 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
79 releases · first in 2018
The dialog now follows a theme change while it is open instead of keeping the theme it was opened with #129
Added semantics support (previousButtonSemanticsLabel, nextButtonSemanticsLabel) to header navigation arrows via PickerHeaderSettings.
previousButtonSemanticsLabel, nextButtonSemanticsLabel) to header navigation arrows via PickerHeaderSettings.One column per quarter.
Added operation order fix from Jerrywell fork.
Added verticalScrolling to PickerDialogSettings: defines if the year/month grid will scroll on vertical or horizontal direction.
verticalScrolling to PickerDialogSettings: defines if the year/month grid will scroll on vertical or horizontal direction.PickerHeaderSettings previousIcon and nextIcon to nullable.Added gridPadding to PickerDialogSettings: defines the padding between the grid and the dialog border.
gridPadding to PickerDialogSettings: defines the padding between the grid and the dialog border.Added yearsPerPage to PickerDialogSettings: defines how many years the dialog will have per page.
yearsPerPage to PickerDialogSettings: defines how many years the dialog will have per page.- Updated provider version. - Updated intl version. - Updated sample.
Added returnToStartofRange: defines if the controller will return to the first selected month of the range, after the second is selected. Fixes #119
returnToStartofRange: defines if the controller will return to the first selected month of the range, after the second is selected. Fixes #119Added onYearSelected and onMonthSelected functions to provide a callback after the user selects a value.
onYearSelected and onMonthSelected functions to provide a callback after the user selects a value.Added copyWith Method to picker settings. Tks nomoruyi.
Small changes to HeaderRow to make more clear to the user that the year is a button.
Added headerAlignment parameter to PickerHeaderSettings.
PickerHeaderSettings.Added arrowAlpha parameter to PickerHeaderSettings.
PickerHeaderSettings.Fixes a bug introduced in 6.2.0.
Added PickerActionBarSettings.actionBarPadding to handle the Padding of the ActionBar.
0.20.0.PickerActionBarSettings.actionBarPadding to handle the Padding of the ActionBar.Nothing published for this version
Downgraded intl to 0.19.0 until flutter_localizations starts to use 0.20+. Please use the dev version of this package if you need latest intl.#112.
flutter_localizations starts to use 0.20+. Please use the dev version of this package if you need latest intl.#112.- Fixed #109. - Improved function docs.
- Improved sample
Added PickerActionBarSettings to handle the action bar settings of the dialog.
PickerActionBarSettings to handle the action bar settings of the dialog.confirmWidget, cancelWidget, customDivider are now on the PickerActionBarSettings class.PickerButtonsSettings to PickerDateButtonsSettings and buttonsSettings to dateButtonsSettings.Fixed flutter 3.27.0 deprecations.
0.20.0. Fixes #107.5.0.0.3.27.0 deprecations.- Fixed #106. - Updated android sample.
- Fixed #104.
- Fixed #105.
removed initialDate parameter from showMonthRangePicker.
[Breaking] Reworked dialog configuration to use the new class MonthPickerDialogSettings. Please follow the sample app to learn how to configure your w
MonthPickerDialogSettings. Please follow the sample app to learn how to configure your widget using the new way (or feel free to open an issue on github).showYearPicker function to the package. Now its possible to return only a year.selectableYearPredicate to range and single month pickers. It lets you control enabled years like selectableMonthPredicate.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- Improved locale selection. #98
Added showMonthRangePicker function to the package. Now its possible to return a range of months too. Tks Lautaro Zanuttini
showMonthRangePicker function to the package. Now its possible to return a range of months too. Tks Lautaro ZanuttinilastDayOfMonth DateTime extension. if you want to get the last day of the month from one of your selected dates.- Bumped intl to 0.19.0. - Bumped flutter_lints to 4.0.0.
0.19.0.4.0.0.Added buttonBorder: property to allow you define the border of the month/year buttons (default is const CircleBorder()) #92.
Removed unnecessary dependencies.
- Bumped provider to 6.1.2. - Improved some docs.
6.1.2.- Fixed #87.
Added dialogBorderSide: property to allow you define the border side of the dialog (default is BorderSide.none).
dialogBorderSide: property to allow you define the border side of the dialog (default is BorderSide.none).blockScrolling: property to allow you block the user from scrolling the months/years (default is true).Added currentMonthTextColor property to allow you control the text color of the current month/year.
currentMonthTextColor property to allow you control the text color of the current month/year.Exposed MonthPickerDialog widget.
MonthPickerDialog widget.Added customDivider property to allow you add a custom divider between the months/years and the confirm/cancel buttons.
customDivider property to allow you add a custom divider between the months/years and the confirm/cancel buttons.- Mini fix in customWidth.
customWidth.Added forcePortrait property to allow you block the widget from entering in landscape mode.
forcePortrait property to allow you block the widget from entering in landscape mode.Added arrowSize property to allow you control the size of the header arrows.
arrowSize property to allow you control the size of the header arrows.Removed deprecated textScaleFactor inside the package (the name of the parameter stays the same)
textScaleFactor inside the package (the name of the parameter stays the same)3.0.0,provider to 6.1.1, intl to 0.18.1 and flutter_lints to 3.0.1Added textScaleFactor property to allow controlling the scale of the texts in the widget 77.
Added selectedMonthPadding property to allow you control the size of the current selected month/year circle by increasing the padding of it (default i
selectedMonthPadding property to allow you control the size of the current selected month/year circle by increasing the padding of it (default is 0) 74.Added default locale strings to the action buttons 73.
Breaking: bumped to dart 3 + intl 0.18.0 (latest one on flutter_localizations)
Added hideHeaderRow property to allow you hide the row with the arrows + years/months page range from the header, forcing the user to scroll to change
hideHeaderRow property to allow you hide the row with the arrows + years/months page range from the header, forcing the user to scroll to change the page (default is false).Added animationMilliseconds property to allow you define the speed of the page transition animation (default is 450).
animationMilliseconds property to allow you define the speed of the page transition animation (default is 450).customHeight to 240.Added monthStylePredicate and yearStylePredicate properties to allow passing a different style for each month or year 67.
monthStylePredicate and yearStylePredicate properties to allow passing a different style for each month or year 67.Added backgroundColor property to allow the dialog to have a different background of the default from the theme.
backgroundColor property to allow the dialog to have a different background of the default from the theme.Removed RxDart from the code in favor of Provider.
Another fix on header arrow 61.
Mini fix on header arrow. Bumped to 0.8 because of the braking change on 0.7.1
0.7.1Breaking: confirmText and cancelText were replaced by confirmWidget and cancelWidget. Now it's possible to use any widget instead of only Text() in th
confirmText and cancelText were replaced by confirmWidget and cancelWidget. Now it's possible to use any widget instead of only Text() in the buttonsAdded forceSelectedDate to fix 41.The parameter lets you define that the current selected date will be returned if the user clicks outside of the dial
forceSelectedDate to fix 41.The parameter lets you define that the current selected date will be returned if the user clicks outside of the dialog. Needs dismissible = truecode cleanup in preparation to fix 41 and 30 in the next major version
updated to flutter 2.19.2 and fixed deprecations
Your coding agent can read these notes before it upgrades. Set up the MCP server →