Changelog

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

New statusGlow and statusColor Parameters paint a breathing, status-coloured glowing rim that follows the capsule as it morphs (drawn still with reduced motion), and new actions and onAction arguments add up to 3 buttons under the expanded card, reachable by tap, keyboard and screen reader, each 48 points tall. Both are off by default, so the pill looks as before.

First release.

New optional extras, all off by default so the ring looks as before: a scale of tick marks (ticks, tickLength), warning and danger colour zones the arc shifts into smoothly as the value crosses warnAt and dangerAt, an overage past 100% drawn as a second lap in a deeper colour with the number counting past 100, and a celebrate option that turns the arc to a completion colour with one soft pulse when the ring reaches 100 (none with reduced motion).

First release.

First release.

First release.

First release.

First release.

First release.

First release.

It now holds still on its own when the platform asks for reduced motion (MediaQuery.disableAnimationsOf), so passing paused: for that reason is no longer needed.

The screen reader wording is now overridable: summaryLabel (count, highest bar name, value), emptyLabel and barName (for a bar with no label), for translating or rewording what screen readers hear. The default muted bar colour is lighter (71717A, was 2E2E3A) and the other bars' labels a little brighter, so bars reach 3:1 and labels 4.5:1 on dark surfaces.

Adds iconLabel, a function from ButtonGroupIcon to the name a screen reader gives an icon-only button, so it can be translated. Accessibility: the keyboard can focus each button (with a focus ring) and Space or Enter toggles it, and every button takes a touch over at least 48 by 48 even when it is drawn shorter. The default accent colour is a slightly deeper violet (6C4FFF, was 7C5CFF) so white text on it reaches 4.5:1.

New valueLabel argument words the value a screen reader hears ('60 por ciento'). The slider now takes keyboard focus (arrow keys step a detent, Home and End go to the ends, with a focus ring), the touch target is 44 pixels tall however thin the track, and the value follows text sizes up to 200%. The default active colour is a slightly deeper violet (6C4FFF, was 7C5CFF) so white text on it reaches 4.5:1.

New actionLabels, moreActionsLabel and closeMenuLabel arguments translate what screen readers announce for the actions and the overflow button. Every action, the overflow button and the menu items can now be reached with a keyboard (Tab), are outlined while focused and press with Enter or Space; each button takes taps 48 points square (drawn and laid out as before), and menu labels follow text sizes up to 200%.

The handle's screen reader names are now arguments (expandLabel, collapseLabel, moveToLabel), so you can translate them. The handle takes keyboard focus with a visible ring, Enter or Space toggles the sheet and the up and down arrows step it through its detents.

The default accent colour is slightly deeper so the white primary label reaches 4.5:1, and the label now picks white or near-black by whichever contrasts more on any accent. Buttons take keyboard focus with a visible ring, and labels follow text sizes up to 200%, wrapping instead of being cut off.

The minimized pill's screen reader names are now arguments (expandLabel, selectedLabel), so you can translate them. Tabs and the pill take keyboard focus with a visible ring and activate with Enter or Space, the hidden tabs leave the focus order while minimized, and labels follow text sizes up to 200%.

The clear button's name is now an argument (clearLabel; it still follows the app's language when null). The clear button's tap area is 48 points, it takes keyboard focus with a visible ring and activates with Enter or Space.

Accessibility: the keyboard can focus it (with a focus ring) and Space or Enter flips it, and the part that takes a touch is now at least 48 by 48 even though the track is shorter.

New progressLabel argument translates the percentage a screen reader reads out (the title, subtitle and value are already arguments). The pill can now be focused with a keyboard, is outlined while focused and toggles with Enter or Space, and the compact pill takes taps 48 points tall though it still draws 36.

New itemLabel argument translates the "Item 2 of 6" a screen reader hears for an item with no caption. Items can now be focused with a keyboard (Tab), are outlined while focused, scroll into the large slot as they gain focus, and activate with Enter or Space.

It now holds still on its own when the platform asks for reduced motion (MediaQuery.disableAnimationsOf), so passing paused: for that reason is no longer needed.

Adds openLabel and closeLabel, the names a screen reader gives the button, so they can be translated. Accessibility: the keyboard can focus the button and each action (with focus rings), Enter or Space activates them, an opened panel takes the focus and Esc closes it and returns it to the button. The default colour is a slightly deeper violet (6C4FFF, was 7C5CFF) so white text on it reaches 4.5:1.

New thousandsSeparator and decimalSeparator arguments (for example "." and "," in Spanish), also what screen readers hear; a new value now shows at once, without rolling, when the platform asks for reduced motion.

New pageLabel argument words what a screen reader hears ('Page 2 of 4') so it can be translated. With onDotTapped, the dots now take keyboard focus (arrow keys change page, with a focus ring), the row is at least 48 pixels tall to touch, and the default inactive dot is lighter (71717A) to reach 3:1 contrast on dark surfaces.

The title and subtitle now follow the user's text size up to 200% instead of stopping at 140%, and still fit the hero and the compact bar.

New semanticLabel (what a screen reader calls the ring), valueLabel (the words for its value, such as '72 por ciento') and percentSign (the sign after the number) arguments, so every word can be translated.

The control now takes keyboard focus: the arrow keys (mirrored right to left) select the previous or next segment, Home and End the first and last, and a ring shows the focus. The default pill colour is a slightly deeper violet (6C4FFF, was 7C5CFF) so white text on it reaches 4.5:1.

Screen readers now hear a semanticsLabel (default "Loading", an argument for other languages) instead of nothing, and the sheen holds still on its own when the platform asks for reduced motion, without passing paused.

The band of light now holds still on its own when the platform asks for reduced motion; passing paused: MediaQuery.disableAnimationsOf(context) is no longer needed.

Adds moreOptionsLabel, the name a screen reader gives the chevron, so it can be translated. Accessibility: the keyboard can focus both segments and the menu items (with focus rings), Enter or Space activates them, an opened menu takes the focus and Esc closes it and returns it to the chevron, and both segments take a touch over at least 48 by 48. The default colour is a slightly deeper violet (6C4FFF, was 7C5CFF) so white text on it reaches 4.5:1.

Accessibility: the keyboard can focus it (with a focus ring in the text colour) and Enter or Space presses it, and with reduced motion turned on it no longer squashes. The default background is a slightly deeper violet (6C4FFF, was 7C5CFF) so white text on it reaches 4.5:1.

New swipeLeftLabel and swipeRightLabel arguments word the screen reader actions so they can be translated. The top card can now be swiped with the left and right arrow keys, with a focus ring. If your cards are not buttons, add buttons of your own that do what a swipe does, for people who cannot drag. Or pass a SwipeCardStackController as controller and call its swipeLeft and swipeRight from those buttons.

The words screen readers hear are now arguments: loadingLabel (default "Loading") and valueLabel (a function from the percentage, default "64%"), for other languages.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

A level that is not a finite number (NaN or infinity, say from a bad microphone reading) now reads as 0 instead of swelling the glow to full.

First release.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

Adds selection, a Set<int> a parent keeps in step with onChanged, so a parent can hold a multi-select selection and reset it; selected is still the starting button, and is ignored while selection is given.

First release.

Setting onChanged to null during a drag now ends the drag and calls onChangeEnd, a value the parent changes during a drag (such as one it limits) is applied when the drag ends, and changing only detents now reports the re-snapped value through onChanged.

First release.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

First release.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

A parent that mirrors onExpandedChanged into expanded, or onDetentChanged into detent, no longer pulls the sheet to another detent: dragging from large to medium, or from medium to small with expanded left true, now stays where the user let go.

Three detents like an iOS 26 sheet: small, a new medium (mediumFraction) and large. Drags snap to the nearest one and flings skip to the last. A new detent Parameter sets where the sheet rests and onDetentChanged reports moves; expanded keeps working. A new inset Parameter floats the sheet clear of the edges at small and medium, with all four corners rounded, widening to full width with square bottom corners as it rises to large.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

The usage example passes the scroll controller of the list behind the bar, instead of a new controller that watches nothing and so never minimizes the bar.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

Expanding the bar partway down the content (tapping the pill or setting minimized: false) no longer re-minimizes it on the next pixel of scroll, turning minimizeOnScroll back on no longer counts scrolling done while it was off, and turning it off while minimized returns the bar to minimized (expanding it by default).

Minimizes like iOS 26: pass scrollController with minimizeOnScroll and scrolling down springs the bar into a glass pill at the leading edge showing the selected tab's icon; scrolling up, reaching the top or tapping the pill expands it. Adds minimized to drive it yourself, onMinimizedChanged, and jumps instead of springing when reduced motion is on.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

Toggling reduced motion mid-morph no longer leaves the pill at the wrong size afterwards; the pill now sizes itself inside IntrinsicHeight and IntrinsicWidth and supports dry layout; and a compact value too long for the space is cut short with an ellipsis instead of pushing the icon out of the pill.

First release.

First release.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

The usage example passes your PageView's controller, instead of a new controller that follows no pages.

In debug builds, a badge now names the shader when it fails to load and how to fix it.

A bar showing a title or actions now absorbs taps across its whole area, beside the title too, instead of letting them reach the content scrolled under it; the band below the bar, and a bare scroll edge with neither, still let taps through.

First release.

Time spent muted on an offstage route no longer skips the loader through several shapes when it returns; it carries on from where it stopped.

First release.

Given more width than it needs, the menu lines up with the chevron and the chevron closes it; a menu too tall for the screen stays on it and scrolls; disabling onMenuItem closes the menu, keeps it closed and reports it through onOpenChanged. The open default stays true for the Preview, so pass open: false in an app.

First release.

Switching from indeterminate to a value now sweeps up from empty instead of from the stale value, a small ring follows a long wavelength (at least one wave instead of three), and time spent muted on an offstage route no longer jumps the wave on when it returns.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.

First release.