Skip to content

Commit 335bf39

Browse files
authored
Improve project creation guidance (#36118)
1 parent 180b6c7 commit 335bf39

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

aspnetcore/blazor/hybrid/tutorials/maui-blazor-web-app.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to build a .NET MAUI Blazor Hybrid app with a Blazor Web
55
monikerRange: '>= aspnetcore-8.0'
66
ms.author: wpickett
77
ms.custom: mvc
8-
ms.date: 11/12/2024
8+
ms.date: 09/17/2025
99
uid: blazor/hybrid/tutorials/maui-blazor-web-app
1010
---
1111
# Build a .NET MAUI Blazor Hybrid app with a Blazor Web App
@@ -30,18 +30,24 @@ If you haven't already installed the .NET MAUI workload, install it now. The .NE
3030
dotnet workload install maui
3131
```
3232

33-
Create a solution from the project template with the following .NET CLI command:
33+
Create a solution from the project template with the following .NET CLI command, replacing the `{INTERACTIVITY}` placeholder with the Blazor render mode that you desire to use:
34+
35+
* `Server`: Adopts the Interactive Server render mode and produces a single-project Blazor app.
36+
* `WebAssembly`: Adopts the Interactive WebAssembly render mode and produces two Blazor projects, a server project and a `.Client` project.
37+
* `Auto`: Adopts the Interactive Auto render mode and produces two Blazor projects, a server project and a `.Client` project.
38+
39+
For more information on the preceding render modes and the projects produced, see <xref:blazor/components/render-modes#render-modes> and the [Use Blazor render modes](#use-blazor-render-modes) section later in this article.
3440

3541
```dotnetcli
36-
dotnet new maui-blazor-web -o MauiBlazorWeb -I Server
42+
dotnet new maui-blazor-web -o MauiBlazorWeb -I {INTERACTIVITY}
3743
```
3844

3945
In the preceding command:
4046

4147
* The `-o|--output` option creates a new folder for the app named `MauiBlazorWeb`.
42-
* The `-I|--InteractivityPlatform` option sets the interactivity render mode to Interactive Server (`InteractiveServer`). All three interactive Blazor render modes (`Server`, `WebAssembly`, and `Auto`) are supported by the project template. For more information, see the [Use Blazor render modes](#use-blazor-render-modes) section.
48+
* The `-I|--InteractivityPlatform` option sets the interactivity render mode. The `{INTERACTIVITY}` placeholder is the interactive Blazor render mode. All three interactive Blazor render modes (`Server`, `WebAssembly`, and `Auto`) are supported by the project template. For more information, see <xref:blazor/components/render-modes#render-modes> and the [Use Blazor render modes](#use-blazor-render-modes) section.
4349

44-
The app automatically adopts global interactivity, which is important because MAUI apps always run interactively and throw errors on Razor component pages that explicitly specify a render mode. For more information, see [BlazorWebView needs a way to enable overriding ResolveComponentForRenderMode (`dotnet/aspnetcore` #51235)](https://github.com/dotnet/aspnetcore/issues/51235).
50+
The preceding command produces a Blazor app that adopts global interactivity, which is important because MAUI apps always run interactively and throw errors on Razor component pages that explicitly specify a render mode. For more information, see [BlazorWebView needs a way to enable overriding ResolveComponentForRenderMode (`dotnet/aspnetcore` #51235)](https://github.com/dotnet/aspnetcore/issues/51235).
4551

4652
:::moniker-end
4753

0 commit comments

Comments
 (0)