Better sample pages in ".NET MAUI Blazor Hybrid and Web App" project template

[ToolmakerSteve]

Unless I've missed something, the Blazor Hybrid of this project is simply a thin wrapper for the razor components.

When I first saw Blazor Hybrid, I couldn't grasp how the C# code would interact with other, non-Blazor, Maui C# code. Need to show people that doing so is straightforward.

Suggestion: Demonstrate interaction between a Blazor Component, and a Maui class that can call an API on each device.

Two cases:

• Simple: use some Maui Essentials API or Maui Interface to hide the device-specific details.
  Perhaps the clipboard: https://learn.microsoft.com/en-us/dotnet/maui/platform-integration/data/clipboard?view=net-maui-9.0
• Advanced: Dependency Injection: https://learn.microsoft.com/en-us/dotnet/maui/fundamentals/dependency-injection?view=net-maui-9.0
  Show that each platform can implement a service in a different way on that platform.

[ToolmakerSteve]

UPDATE: Now I noticed these lines in Home.razor:

@using BlazorComponentsEverywhere.Shared.Services
@inject IFormFactor FormFactor

And the add service in MauiProgram.cs:

// Add device-specific services used by the BlazorComponentsEverywhere.Shared project
builder.Services.AddSingleton<IFormFactor, FormFactor>();

That's a start.

---

Maybe the biggest problem is documentation.

• Did I miss some top-level place (readme) in the solution generated by that project template, that says to see
  https://learn.microsoft.com/en-us/aspnet/core/blazor/hybrid/tutorials/maui-blazor-web-app ?
• Also, that is quite technical. I feel the "essence" of Blazor Hybrid is buried in nitty-gritty details. Not great, from a "tutorial" standpoint. What's lacking is a better description of the files in that project, and how they fit together. Start big picture, work down to lines of code.

Now I see:

• https://learn.microsoft.com/en-us/aspnet/core/blazor/project-structure?view=aspnetcore-9.0#blazor-web-app
  This is a somewhat better description of the Blazor Web App part of the combined solution. Should also be referenced in a readme.

• https://learn.microsoft.com/en-us/aspnet/core/blazor/hybrid
  Is similar for Blazor Hybrid. But is still not great, from a "tutorial" standpoint.

So the answer seems to be to refer to descriptions of the two pieces, Blazor Web App and Blazor Hybrid.
And only then, read the document about the two combined into one template.

All three of those links belong in a "readme" file.