A .NET workload is an installable part of .NET that provides a specialized development platform or toolchain. .NET MAUI is a workload, not an independently installed SDK, so it is treated as a core part of the .NET development experience. section 1.2
This matters because MAUI development can use familiar .NET tools and services: Visual Studio, Visual Studio Code, the .NET CLI, build and DevOps tools, and NuGet packages. A workload makes MAUI projects fit the same broader ecosystem as other .NET projects. section 1.4
Before creating a MAUI app, prepare the workload and choose a workflow:
- Install the .NET MAUI workload through the Visual Studio installer or the .NET CLI. section 2.1
- Install the blank MAUI project template separately when following a blank-project workflow. section 2.1
- Use Visual Studio for a first-class experience, or use Visual Studio Code and the .NET CLI if that suits your workflow. section 1.4 section 2.1
- Use command help such as dotnet new --help to discover template options and switches. section 2.1.2
Create a blank MAUI app
After installing the workload and blank template, create a folder, enter it, and run dotnet new blankmaui. The CLI generates a MAUI solution using the containing folder name by default. Supply -n and -o to choose a solution name and output directory instead, as in dotnet new blankmaui -n HelloWorld -o C:\code\HelloWorld. section 2.1 section 2.1.2
.Table 2.1 A summary of the .NET MAUI templates
Compare the MAUI CLI templates to choose a standard app, Blazor app, shared class library, page, or reusable view starting point. section 2.1.2
Choose a template that matches the task: use maui for a standard app, maui-blazor for a MAUI app with a Blazor-defined UI, and mauilib for code intended to be shared among MAUI projects. Template inputs and switches follow the same conventions as other .NET templates. section 2.1.2
