Repository navigation
Add design migration guide - #13821
Conversation
There was a problem hiding this comment.
Code Review
This pull request adds documentation for migrating to the standalone material_ui and cupertino_ui packages, which decouple Flutter's design systems from the core SDK. The documentation covers automated and manual migration steps, the compatibility bridge, and localization changes. Feedback on the documentation suggests improving the code example for the compatibility bridge by safely handling a potentially null child widget instead of using a force-unwrap operator, which could lead to runtime exceptions.
|
Staged preview of the updated docs.flutter.dev site (updated for commit 3330f3f): |
|
Staged preview of the updated flutter.dev site (updated for commit 3330f3f): |
Do you mean beyond what is already here? This should cover it. |
Adds the migration guide for migrating to material_ui and cupertino_ui I believe we'll be adding more docs, or a dedicated page on the site, but it would be great to have a place to point for now that isn't just the latest the release blog. :) We'll be making a bigger call to action to migrate in the Fall release after we deprecate the original libraries. This should be good in the meantime for our early adopters. I already incorporated the early feedback we have received from them. Fixes flutter/flutter#191448 Related to flutter/flutter#191067 ## Presubmit checklist - [x] If you are unwilling, or unable, to sign the CLA, even for a _tiny_, one-word PR, please file an issue instead of a PR. - [ ] If this PR is not meant to land until a future stable release, mark it as draft with an explanation. - [x] This PR follows the [Google Developer Documentation Style Guidelines](https://developers.google.com/style)—for example, it doesn't use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person pronouns). - [x] This PR uses [semantic line breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks) of 80 characters or fewer.
Adds the migration guide for migrating to material_ui and cupertino_ui
I believe we'll be adding more docs, or a dedicated page on the site, but it would be great to have a place to point for now that isn't just the latest the release blog. :)
We'll be making a bigger call to action to migrate in the Fall release after we deprecate the original libraries. This should be good in the meantime for our early adopters. I already incorporated the early feedback we have received from them.
Fixes flutter/flutter#191448
Related to flutter/flutter#191067
Presubmit checklist
of 80 characters or fewer.