[material_ui] Add the Material shapes. by ksokolovskyi · Pull Request #12771 · flutter/packages

ksokolovskyi · 2026-09-06T15:52:04Z

Description

Adds the Material shapes library to material_ui, a Dart port of the AndroidX graphics-shapes library and the Compose MaterialShapes catalog. These APIs are the foundation for upcoming M3 Expressive components (loading indicator, wavy progress indicators, etc.) and let app developers use the Material shape catalog and shape-morphing animations directly.

New public API:

RoundedPolygon, CornerRounding: creation and normalization of rounded polygonal shapes.
MaterialShapes: the catalog of 35 predefined Material Design shapes (pictured below).
MaterialShapeBorder: an OutlinedBorder that draws a RoundedPolygon, so the shapes plug into the existing ShapeDecoration/shape APIs and morph between each other through the usual border lerping.

The port keeps the geometry and behavior of the Kotlin original (unit tests are ported from AndroidX alongside new ones), while adapting the API surface to Dart/Flutter conventions. Every shape in MaterialShapes.all is covered by a golden test. Also includes a new example that morphs through the whole catalog.

Closes flutter/flutter#184934

Shapes catalog

Example

material_shapes_example.mov

Pre-Review Checklist

If you need help, consider asking for advice on the #hackers-new channel on Discord.

Note: The Flutter team is currently trialing the use of Gemini Code Assist for GitHub. Comments from the gemini-code-assist bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. ↩ ↩²

…erialShapeBorder.

ksokolovskyi · 2026-10-12T11:42:51Z

Thank you for the review, @QuncCccccc! I addressed all of your comments.
Please take another look when you have a moment 🙏

Piinks

LGTM thank you so much for all of this!

Co-authored-by: Qun Cheng <[email protected]>

ksokolovskyi · 2026-10-13T08:30:52Z

LGTM thank you so much for all of this!

@Piinks, thanks a lot for your review!

ksokolovskyi · 2026-10-13T08:31:55Z

@QuncCccccc, thanks a lot for all your suggestions, let me know if you would like to change anything else!

QuncCccccc

LGTM! Thank you for adding all the new shapes!!

ksokolovskyi · 2026-10-14T19:32:49Z

@elliette @QuncCccccc @Piinks, thanks a lot for your reviews!

Roll Packages from a1ed23c to da40eaf (33 revisions) flutter/packages@a1ed23c...da40eaf 2026-10-15 [email protected] [pigeon]add support for sealed classes in native interop (flutter/packages#13175) 2026-10-15 [email protected] [pigeon] Replace full JNI bindings with stubs for API classes that aren't needed (flutter/packages#13173) 2026-10-14 [email protected] [material_ui] Fix self-comparison and assert bugs in semantics_tester (flutter/packages#12722) 2026-10-14 [email protected] [camera_avfoundation] Replace the deprecated 'videoOrientation' with 'videoRotationAngle' on iOS 17+ (flutter/packages#13247) 2026-10-14 [email protected] [material_ui] Fix GridTile crash when the incoming constraints are unbounded (flutter/packages#12586) 2026-10-14 [email protected] [in_app_purchase_storekit] Remove unused and deprecated "SKDownload" hosted content (flutter/packages#13222) 2026-10-14 [email protected] [material_ui] Add supportingTextPadding to InputDecorator (flutter/packages#12769) 2026-10-14 [email protected] [vector_graphics_codec] Add support for encoding and decoding paint blur commands (flutter/packages#13148) 2026-10-14 [email protected] [go_router] Fix redirect zone async error handling (flutter/packages#12836) 2026-10-14 [email protected] Sync release-go_router-18.1.0 to main (flutter/packages#13260) 2026-10-14 [email protected] Sync release-cupertino_ui-1.1.3 to main (flutter/packages#13258) 2026-10-14 [email protected] [material_ui] add enableInlinePrediction parameter to TextFormField (flutter/packages#12793) 2026-10-14 [email protected] Sync release-material_ui-1.7.0 to main (flutter/packages#13259) 2026-10-14 [email protected] [material_ui] Add the Material shapes. (flutter/packages#12771) 2026-10-14 [email protected] [material_ui] Add tertiary tap callbacks to InkResponse and InkWell (flutter/packages#12676) 2026-10-14 [email protected] Roll Flutter from 4249ccb to 426be96 (44 revisions) (flutter/packages#13256) 2026-10-14 [email protected] [material_ui] fixes expanded state in the a11y_assessment home page dropdown (flutter/packages#13219) 2026-10-14 [email protected] [VPAT] Fix semantics in a11y_assessments drawer, radio, and rail demos (flutter/packages#13159) 2026-10-14 [email protected] [google_maps_flutter] Add onPointOfInterestTap (flutter/packages#11872) 2026-10-14 [email protected] [go_router] Fix shell route key collisions and dynamic branch updates (flutter/packages#12549) 2026-10-14 [email protected] Manual roll Flutter from d03768e to 4249ccb (158 revisions) (flutter/packages#13220) 2026-10-14 [email protected] [image_picker_ios] Require Flutter 3.47 / iOS 15 and drop deprecated kUTType code paths (flutter/packages#13224) 2026-10-13 [email protected] [in_app_purchase_storekit] Fixes Storekit 2 flaky tests (flutter/packages#13213) 2026-10-13 [email protected] [local_auth] Convert Android to new Pigeon suspend support (flutter/packages#12894) 2026-10-13 [email protected] [material_ui] Add enabled parameter to DropdownButtonFormField (flutter/packages#12610) 2026-10-13 [email protected] [go_router] Link ShellRoute docs to StatefulShellRoute (flutter/packages#13120) 2026-10-13 [email protected] FadeForwards page transition performance (flutter/packages#13161) 2026-10-13 [email protected] [in_app_purchase_android] Guard async billing callbacks against duplicate listener responses (flutter/packages#12640) 2026-10-13 [email protected] [google_sign_in] Remove the Objective-C exception catcher (flutter/packages#13156) 2026-10-13 [email protected] [camera_avfoundation] Remove availability checks below the package minimum iOS 13 (flutter/packages#13214) 2026-10-13 [email protected] [google_maps_flutter_ios] Remove iOS 14 availability check from example UI tests (flutter/packages#13218) 2026-10-13 [email protected] [google_sign_in] Convert implementation to Kotlin (flutter/packages#13005) 2026-10-13 [email protected] [image_picker_ios] PR 2/5 Add a PHImageManager image-data seam and migrate plugin native tests to Swift Testing (flutter/packages#13079) If this roll has caused a breakage, revert this CL and set the roller to dry run mode using the controls here: https://autoroll.skia.org/r/flutter-packages-flutter-autoroll Please CC [email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Flutter: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: ...

ksokolovskyi added 30 commits August 21, 2026 19:17

Copy ksokolovskyi/material_shapes into material_ui.

1fccb31

Apply dart format and fix.

6c460a7

Add license headers.

e17a104

Collapse the doubled shapes directory.

33011e8

Split the shapes part library into separate libraries.

3e688cf

Rename Cubic to CubicBezier.

729715b

Align shapes visibility with the AndroidX public API.

07a87d1

Document the public members of the shapes API.

36c8770

Fix analyzer issues.

0e1f0fa

Expose material shapes from material_ui.

dcb65e9

Add material shapes example.

9bcdadf

Add golden tests for all MaterialShapes.

92a3707

Make the internal Point an alias for Offset.

5907f49

Return Rect from the shapes bounds methods.

eb8195c

Use an Offset center in the RoundedPolygon API.

ff1cae7

Use a List<Offset> for the RoundedPolygon vertices.

2492e0b

Use Offset in the CubicBezier API.

25304df

Clean up the shapes toPath parameters and fix the rotation pivot.

5147b00

Fix the shapes equality and hashCode list-identity bugs.

b0d2c7a

Add value equality to the shapes features.

0bd1924

Add more MaterialShapeBorder tests.

b0d14b2

Cache the MaterialShapeBorder morph across lerps.

70be604

Fix the MaterialShapeBorder crash on an interrupted transition.

214221d

Rename CubicBezier.zeroLength() to isZeroLength.

ee72777

Rename Morph.asCubics() to toCubics().

fd2e02b

Make RoundedPolygon.fromVerticesNum the default constructor.

6009439

Rename the Feature factories off their Kotlin build* prefix.

fb5d3d8

Unify the shapes reverse naming on a reversed getter.

a9eacd7

Turn the shapes bounds methods into getters.

64fc89f

Turn RoundedPolygon.normalized into a getter.

f4f02a8

QuncCccccc reviewed Oct 11, 2026

View reviewed changes

Comment thread packages/material_ui/lib/src/shapes/shapes.dart Resolved

Comment thread packages/material_ui/lib/src/shapes/rounded_polygon.dart Resolved

ksokolovskyi added 7 commits October 12, 2026 12:48

Rename the shapes example title to Material 3 Expressive shapes.

49be44d

Move the morph cache test helper out of MaterialShapeBorder.

76d7d73

Expose MaterialShapes.all as a plain unmodifiable List.

fdf69f2

Make RoundedPolygon final and hide its internal members.

5c8377d

Animate the shapes example with MaterialShapeBorder.

c97de80

Limit the public shapes API to RoundedPolygon, CornerRounding and Mat…

4271b71

…erialShapeBorder.

Update changelog.

e6efbb5

ksokolovskyi requested a review from QuncCccccc October 12, 2026 11:44

Piinks approved these changes Oct 12, 2026

View reviewed changes

QuncCccccc reviewed Oct 12, 2026

View reviewed changes

ksokolovskyi and others added 4 commits October 13, 2026 10:28

Remove explicit theme from material shapes example.

539eab0

Co-authored-by: Qun Cheng <[email protected]>

Update shapes example name.

e515b57

Co-authored-by: Qun Cheng <[email protected]>

Update test.

ebaccb2

Co-authored-by: Qun Cheng <[email protected]>

Update MaterialShapeBorder docs.

725fb2b

Co-authored-by: Qun Cheng <[email protected]>

ksokolovskyi requested a review from QuncCccccc October 13, 2026 08:30

Fix formatting.

229998c

QuncCccccc approved these changes Oct 14, 2026

View reviewed changes

Merge branch 'main' into add-material-shapes-to-material-ui

72f6614

QuncCccccc added the autosubmit Merge PR when tree becomes green via auto submit App label Oct 14, 2026

auto-submit Bot merged commit 8f190aa into main Oct 14, 2026
13 checks passed

auto-submit Bot deleted the add-material-shapes-to-material-ui branch October 14, 2026 18:54

engine-flutter-autoroll mentioned this pull request Oct 15, 2026

Roll Packages from a1ed23c8f760 to da40eaf4548a (33 revisions) flutter/flutter#194459

Merged

ksokolovskyi mentioned this pull request Oct 25, 2026

[material_ui] Add Material 3 Expressive loading indicator #13429

Open

11 tasks done

Navigation Menu

Repository navigation

[material_ui] Add the Material shapes. - #12771

[material_ui] Add the Material shapes.#12771
auto-submit[bot] merged 114 commits into
mainfrom
add-material-shapes-to-material-ui

ksokolovskyi commented Sep 6, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

ksokolovskyi commented Oct 12, 2026

Uh oh!

Piinks left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ksokolovskyi commented Oct 13, 2026

Uh oh!

ksokolovskyi commented Oct 13, 2026

Uh oh!

QuncCccccc left a comment

Uh oh!

Uh oh!

ksokolovskyi commented Oct 14, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

ksokolovskyi commented Sep 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Shapes catalog

Example

Pre-Review Checklist

Footnotes

Uh oh!

Uh oh!

Uh oh!

ksokolovskyi commented Oct 12, 2026

Uh oh!

Piinks left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ksokolovskyi commented Oct 13, 2026

Uh oh!

ksokolovskyi commented Oct 13, 2026

Uh oh!

QuncCccccc left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ksokolovskyi commented Oct 14, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

ksokolovskyi commented Sep 6, 2026 •

edited

Loading