New to Telerik UI for .NET MAUI? Start a free 30-day trial

First Steps with Telerik UI for .NET MAUI

Updated on Jul 23, 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:

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.

Step 1: Set up your Telerik account

To use the Telerik UI for .NET MAUI controls, you need a Telerik account with an active license. If you have an active license, you can skip this step.

Go to the Telerik UI for .NET MAUI product page.
Click the Get Started or Try Now button.
Enter your email address and you will see the registration form.

Step 2: 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:

powershell

dotnet tool install -g Telerik.CLI --source https://api.nuget.org/v3/index.json

Step 3: Set Up Your Telerik .NET MAUI Environment with Telerik CLI

Use the telerik setup maui command to set up your Telerik environment:

powershell

telerik setup maui

The telerik setup maui command performs all the required setup steps at once:

✓ Logs you into your Telerik account.

✓ 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.

Step 4: Create a New MAUI Project

Choose your preferred IDE to create a new .NET MAUI project and install the Telerik UI for .NET MAUI controls:

Visual Studio Visual Studio Code

Step 1: Create a New MAUI Project

Open Visual Studio and select Create a new project in the start window.
Select the .NET MAUI App template, and click the Next button.
Name your project and select a location.
Choose the .NET framework for your project.
Wait until Visual Studio restores all dependencies (when done, all exclamation marks in the Dependencies tree view item disappear).
Click the Windows Machine button to build and run the app.

If you encounter any issues creating the basic project, see the complete guide in Microsoft's .NET MAUI documentation.

Step 2: Install the Telerik UI for .NET MAUI Controls

In Visual Studio go to Tools > NuGet Package Manager > Manage NuGet Packages for Solution....
Make sure the Package source is set to nuget.org.
Select the Browse tab, enter Telerik.UI.for.Maui in the search box, and select the package.
Select the checkbox for the target project, and then click Install.

Step 3: Add the Telerik Namespace and Register the Controls

To use the controls in the Telerik UI for .NET MAUI library, add the Telerik namespace:

In the MainPage.xaml file, locate the root element at the top.
Paste the Telerik namespace below the last already available namespace:
XAML
```
xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
```

To visualize the Telerik controls, register them in the MauiProgram.cs file of your project:

In the MauiProgram.cs file, add the following using statement:
C#
```
using Telerik.Maui.Controls.Compatibility;
```

In the CreateMauiApp method, call the UseTelerik extension method:

<!-- Code omitted for brevity -->
.UseMauiApp<App>()
.UseTelerik()
<!-- Code omitted for brevity -->

Step 4: Add a Telerik UI Component

In this step, you will replace the Button control in Microsoft's project template with a Telerik control. The Telerik UI for .NET MAUI TemplatedButton that you will use gives you full control over the Button's content.

To add the TemplatedButton control to the application:

Delete the existing Button and its event handler:
1. In the MainPage.xaml file, locate the Button with x:Name="CounterBtn" and delete it.
2. In the MainPage.xaml.cs code-behind, locate the OnCounterClicked event handler and delete it.

In the MainPage.xaml file, add the Telerik UI for .NET MAUI TemplatedButton and set its content to a string:

XAML

    <telerik:RadTemplatedButton x:Name="templatedButton" 
                                Content="My TemplatedButton Content"
                                Clicked="OnCounterClicked" />

After adding the basic TemplatedButton and setting the initial content, you can hit F5 to confirm that the app is running.