NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #1325 most downloaded on pub.dev
This package helps in creation of forms in Flutter by removing the boilerplate code, reusing validation, react to changes, and collect final user input.
Last release 1 months ago
15 Aug 2026
Release timing varies
gaps range from 2 weeks to 6 months
Most releases are documented
notes for 51 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
177 releases · first in 2018
BREAKING CHANGE: Attribute readOnly replaced by enabled - this was done to match Flutter's FormField naming convention
readOnly replaced by enabled - this was done to match Flutter's FormField naming conventiondidChange() method instead of patchValue()readOnly field values from the final form value using skipReadOnly field. Closes #501readOnly and initialValue at runtime. Closes #515errorTextOne column per quarter.
Number of Chips to be selected in FilterChip can now be limited by setting maxChips attribute. Closes #500
maxChips attribute. Closes #500dropdown_search package. Closes #507Included v3 to v4 migration guide to README
Changed Version naming for release candidates from -RC.* to -pre.*
-RC.* to -pre.*Deprecated FormBuilderCountryPicker - redundant due to FormBuilderSearchableDropdown inclusion.
FormBuilderSearchableDropdown.FormBuilderCountryPicker - redundant due to FormBuilderSearchableDropdown inclusion.Fix for label overflows in Radio & Checkbox Groups
FormBuilderDateRangePicker where if dialog dismissed, current value is clearedTextEditingController in FormBuilderTextField not detected. Closes #448Fixed bug where validate() always returns true. Closes #440
Added new field FormBuilderLocationField
"Error: Type 'DiagnosticableMixin' not found". Closes #406Fix bug in FormBuilderValidators.numeric if valueCandidate is null
FormBuilderValidators.numeric if valueCandidate is nullpattern validator to match.requireTrue validator to equal to allow equality check with other types. Closes #397FormBuilderPhoneField.initialValueImproved programmatically changing field values. Multiple fields can be updated once
FormBuilderRatingFormBuilderRadioList and FormBuilderCheckboxList fieldsFixed erratic keyboard behavior on FormBuilderTextField
FormBuilderTextFieldFormBuilder & FormBuilderField attributesFormBuilderRadioGroup not submitting valueAdded new field - FormBuilderCheckboxGroup. Closes #188,
FormBuilderCheckboxGroup. Closes #188,FormBuilderRadioGroup implementation similar to FormBuilderCheckboxGroup. Fixes issue where FormBuilderFieldOption.child is ignored Closes #335initialValue from FormBuilder is ignored. Closes #370Attempted tab/next support - work in progress
Locale.countrycCode is null. Closes #369updateFormAttributeValue to setInternalAttributeValue to avoid confusionImprovements to dirty check for FormBuilderField - fixes autovalidate only when dirty
Added static getter for FormBuilderLocalizations delegate
Localize validation error texts
country_picker package for country_code_pickers in PhoneField which supports localized countriesInputDecoration.errorText which invalidates the field. Allows external validation like server validationColor.toString()FormBuilderValidators.compose() which composes multiple FormFieldValidators into oneUse signature: ^3.0.0 package instead of self-maintained - comes with breaking changes.
UniqueKey() used where necessaryFormBuilderField to be used base to create custom fields. Removed unused FormBuilderCustomFieldFormBuilderField.onReset callback - to enable user to react to resetting by changing the UI to reflect resetreadOnly to true doesn't affect fieldsinitialValue instead of widget provided since it may have been set by the FormBuilderborder for FormBuilderSignaturePadinitialDate and initialTime for DateTimePicker - user may prefer to set ownComplete rewrite of package implementation
FormBuilderRate to FormBuilderRatingMore documentation improvements
BREAKING CHANGE: Removed CountryPicker field because of limited use. Replaced with SearchableDropdown with similar functionality but not only limited…
Remove phone number validation internally. Closes #499
Added support for Flutter v1.22
Include changes made in v3.13.5 & v3.13.6
Include changes made in v3.13.4
Include changes made in v3.13.3
Fixed RangeSemanticFormatterCallback error. Changed field with SemanticFormatterCallback.
RangeSemanticFormatterCallback error. Changed field with SemanticFormatterCallback.Fixed bug in DateRangePicker where user can just pick one date. Closes #434
GroupedCheckbox not disabled when read onlyinitialValue parsingImage.memory throwing error when value is nullFixed bug in DateRangePicker where onChanged fires before change. Closes #434
DateRangePicker where onChanged fires before change. Closes #434flutter_chips_input. Fixes #415Fixed bug where CountryPicker.onSaved breaks if value is null
CountryPicker.onSaved breaks if value is nullinitialValue not savedRadioGroup & CheckboxGroupflutter_chips_input. Fixes bugs in Flutter pre-release channelsFix bug where CountryPicker still works in readOnly. Closes #413
Added defaultImage attribute to FormBuilderImagePicker, acts as placeholder. Courtesy luwenbin8023
defaultImage attribute to FormBuilderImagePicker, acts as placeholder. Courtesy luwenbin8023FormBuilderCheckboxGroup where InputDecoration isn't enabled. Closes #405Added default value to timePickerInitialEntryMode to be consistent with showTimePicker API. Closes #403
timePickerInitialEntryMode to be consistent with showTimePicker API. Closes #403TextEditingControllers aren't unused and are properly disposed.flutter_chips_input with fix for "Bad UTF-8 found..."Added support for Flutter v1.20
Fixed bug in parsing phone number from FormBuilderPhoneField's initialValue
FormBuilderPhoneField's initialValuetoolbarOptions, smartQuotesType, smartDashesType, scrollPhysics, enableSuggestionsonChanged bug on TextFieldConvert FormBuilderRating value to double for RatingBar. Closes #392
Deprecate FormBuilderRadio in favour of FormBuilderRadioGroup
FormBuilderRadio in favour of FormBuilderRadioGroupFormBuilderCheckbox in favour of FormBuilderCheckboxGroup"NoSuchMethodError: invalid member on null: 'initialValue'" when fields not wrapped in FormBuilderAdded new field FormBuilderCheckboxGroup. Closes #188
FormBuilderCheckboxGroup. Closes #188group_radio_button library dependency, made own implementation with label fix. Closes #376, #335TextEditingController ignored in FormBuilderTypeaheadFixed error 'The getter 'initialValue' was called on null' if no FormBuilderState ancestry. Closes #364
The getter 'initialValue' was called on null' if no FormBuilderState ancestry. Closes #364hint overlaps with labelText. Closes #372initialEntryMode != null' assertion in DateTimePicker. Closes #373Deprecate underline for Dropdown. Ignored
showDatePicker function optionsonChanged not triggered by ImagePicker. Closes #366underline for Dropdown. IgnoredFormBuilderDropdown class. Closes #360bottomSheetPadding option for ImagePicker. Closes #339Added text styles options to Slider
labelPadding and labelStyle to ChoiceChip fieldReverted changes to PhoneField causing focus issues
Deprecated initialValue for Signature field - here's no easy way of converting Uint8List to List . Use SignatureController to set initial signature
initialValue for Signature field - here's no easy way of converting Uint8List to List<Point>. Use SignatureController to set initial signaturedisplayValues attribute to Slider and RangeSlider - choose which values to display under the sliderBumped up flutter_chips_input version. Contains major fix
FormBuilderTypeAhead.Added FormBuilderRadioGroup field
FormBuilderRadioGroup fieldtextAlignVertical attribute option to FormBuilderTextFieldmaxHeight, maxWidth, imageQuality, preferredCameraDevice & maxImagesalwaysUse24HourFormat option to DateTimePicker. Closes #297Added delete icon on selected images in ImagePicker instead of non-intuitive long-press to delete. Closes #278
Added decoration attribute to ImagePicker, deprecated labelText
FormBuilderCountryPicker and FormBuilderPhoneField. Good work by Furkan KURTreadOnly prop to false in ColorPicker, DateRangePicker & DateTimePicker TextFields - prevents keyboard popping up. Closes #210minLength validator. Closes #259ObjectKeys to enforce rebuild after resetdecoration attribute to ImagePicker, deprecated labelTextinitialTime & initialDate in DateTimePickerNew field type FormBuilderImagePicker courtesy of Gustavo Vítor
FormBuilderImagePicker courtesy of Gustavo VítorshowCheckmark for FormBuilderFilterChip, along with other options. Closes #260allowEmpty in minLength and maxLength validations. Closes #259locale, textDirection, useRootNavigator & builder not passed down to showDatePicker() and showTimePicker()initialValue is null or controller is null for FormBuilderTextField. Closes #258Fix bug where onChange in FormBuilderDateTimePicker doesn't fire when field is cleared. Closes #254
onChange in FormBuilderDateTimePicker doesn't fire when field is cleared. Closes #254The method 'dispose' was called on null. issue in FormBuilderTypeAhead. Closes #256onTap callback added to FormBuilderTextField
onTap callback added to FormBuilderTextFieldDeprecate validator attribute in FormBuilderDateTimePicker, only validators should be used
FormBuilderTouchSpin aka Stepper not being disabled when in readOnlySliderPickerflutter_typeahead package so user gets access TextFieldConfiguration classvalidator attribute in FormBuilderDateTimePicker, only validators should be usedFix bug where Changing readOnly of FormBuilder does not change readOnly of FormBuilderDateTimePicker. Closes #179
FormBuilder does not change readOnly of FormBuilderDateTimePicker. Closes #179FormBuilderTouchSpin replaced the confusingly named FormBuilderStepper which is now deprecated.
FormBuilderChoiceChip - Creates a chip that acts like a radio button. Courtesy Cesar FloresFormBuilderFilterChip - Creates a chip that acts like a checkbox. By Cesar Flores. Again!FormBuilderColorPicker with help from BenjaminFormBuilderTouchSpin replaced the confusingly named FormBuilderStepper which is now deprecated.flutter_typeahead from 1.7.0 to 1.8.0Bumped up intl, datetime_picker_formfield & flutter_chips_input. Closes #204, #207, #211, #215.
intl, datetime_picker_formfield & flutter_chips_input. Closes #204, #207, #211, #215.Fix email validator: Trim white-space before validation
Use num for FormBuilderStepper instead of double to allow for either int or double
num for FormBuilderStepper instead of double to allow for either int or doubleIncluded onSaved callback to all fields. Closes #175
onSaved callback to all fields. Closes #175Key option to all fields to make testing possibleFormBuilderDateRangePicker ignores initialFirstDate and initialLastDatevalues for FormBuilderStepper. Closes #182nullintl, upgrade flutter_chips_input & datetime_picker_formfield - due incompatibilities. Closes #183, #185Fixed bug caused by dropping unimplemented attribute onChipTapped of flutter_chips_input. Closes #168
onChipTapped of flutter_chips_input. Closes #168Added clear option to FormBuilderDropdown - set allowClear to true. Closes #148
allowClear to true. Closes #148contentPadding and border attributes removed from CheckboxList, Radio and SegmentedControl list. Closes #160numberFormat attribute to Slider. Closes #156flutter_typeahead 1.6.1 -> 1.7.0Bumped up flutter_chips_input version from 1.3.1 to 1.5.1
flutter_chips_input version from 1.3.1 to 1.5.1Fix dependency mismatch for intl with flutter_localizations from sdk
intl with flutter_localizations from sdkdatetime_picker_formfield dependency versionYour coding agent can read these notes before it upgrades. Set up the MCP server →