.NET MAUI › Migration from Xamarin.Forms

What are the main steps to migrate a Xamarin.Forms app to MAUI?

Beginner

Answer

Create a new MAUI project (or use the .NET Upgrade Assistant), move shared code and XAML in, consolidate the platform head projects into the single project's Platforms folders, update NuGet packages to MAUI-compatible versions, replace custom renderers with handlers, and fix namespace changes (Xamarin.Forms -> Microsoft.Maui). Then test each platform.
Real-world example A team uses the .NET Upgrade Assistant to scaffold the MAUI project, then ports pages incrementally while keeping the app buildable.

Common follow-ups: What tool assists migration? | What happens to head projects?