New to Telerik UI for .NET MAUIStart a free 30-day trial

First Steps with Telerik UI for .NET MAUI

Updated on Aug 12, 2026

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:

RequirementMinimum version
.NET SDK9.0 or later
Operating systemWindows or macOS
Telerik accountActive subscription or trial license required.
IDEVisual 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.

  1. Install the Telerik CLI:
powershell
dotnet tool install -g Telerik.CLI --source https://api.nuget.org/v3/index.json
  1. Run the Telerik.CLI setup command:
powershell
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:

powershell
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:

powershell
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:

powershell
dotnet new install Telerik.Maui.Templates

Then 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

AI Components
AI Controls & Features
Explore the AI-powered controls and features available in Telerik UI for .NET MAUI.
AI Coding Assistant
MCP Server
Use the Telerik MCP server to get AI-assisted coding support for .NET MAUI development.
Use Controls
All Controls
Browse the full list of Telerik UI for .NET MAUI controls available for your application.
Sample Applications
Sample Apps
Explore sample applications built with Telerik UI for .NET MAUI to see the controls in action.
Theming and Styles
Styling
Learn how to apply and customize themes across your Telerik UI for .NET MAUI application.
Font Icons
Icons
Use the built-in Telerik font icons to enhance your .NET MAUI application UI.