NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #1255 most downloaded on pub.dev
shadcn/ui ported in Flutter. Awesome UI components for Flutter, fully customizable.
Latest stable
0.59.0
Last release 8 days ago
09 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
5 versions withdrawn
withdrawn after publishing
3 years old
244 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
fix/407 by @GuillaumeMCK in https://github.com/nank1ro/flutter-shadcn-ui/pull/408
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.28.2...v0.28.3
backgroundColor to ShadAppBuilder (thanks to @GuillaumeMCK)FIX: ShadDialog and ShadSheet now use SafeArea to prevent the content from being cut off by the system UI.
ShadDialog and ShadSheet now use SafeArea to prevent the content from being cut off by the system UI.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.28.1...v0.28.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
FIX: Add clearValueOnUnregister to ShadForm (defaults to false) to prevent clearing a form field's value from the form state when the field is unregis
clearValueOnUnregister to ShadForm (defaults to false) to prevent clearing a form field's value from the form state when the field is unregistered (aka disposed).ShadPopover not closing when pressing ESC (thanks to @DMouayad)Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.28.0...v0.28.1
REFACTOR: Update ShadCalendar yearSelectorMinWidth from 100 to 64 and monthSelectorMinWidth from 120 to 64.
ShadCalendar yearSelectorMinWidth from 100 to 64 and monthSelectorMinWidth from 120 to 64.ShadCalendar position of dropdown, which is now centered in the header.dropdownFormatMonth and dropdownFormatYear to ShadCalendar.ShadAvatar.MainAxisSize.min in ShadCard notification example.ShadContextMenuRegion.hitTestBehavior from ShadContextMenuRegion, defaults to HitTestBehavior.opaque (thanks to @NonymousMorlock).ShadTooltip to null instead of TextAlign.center.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.27.4...v0.28.0
Fix ShadIconButton icon size property isn't applied by @TahaTesser in https://github.com/nank1ro/flutter-shadcn-ui/pull/386
ShadIconButton icon size property isn't applied by @TahaTesser in https://github.com/nank1ro/flutter-shadcn-ui/pull/386Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.27.3...v0.27.4
ShadIconButton icon size property isn't applied (thanks to @TahaTesser).FIX: ShadCalendar initialMonth update when the user did not interact with the month selector yet.
ShadCalendar initialMonth update when the user did not interact with the month selector yet.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.27.2...v0.27.3
FIX: ShadAccordion title overflow when the title is too long (thanks to @monteiz).
ShadAccordion title overflow when the title is too long (thanks to @monteiz).ShadContextMenuItem hover background color.3.32.0 to support the RoundedSuperellipseBorder.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.27.1...v0.27.2
FEAT: Add ShadRoundedSuperellipseBorder to support the rounded superellipse border style as the primary border of any widget that uses ShadDecoration.
ShadRoundedSuperellipseBorder to support the rounded superellipse border style as the primary border of any widget that uses ShadDecoration.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.27.0...v0.27.1
BREAKING CHANGE: The secondary border of ShadDecoration now is drawn outward of the widget, without consuming any extra space. This change affects all…
ShadDecoration now is drawn outward of the widget, without consuming any extra space. This change affects all components that are focusable.offset to ShadBorder to set the offset between the widget and the outward secondary border.orderPolicy, ShadApp.material, ShadApp.cupertino and so on.anchor of ShadSelect, ShadTooltip and ShadPopover from ShadAnchorAuto() to ShadAnchorAuto(offset: Offset(0, 4)).checkboxPadding to ShadCheckbox, ShadCheckboxTheme and ShadCheckboxFormField, defaults to EdgeInsets.only(top: 1).radioPadding to ShadRadio and ShadRadioTheme, defaults to EdgeInsets.only(top: 1).ShadApp if no Scaffold is used, by adding a new backgroundColor parameter to ShadApp and ShadAppBuilder.actionsGap to ShadDialog, defaults to 8.ShadTimePickerTheme parameters: spacing changed from 0 to 8, runSpacing changed from 0 to 4, gap changed from 2 to 4, fieldWidth changed from 58 to 48, periodHeight changed from 50 to 42.ShadTextareaTheme when retrieving the scrollbarPadding.ShadCalendarTheme.dayButtonDecoration.secondaryFocusedBorder to use a new offset and 50% opacity for improved visibility.ShadInputOTPTheme.padding changed from EdgeInsets.symmetric(vertical: 4) to null.ShadInputOTPTheme.padding from EdgeInsets.symmetric(vertical: 4) to null.ShadTab to prevent secondary border collisions, matching original shadcn keyboard navigation behavior.ShadCalendarTheme.monthSelectorMinWidth from 130 to 120.ShadCalendar.yearSelector and ShadCalendar.monthSelector now use a secondary focused border with 50% opacity to match other parts.ShadSelect with presets example by adding padding.ShadInput example with trailing icon.ShadMenubar.anchor.offset from Offset(-8, 8) to Offset(-4, 8).ShadPopover example by adding a gap between input fields.ShadSelectController now has a Set instead of a List to prevent duplicates in the selected options, this change has been applied to ShadSelect.initialValues and ShadSelectFormField as well.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.26.5...v0.27.0
chore: update flutter test by @nank1ro in https://github.com/nank1ro/flutter-shadcn-ui/pull/366
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.26.4...v0.26.5
CHORE: Relax dependencies, previous versions were too strict and have been retracted.
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.26.3...v0.26.4
CHORE: Bump the min flutter version to 3.32.0.
3.32.0.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.26.2...v0.26.3
FIX: Add supportedDevices to ShadContextMenuRegion to decide which devices trigger the context menu (thanks to @MousyBusiness).
supportedDevices to ShadContextMenuRegion to decide which devices trigger the context menu (thanks to @MousyBusiness).Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.26.1...v0.26.2
CHORE: Update intl dependency to ^0.20.2 (thanks to @jg-l)
intl dependency to ^0.20.2 (thanks to @jg-l)Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.26.0...v0.26.1
BREAKING CHANGE: Update the appBuilder of the ShadApp by removing the ThemeData parameter.
appBuilder of the ShadApp by removing the ThemeData parameter.ShadApp.material, ShadApp.materialRouter, ShadApp.cupertino and ShadApp.cupertinoRouter. Use ShadApp.custom instead.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.25.1...v0.26.0
FIX: The scrollbar of the ShadTextarea component has been fixed, added scrollbarPadding to ShadTextareaTheme and ShadInputTheme.
ShadTextarea component has been fixed, added scrollbarPadding to ShadTextareaTheme and ShadInputTheme.ShadTextarea on resize.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.25.0...v0.25.1
CHORE: Bump dependency versions (thanks to @mayapaw).
ShadTextarea and ShadTextareaFormField components (thanks to @dalroy44).ShadSelectFormField initial value from ShadForm not working.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.24.0...v0.25.0
feat: sonner by @nank1ro in https://github.com/nank1ro/flutter-shadcn-ui/pull/332
Sonner component.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.23.4...v0.24.0
FIX: ShadSelectFormField and ShadSelectMultipleFormField controller not updating the parent ShadForm.
ShadSelectFormField and ShadSelectMultipleFormField controller not updating the parent ShadForm.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.23.3...v0.23.4
FIX: ShadInput onPressedOutside when tapping on another ShadInput.
ShadInput onPressedOutside when tapping on another ShadInput.groupId to ShadInput and ShadInputFormField, defaults to UniqueKey instead of EditableText.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.23.2...v0.23.3
FEAT: Add copyWith method to ShadColorScheme (thanks to @Luckey-Elijah).
copyWith method to ShadColorScheme (thanks to @Luckey-Elijah).Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.23.1...v0.23.2
FIX: ShadResizable divider alignments when dividerSize is overriden.
ShadResizable divider alignments when dividerSize is overriden.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.23.0...v0.23.1
BREAKING CHANGE: Refactor ShadAnchorAuto to make it more powerful, removed verticalOffset and preferBelow in favor of offset, followerAnchor and targe…
ShadMouseCursorProvider.ShadMenubar anchor.ShadBadge should not enter the gesture arena if the onPressed callback is not provided.cursor to ShadBadge, defaults to SystemMouseCursors.click if onPressed is provided.ShadAnchorAuto to make it more powerful, removed verticalOffset and preferBelow in favor of offset, followerAnchor and targetAnchor. Now every component uses it by default.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.22.5...v0.23.0
FIX: ShadGestureDetector global coordinates when using multiple Navigators.
ShadGestureDetector global coordinates when using multiple Navigators.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.22.4...v0.22.5
FIX: Pass themeMode to MaterialApp (thanks to @mubareksd).
Changelog
themeMode to MaterialApp (thanks to @mubareksd).focusNode to ShadInputFormField.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.22.3...v0.22.4
FIX: ShadTooltip exit animation, add duration and reverseDuration to it.
ShadTooltip exit animation, add duration and reverseDuration to it.ShadMenubar no longer steals the focus.ShadButton stealing focus when pressed.stylusHandwritingEnabled to ShadInput.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.22.2...v0.22.3
FIX: Add constraints to ShadInput and ShadInputFormField, by default the min height is calculated based on the style and placeholderStyle.
constraints to ShadInput and ShadInputFormField, by default the min height is calculated based on the style and placeholderStyle.ShadInput style and placeholder style which are now merged instead of replaced.ShadMenubar wrong padding used for the context menu.3.29.0 (thanks to @qk7b)Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.22.1...v0.22.2
fix/input-icon-color by @nank1ro in https://github.com/nank1ro/flutter-shadcn-ui/pull/310
ShadInput icon color.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.22.0...v0.22.1
REFACTOR: Deprecate ShadDivider and ShadDividerTheme, use ShadSeparator and ShadSeparatorTheme instead.
ShadMenubar component.ShadDivider and ShadDividerTheme, use ShadSeparator and ShadSeparatorTheme instead.onTapInside, onTapOutside, onTapUpInside and onTapUpOutside to ShadContextMenu.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.21.0...v0.22.0
FEAT: Add ShadDivider component (thanks to @Luckey-Elijah)
ShadDivider component (thanks to @Luckey-Elijah)buttonDecoration to ShadButton inside ShadDatePicker (thanks to @plusema86)Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.20.3...v0.21.0
FIX: Validation mode on form field reset (thanks to @Mayb3Nots)
reset is called on form state by @Mayb3Nots in https://github.com/nank1ro/flutter-shadcn-ui/pull/302Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.20.2...v0.20.3
REFACTOR: Deprecate ShadTab.icon, use ShadTab.leading instead. Add trailing.
ShadTab.icon, use ShadTab.leading instead. Add trailing.ShadCalendarFull Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.20.1...v0.20.2
REFACTOR: Set debugShowCheckedModeBanner to false by default in ShadApp.
debugShowCheckedModeBanner to false by default in ShadApp.ShadInputOTPTheme.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.20.0...v0.20.1
REFACTOR: Deprecated ShadButton.icon, use ShadIconButton for a button with just an icon and ShadButton.leading for a button with an icon and a text.
ShadIconButton component.ShadButton.icon, use ShadIconButton for a button with just an icon and ShadButton.leading for a button with an icon and a text.orderPolicy, use leading and trailing in the component.prefix and suffix in ShadInput, use leading and trailing instead.searchInputPrefix in ShadSelect, use searchInputLeading instead.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.19.3...v0.20.0
FIX: Make selectedOptionBuilder required in ShadSelect (thanks to @muradab).
selectedOptionBuilder required in ShadSelect (thanks to @muradab).optionsBuilder to ShadSelect and its form fields where it was missing.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.19.2...v0.19.3
FIX: Add constraints to ShadCard child.
ShadCard child.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.19.1...v0.19.2
REFACTOR: Rename materialTextTheme into applyGoogleFontToTextTheme.
materialTextTheme into applyGoogleFontToTextTheme.ShadTheme with the context, in the materialThemeBuilder and appBuilder.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.19.0...v0.19.1
BREAKING CHANGE: Rename ShadSelect and form fields controller to popoverController.
ShadInput readOnly not updating.ShadSelect and form fields controller to popoverController.controller to ShadSelect and form fields, to control the selected values.ShadResizable controller handling and simplify the logic to resize the panels.ShadResizable handle position with Axis.vertical.ShadResizable requires an id, to be able to handle when a panel is removed/added from the widget tree correctly.theme or darkTheme to the internal MaterialApp.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.7...v0.19.0
FIX: ShadApp dark theme behavior now is the same as Material. The dark theme is applied only if you provide a darkTheme and the user theme mode is dar
ShadApp dark theme behavior now is the same as Material. The dark theme is applied only if you provide a darkTheme and the user theme mode is darkFull Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.6...v0.18.7
FIX: ShadTimePicker controller not being used correctly when the component is initialized. Now each field allows a single digit instead of two.
ShadTimePicker controller not being used correctly when the component is initialized. Now each field allows a single digit instead of two.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.5...v0.18.6
FIX: ShadCalendar forward button icon color.
ShadCalendar forward button icon color.universal_image (thanks to @brunosemfio).Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.4...v0.18.5
FIX: ShadDatePicker popover closes on caption selection.
ShadDatePicker popover closes on caption selection.onNavigationNotification to ShadApp (thanks to @mllrr96)ShadDatePicker crash when caption layout is different from label, due to misleading Locale type passed to DateFormat, thanks dynamic for these amazing errors.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.3...v0.18.4
FIX: Improve ShadAvatar (thanks to @mickey35vn).
ShadAvatar (thanks to @mickey35vn).ShadCalendar and ShadDatePicker.optionsOrderPolicy from ShadSelectTheme and move it to ShadOptionTheme with the name orderPolicy.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.2...v0.18.3
FIX: InputOTP component with RTL directionality.
InputOTP component with RTL directionality.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.1...v0.18.2
FIX: Set ShadCard clipBehavior to Clip.antialias, add clipBehavior to ShadCard and ShadCardTheme.
ShadCard clipBehavior to Clip.antialias, add clipBehavior to ShadCard and ShadCardTheme.selectedDecoration in ShadTabs (thanks to @thisisamank)hourLabel, minuteLabel, secondLabel, periodLabel, hourPlaceholder, minutePlaceholder, secondPlaceholder and periodPlaceholder to ShadTimePickerTheme.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.18.0...v0.18.1
BREAKING CHANGE: Remove applyIconColorFilter from ShadButton.
applyIconColorFilter from ShadButton.ShadImage component. Prefer using the Icon widget for IconData, the Image widget for normal images, and SvgPicture (from the flutter_svg package for SVG images. If you want a fallback, use UniversalImage.iconSrc in iconData around components.TimePickerFormField initial value.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.17.6...v0.18.0
FIX: Fix the iconSize of ShadButton, add iconSize to ShadButton.
ShadButton, add iconSize to ShadButton.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.17.5...v0.17.6
FEAT: New OrderPolicy, LinearOrderPolicy, ReverseOrderPolicy and CustomOrderPolicy to update the order policy of the items in a list, this can be very
OrderPolicy, LinearOrderPolicy, ReverseOrderPolicy and CustomOrderPolicy to update the order policy of the items in a list, this can be very useful to arrange the order of the parts of the shadcn components.orderPolicy to ShadOption, ShadAlert, ShadButton, ShadCheckbox, ShadCheckboxFormField, ShadDatePicker, ShadDatePickerFormField, ShadDateRangePickerFormField, ShadRadio, ShadSwitch, ShadSwitchFormField, ShadToast.expands to ShadButton, defaults to false. Use it if you want the button's child to expand to fill the available space.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.17.4...v0.17.5
fix: tabs on changed type by @nank1ro in https://github.com/nank1ro/flutter-shadcn-ui/pull/221
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.17.3...v0.17.4
Protect onExit from setting value after dispose by @jezell in https://github.com/nank1ro/flutter-shadcn-ui/pull/219
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.17.2...v0.17.3
ShadTable protect onExit from setting value after dispose (thanks to @jezell)fix: calendar range allow deselection by @nank1ro in https://github.com/nank1ro/flutter-shadcn-ui/pull/217
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.17.1...v0.17.2
allowDeselection to ShadCalendar.rangeFIX: ShadInputOTP text alignment and padding
ShadInputOTP text alignment and paddingtextInputAction to ShadInputOTPSlotFull Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.17.0...v0.17.1
BREAKING CHANGE: The ShadBorder no longer has default values, if you want to see the border rendered provide a color and a width greater than 0. This…
ShadInputOTP and ShadInputOTPFormField components.ShadBorder no longer has default values, if you want to see the border rendered provide a color and a width greater than 0. This fixes the merge of material borders.ShadTabs border radius.ShadSlider focused thumb.ShadResizable resize when Directionality is RTL.destructive color on dark mode to be more visible.Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.16.3...v0.17.0
FIX: showCursor default value in ShadInputFormField
showCursor default value in ShadInputFormFieldFull Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.16.2...v0.16.3
FIX: ShadTabs and ShadResizable lerp
ShadTabs and ShadResizable lerpShadTabs focused border color in dark modeFull Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.16.1...v0.16.2
FEAT: New ShadTimePicker and ShadTimePickerFormField components.
ShadTimePicker and ShadTimePickerFormField components.maxLength, maxLengthEnforcement and showCursor not working on ShadInputShadCalendar range day button text style when disableSecondaryBorder is true.3.24.0trackColor from ShadSwitch (thanks to @RaghavTheGreat)ShadSlider onChanged called on every controller update (thanks to @helightdev).Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.15.4...v0.16.0
chore: remove unnecessary track color in switch by @RaghavTheGreat1 in https://github.com/nank1ro/flutter-shadcn-ui/pull/194
3.24.0Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.15.3...v0.15.4
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.15.2...v0.15.3
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.15.2...v0.15.3
ShadDialog and ShadSheet children constraints.flutter_svg_plus dependency with flutter_svg and vector_graphics_plus with vector_graphics.Fix/sheet and dialog children constraints by @nank1ro in https://github.com/nank1ro/flutter-shadcn-ui/pull/192
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.15.1...v0.15.2
fix/decoration-merge by @nank1ro in https://github.com/nank1ro/flutter-shadcn-ui/pull/190
Full Changelog: https://github.com/nank1ro/flutter-shadcn-ui/compare/v0.15.0...v0.15.1
One column per month.