Skip to content

Create a migration guide for Material 3 #119319

Closed
flutter/website
#10076

Description

@guidezpl

https://m3.material.io/develop/flutter is the hub on material.io for Material 3 on Flutter. We should create a migration guide.

Existing guides include

I should also note https://blog.codemagic.io/migrating-a-flutter-app-to-material-3/ from @TahaTesser, @HansMuller is there anything missing from it?

Activity

  1. added
    frameworkflutter/packages/flutter repository. See also f: labels.
    p: material_uimaterial_ui package in flutter/packages
    on Jan 27, 2023
  2. moved this to 🗺 Planned in Material 3on Jan 27, 2023
  3. TahaTesser commented on Jan 27, 2023

    @TahaTesser
    Contributor

    I'd be happy to update the article to include anything missing.

  4. guidezpl commented on Jan 27, 2023

    @guidezpl
    MemberAuthor

    Great! Once we're closer to finishing the remaining work listed in #91605, let's re-evaluate and compare with the Views and Compose guides and make sure all aspects of migrating are covered.

  5. rydmike commented on Jan 29, 2023

    @rydmike
    Contributor

    @TahaTesser the article is great as it is, but if you have the opportunity, time and energy to update it, here are my suggestions:

    • The easy to use NavigationDrawer is mentioned, but it would be lovely to also see a teaser visual of it.
    • The DropdownMenu is not mentioned. It would be fabulous if it could be added. This new component is really wonderful and one that has been desperately asked for by many developers. Building something like it manually has been quite a challenging task to do in the past. Now it is finally available out of the box, and it is really good!
    • The new MenuBar and MenuAnchor could deserve a mention too, with some simple visuals of them.
    • This might make it a bit long, but I think it could be of general interest to point out the clever re-use of shared building blocks in DropdownMenu, MenuBar and MenuAnchor. Plus how the core of their flexible styling and theming capabilities is in large part built with the existing ButtonStyleButton and ButtonStyle via MenuItemButton, used by the already familiar Material buttons. Resulting in that menu items in all of them can have all of its powerful props and theming capabilities. These all also make great building block for making totally custom versions as well or new variants not thought of here. Although the out-of-the box ones, are so flexible and well designed I doubt there are many reasons to do so.
    • Other new and updated components that could be briefly mentioned and shown are Badge (could be added e.g. to the shopping cart FAB icon and mentioned) and BottomAppBar, that has a significantly changed style in M3.
  6. TahaTesser commented on Jan 29, 2023

    @TahaTesser
    Contributor

    @rydmike Thank you so much for your valuable feedback!

  7. self-assigned this
    on Nov 21, 2023
  8. moved this from 🗺 Planned to 🚧 In Progress in Material 3on Nov 21, 2023
  9. moved this from To do to PR submitted in Nevercodeon Jan 23, 2024
  10. moved this from 🚧 In Progress to ✅ Done in Material 3on Jan 29, 2024
  11. moved this from PR submitted to Done (PR merged) in Nevercodeon Jan 29, 2024
  12. github-actions commented on Feb 12, 2024

    @github-actions

    This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

  13. locked as resolved and limited conversation to collaborators on Feb 12, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

frameworkflutter/packages/flutter repository. See also f: labels.p: material_uimaterial_ui package in flutter/packagesteam-designOwned by Design Languages teamtriaged-designTriaged by Design Languages team

Type

No type

Projects

  • Status
    Done (PR merged)

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions