Best practices article for MAUI+RCLs #36535
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds a new best practices article that guides developers on creating Razor class libraries (RCLs) that combine .NET MAUI and Blazor Hybrid functionality. The article demonstrates the recommended architectural pattern of host-agnostic design where RCLs define abstractions through interfaces, and platform-specific implementations are provided via dependency injection.
Key changes:
- Introduces comprehensive guidance on separating platform-agnostic Razor components from MAUI-specific implementations
- Provides step-by-step instructions for creating RCLs, MAUI class libraries, and integrating them in MAUI Blazor apps
- Includes practical code examples demonstrating the abstraction pattern with device info services
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| aspnetcore/blazor/hybrid/class-libraries-best-practices.md | New article explaining best practices for combining Blazor Hybrid with .NET MAUI and RCLs, including architecture patterns, code examples, and troubleshooting guidance |
| aspnetcore/toc.yml | Adds the new article to the Table of Contents under Blazor Hybrid section after the Class libraries article |
Co-authored-by: Copilot <[email protected]>
BethMassi
approved these changes
Jan 6, 2026
Contributor
BethMassi
left a comment
BethMassi
left a comment
There was a problem hiding this comment.
This LGTM. We should probably also link to this article from this page too: https://review.learn.microsoft.com/en-us/aspnet/core/blazor/hybrid/reuse-razor-components
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fixes #36486
Adds the article as ...
aspnetcore/blazor/hybrid/class-libraries-best-practices.mdblazor/hybrid/class-libraries-best-practicesI versioned this at >=6.0, but I believe that at least some of the API (e.g.,
Microsoft.Maui.Devices.DeviceInfo) is >=9.0. Should the article be versioned >=9.0?Internal previews