First Steps with Telerik UI for .NET MAUI
This guide walks you through the essential steps to get Telerik UI for .NET MAUI up and running in your app.
Prerequisites
The following table lists the requirements to build .NET MAUI apps with Telerik UI for .NET MAUI:
| Requirement | Minimum version |
|---|---|
| .NET SDK | 9.0 or later |
| Operating system | Windows or macOS |
| Telerik account | Active subscription or trial license required. |
| IDE | Visual Studio 2022 17.12 or later, or Visual Studio Code with the .NET MAUI workloads installed. |
Telerik UI for .NET MAUI supports .NET 11.0 Preview 6 (starting with version 15.0.0).
Set Up Telerik Development Environment
This getting started guide uses the Telerik CLI .NET command tool to set up your development environment. The Telerik CLI is a command-line interface that helps you manage your Telerik account, license, NuGet package sources and Telerik MCP server.
- Install the Telerik CLI:
dotnet tool install -g Telerik.CLI --source https://api.nuget.org/v3/index.json
- Run the Telerik.CLI
setupcommand:
telerik setup maui
The telerik setup maui command performs multiple actions to configure your Telerik development environment:
✓ Creates your Telerik account or log in if you already have one.
✓ Activates a Telerik UI for MAUI trial if you don't have an active license.
✓ Downloads your Telerik license key file and saves telerik-license.txt to your operating system user's folder, making it available to all Telerik .NET apps on your machine.
✓ Configures the Telerik NuGet package source.
✓ Installs the Telerik MCP server for AI-powered coding assistance.
✓ Installs the Telerik UI for MAUI project templates.
Create New MAUI Project
This section assumes that you have successfully installed the Telerik UI for MAUI project templates in the previous step.
To create a new Telerik .NET MAUI app, use your preferred approach:
Run the following Telerik.CLI command to create a new Telerik .NET MAUI app interactively:
telerik create maui
Follow the instructions for creating a .NET MAUI app. The command creates a new project using the Telerik MAUI ProjectTemplates—Telerik .NET MAUI Blank App or Telerik .NET MAUI Blank Shell App.
When the project is ready, navigate to the project folder and open the app in your preferred IDE.
Use the .NET CLI dotnet new command to create a new Telerik .NET MAUI Blank App:
dotnet new telerik-maui -o MyNewTelerikMAUIAppName
If the above command fails with type of error:
No templates or subcommands found matching:, run the follwoing command in the terminal first:powershelldotnet new install Telerik.Maui.TemplatesThen run the command:
dotnet new telerik-maui -o MyNewTelerikMAUIAppName
The application includes the Telerik UI for .NET MAUI suite already set up.
When the project is ready, navigate to the project folder and open the app in your preferred IDE.
For more detials about the Telerik UI for .NET MAUI projectTemplates in .NET CLI, review the Telerik.Maui.Templates packages.
Next Steps



