Table of Contents

How To: Create a New Uno Application

In this guide, you will learn how to create an Uno Platform application using the Wizard or dotnet CLI to follow, for example, the Xaml Navigation App Tutorial.

To follow along, you should have previously completed the Development Environment Setup Guide.

Video Tutorial on Configuration

Note

This video is currently only available in German, but transcriptions have been added to the video description, which should be usable through YouTube's auto-translate feature. You can also enable auto-translated subtitles in YouTube to follow along in your preferred language.

Create and Configure an Uno App via Template

In the following, you will learn how to configure an Uno app by selecting the desired options. You can either use the Visual Studio Wizard or the dotnet CLI tool. For the latter, it is recommended to visit the Web Wizard to make configuration easier and get the appropriate dotnet new command!

Select Template

  1. Open Visual Studio 2022 and select "Create a new project" in the start window.

  2. Search for the template "Uno App" and select it. Click "Next".

    select-template

  3. Give your project a name and enable the option "Place solution and project in the same directory". Then click "Create".

    place-project-in-sln

The Template Wizard

Select the following options in the Visual Studio Wizard to configure your app: (using the Xaml Navigation App Tutorial as an example)

  1. Use the preset recommended

  2. Target Framework: net9.0

  3. As Platform select at least Desktop or Skia Desktop.

  4. Markup: Xaml

    select-Xaml

  5. Presentation: MVUX

    select-MVUX

  6. Select the Material Design Theme under Themes.

    select-theme-optional-themeservice

    Tip

    By default, ThemeService is also selected, which would allow you to switch between light and dark UI later. It is not directly required here, but you can leave it in if you like.

  7. Extensions: Regions, DependencyInjection

    select-extensions

  8. (Optional) select the Uno Toolkit.

    select-toolkit-optional-vscode-debugging

    Tip

    If you want to keep the option open to develop in Visual Studio Code later, you should also select Visual Studio Code Debugging here.

  9. Finally, click Create to generate the app.

Edit this page