# 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](https://dotnet.microsoft.com/en-us/download) | 10.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 10.0 and .NET 11.0 (starting with version 16.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
```

2. 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](https://www.telerik.com/maui-ui/documentation/get-started/quickstart#set-up-telerik-development-environment).

To create a new Telerik .NET MAUI app, use your preferred approach:

<TabStrip>
<TabStripTab title="Telerik.CLI">

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.

</TabStripTab>
<TabStripTab title=".NET CLI">

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 following 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 details about the Telerik UI for .NET MAUI projectTemplates in .NET CLI, review the [Telerik.Maui.Templates packages](https://www.nuget.org/packages/Telerik.Maui.Templates).

</TabStripTab>
</TabStrip>

## Next Steps

<article-card-container>
	<article-card
		href="/aicomponents"
		src="/maui-ui/documentation/assets/16321f5a65c2a527641999ce3ccfa3a1/aiprompt_light_large.svg"
		title="AI Components"
		subTitle="AI Controls & Features"
		darkSrc="/maui-ui/documentation/assets/fd20d47973fa3004bcf03f1cc2bcbff3/aiprompt_dark_large.svg"
		description="Explore the AI-powered controls and features available in Telerik UI for .NET MAUI.">
	</article-card>
	<article-card
		href="/ai/mcp-server"
		src="/maui-ui/documentation/assets/1a95789349616f5a96ee349e0f03d262/chat_light_large.svg"
		title="Agentic UI Generator"
		subTitle="MCP Server"
		darkSrc="/maui-ui/documentation/assets/06aafd25826499f4c99348b6786b8c59/ai_data_operations_dark_large.svg"
		description="Use the Telerik MCP server to get AI-assisted coding support for .NET MAUI development.">
	</article-card>
	<article-card
		href="/introduction#list-of-net-maui-ui-controls"
		src="/maui-ui/documentation/assets/874604fc63fa5ae896e2dc26efd37596/ai_data_operations_light_large.svg"
		title="Use Controls"
		subTitle="All Controls"
		description="Browse the full list of Telerik UI for .NET MAUI controls available for your application.">
	</article-card>
	<article-card
		href="/demos-and-sample-apps/overview"
		src="/maui-ui/documentation/assets/14b606259e9724141d5c5557b8bbc6f0/controls-samples-android.png"
		title="Sample Applications"
		subTitle="Sample Apps"
		description="Explore sample applications built with Telerik UI for .NET MAUI to see the controls in action.">
	</article-card>
	<article-card
		href="/styling-and-themes/overview"
		src="/maui-ui/documentation/assets/05670a21d02201cb845d0ef5d5fcfe7a/front-image.png"
		title="Theming and Styles"
		subTitle="Styling"
		description="Learn how to apply and customize themes across your Telerik UI for .NET MAUI application.">
	</article-card>
	<article-card
		href="/font-icons/examples-icons"
		src="/maui-ui/documentation/assets/d93a3e34fb43bee33ac1ab220941e590/font-icons.png"
		title="Font Icons"
		subTitle="Icons"
		description="Use the built-in Telerik font icons to enhance your .NET MAUI application UI.">
	</article-card>
</article-card-container>
