You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/apps/get-started/samples.md
-6Lines changed: 0 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,9 +47,3 @@ You can get the [**Windows Community Toolkit Gallery app from the Microsoft Sto
47
47
[**.NET Community Toolkit**](https://github.com/CommunityToolkit/dotnet)
48
48
49
49
The .NET Community Toolkit is a collection of NuGet packages with high-performance helpers, extensions, and APIs designed to enhance .NET development across WinUI, WPF, MAUI, and other .NET applications. A key component is the [MVVM Toolkit](/dotnet/communitytoolkit/mvvm/), a lightweight and modern Model-View-ViewModel (MVVM) library that simplifies app architecture with features like observable properties, commands, and dependency injection. Built for performance and flexibility, the MVVM Toolkit helps you implement MVVM patterns efficiently while keeping your code clean and maintainable.
Template Studio provides a powerful scaffolding tool for quickly generating modern Windows applications using WinUI or WPF. The Visual Studio extension guides developers through a wizard-based experience to create project templates with best practices, including MVVM architecture, navigation patterns, dependency injection, and predefined app features. By automating boilerplate setup, Template Studio helps developers focus on building great experiences while ensuring consistency and maintainability in their applications.
title: Set up your environment and create your first WinUI project
3
3
description: List of steps to get started developing Windows apps with WinUI and the Windows App SDK.
4
4
ms.topic: how-to
5
-
ms.date: 12/18/2025
5
+
ms.date: 02/18/2026
6
6
keywords: windows, desktop development
7
7
ms.localizationpriority: medium
8
8
ms.collection: windows11
9
9
---
10
10
11
-
# Quickstart for WinUI and Windows App SDK
11
+
# Quick start: Set up your environment and create a WinUI project
12
12
13
-
This Hello World guide walks you through setting up your WinUI and Windows App SDK development environment in Visual Studio and creating your first app.
13
+
This quick start guide walks you through setting up your WinUI and Windows App SDK development environment and creating your first app. To develop WinUI apps, you need:
14
14
15
-
## 1. Enable Developer Mode
15
+
-[Visual Studio 2026](/visualstudio/ide/) with the required workloads for WinUI and Windows App SDK
16
+
-[Developer Mode](/windows/advanced-settings/developer-mode) enabled on your device
16
17
17
-
Windows includes a Developer Mode that adjusts security settings to let you run and test apps you're building. Enable Developer Mode before building, deploying, and testing your app with Visual Studio.
18
+
## Set up your development environment
18
19
19
-
> [!TIP]
20
-
> If you don't enable Developer Mode now, Visual Studio prompts you to enable it when you try to build your app.
21
-
22
-
To enable Developer Mode:
23
-
24
-
* Open Windows Settings and navigate to the **[System > Advanced](ms-settings:developers)** page.
25
-
* Toggle the **Developer Mode** switch to **On** and confirm your choice in the confirmation dialog.
26
-
27
-
For more information about Developer Mode, see [Settings for developers](/windows/advanced-settings/developer-mode).
20
+
#### [WinGet Configuration](#tab/wingetconfig)
28
21
29
-
## 2. Install Visual Studio and the required workloads for WinUI and Windows App SDK
22
+
Open [Windows Terminal](/windows/terminal/)and run the following command in PowerShell to automatically set up your environment using a [WinGet Configuration file](../../package-manager/configuration/index.md). This will:
30
23
31
-
Use [Visual Studio](/visualstudio/ide/), Microsoft's IDE, to build, debug, and deploy WinUI apps. Visual Studio includes ready-to-use project templates for Windows that help you get started quickly.
24
+
- Install Visual Studio 2026 with the required workloads
25
+
- Enable Developer Mode
32
26
33
-
The free **Visual Studio Community** edition includes everything you need to develop apps. **Professional** and **Enterprise** editions are available for larger teams or organizations. For more details, see [What is Visual Studio?](/visualstudio/get-started/visual-studio-ide) and the [system requirements for Windows app development](../windows-app-sdk/system-requirements.md).
27
+
```powershell
28
+
winget configure -f https://aka.ms/winui-config
29
+
```
34
30
35
-
### [WinGet](#tab/winget)
31
+
> [!TIP]
32
+
> To review the config file and learn more, see its [README](https://github.com/microsoft/winget-dsc/blob/main/samples/Configuration%20files/Learn%20tutorials/WinUI/README.md] on GitHub.
36
33
37
-
Install the required tools and workloads by running one of the following commands in a console.
38
-
The command opens the Visual Studio Installer with any missing workloads preselected — select **Modify** to install them.
34
+
#### [Manual installation](#tab/manual)
39
35
40
-
You can replace *Community* with *Professional* or *Enterprise* to install a different Visual Studio edition.
36
+
#### Enable Developer Mode
41
37
42
-
**For C# app development**
38
+
Windows includes a [Developer Mode](/windows/advanced-settings/developer-mode) that adjusts security settings to let you run and test apps you're building. Enable Developer Mode before building, deploying, and testing your app with Visual Studio.
43
39
44
-
```console
45
-
winget install "Visual Studio Community 2022" --override "--add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.ComponentGroup.WindowsAppSDK.Cs" -s msstore
46
-
```
47
-
48
-
**For C++ app development**
40
+
To enable Developer Mode:
49
41
50
-
```console
51
-
winget install "Visual Studio Community 2022" --override "--add Microsoft.VisualStudio.Workload.NativeDesktop Microsoft.VisualStudio.ComponentGroup.WindowsAppSDK.Cpp" -s msstore
52
-
```
42
+
* Open Windows Settings and navigate to the **[System > Advanced](ms-settings:developers)** page.
43
+
* Toggle the **Developer Mode** switch to **On** and confirm your choice in the confirmation dialog.
53
44
54
-
###[Manual installation](#tab/manual)
45
+
#### Install Visual Studio and the required WinUI and Windows App SDK workloads
55
46
56
47
Download and install the latest Visual Studio using the link below. For details, see [Install Visual Studio](/visualstudio/install/install-visual-studio).
When installing Visual Studio, include the workloads and components required for developing with WinUI and the Windows App SDK. After installation, you can open the Visual Studio Installer and select **Modify** to add workloads or components.
64
-
65
-
On the **Workloads** tab in the Visual Studio Installer, select the following workloads and components:
54
+
In the Visual Studio Installer, select the following workloads on the **Workloads** tab. If Visual Studio is already installed, open the installer and select **Modify** to add them.
66
55
67
56
***For C# app development** using the Windows App SDK, select **WinUI application development**.
68
57
@@ -75,38 +64,44 @@ On the **Workloads** tab in the Visual Studio Installer, select the following wo
75
64
76
65
---
77
66
78
-
## 3. Create and launch your first WinUI app
79
-
80
-
Visual Studio project templates include everything you need to create an app quickly. When you create a project from a WinUI app template, you start with a runnable app that you can extend with your own code.
67
+
## Create and launch your first WinUI app
81
68
82
-
To create a new project using the **WinUI C# Blank App** project template:
69
+
1. Open Visual Studio and select **Create a new project**.
83
70
84
-
1. Open Visual Studio and select **Create a new project** on the launch page. If Visual Studio is already open, select **File** > **New** > **Project**.
85
-
:::image type="content" source="images/hello-world/start-project.png" alt-text="Create a new project":::
71
+
2. Search for **WinUI**, select the **WinUI Blank App (Packaged)** C# project template, and select **Next**.
86
72
87
-
1. Search for **WinUI**, select the **WinUI Blank App (Packaged)** C# project template, and then select **Next**.
1. Specify a project name, then select **Create**. You can optionally specify a solution name and directory, or leave the defaults. In this image, the `Hello World` project belongs to a `Hello World` solution, which lives in `C:\Projects\`:
:::image type="content" source="images/header-packaging.png" alt-text="Blue wrench and screwdriver icons on a light gray banner background representing tools for app packaging and deployment." border="false":::
Copy file name to clipboardExpand all lines: hub/apps/tutorials/winui-notes/intro.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ ms.date: 09/02/2025
7
7
ms.topic: tutorial
8
8
ms.localizationpriority: medium
9
9
---
10
-
# Create a WinUI app
10
+
# Create your first WinUI app
11
11
12
12
This tutorial series demonstrates how to create a WinUI app using XAML and C#. The app you'll create is a note app, where the user can create, save, and load multiple notes. You can download or view the code for this tutorial from the [GitHub repo](https://github.com/MicrosoftDocs/windows-topic-specific-samples/tree/winui-3/tutorials/winui-notes).
Copy file name to clipboardExpand all lines: hub/apps/winui/winui3/index.md
+13-27Lines changed: 13 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ WinUI combines the flexibility of the Win32 app model with the richness of moder
34
34
:::column span="2":::
35
35
**Modern UI**<br>
36
36
WinUI includes a comprehensive set of modern UI controls and styles, designed for usability, adaptability, and a polished, Fluent look and feel.
37
-
<br><br>
37
+
<br>
38
38
[Explore Fluent Design](../../design/index.md)
39
39
:::column-end:::
40
40
:::row-end:::
@@ -66,7 +66,7 @@ WinUI combines the flexibility of the Win32 app model with the richness of moder
66
66
:::column span="2":::
67
67
**Built on the Windows App SDK**<br>
68
68
WinUI is part of the Windows App SDK, giving you access to modern Windows APIs, consistent app behaviors, and tools that simplify development and deployment.
69
-
<br><br>
69
+
<br>
70
70
[Learn more about the Windows App SDK](../../windows-app-sdk/index.md)
71
71
:::column-end:::
72
72
:::row-end:::
@@ -89,32 +89,18 @@ To get started with WinUI, you can try out these resources to get you started:
89
89
90
90
:::row:::
91
91
:::column:::
92
-
**[Samples and resources](../../get-started/samples.md)**<br>
104
+
Browse code samples, starter projects, and tools to accelerate your development.
106
105
:::column-end:::
107
-
:::column span="2":::
108
-
**Explore the WinUI Gallery**<br>
109
-
The WinUI Gallery is an open-source app that showcases interactive examples of WinUI controls, features, and functionality. It includes code snippets and design guidance to help you get started quickly.
0 commit comments