Skip to content

5. Getting Started

Alainna Carmon edited this page Oct 6, 2026 · 10 revisions

Getting Started

Before beginning the hands-on lab, make sure your computer has the required software and that the provided starter project can run successfully.

Requirements

You will need:

Windows 10 version 1809 or later, or Windows 11

Visual Studio 2022

.NET MAUI development tools

An internet connection

The provided Weather API starter project

Important: This training module uses Visual Studio 2022, not Visual Studio Code.

1. Install Visual Studio 2022

If Visual Studio 2022 is not already installed, download it from Microsoft's official website:

Download Visual Studio

The Community edition is sufficient for this training module.

2. Install the .NET MAUI Workload

When installing Visual Studio 2022, select the:

.NET Multi-platform App UI development

workload.

If Visual Studio is already installed:

Open Visual Studio Installer.

Find your Visual Studio 2022 installation.

Select Modify.

Select .NET Multi-platform App UI development.

Click Modify or Install.

Wait for the installation to finish.

The .NET MAUI workload provides the tools required to create and run .NET MAUI applications.

Microsoft — Install .NET MAUI

3. Download the Starter Project

Download or clone the project from here:

Download the starter project here

After downloading the project, extract the ZIP file if necessary.

You should see a Visual Studio solution file (.sln) inside the project folder.

4. Open the Project

Open the project in Visual Studio 2022.

You can either:

Double-click the .sln file, or Open Visual Studio 2022 and select Open a project or solution.

The project should appear in Solution Explorer.

Your project should contain files similar to:

image

5. Build the Project

Before making any changes, make sure the starter project builds successfully.

In Visual Studio:

Select Build from the top menu.

Select Build Solution.

Check the Output and Error List windows.

If the project builds successfully, you are ready to continue.

If errors appear, resolve them before continuing with the lab.

6. Run the Starter Project

Select an available target device from the Visual Studio toolbar.

Then select the Run button or press:

F5

The application should start.

The starter project will contain a basic page or placeholder interface. Styling has been included.

image

You will modify the application during the hands-on portion of the training.

7. Confirm Your Setup

Before continuing to the lab, verify the following:

Visual Studio 2022 is installed.

The .NET MAUI workload is installed.

The starter project opens successfully.

The solution builds without errors.

The application runs successfully.

Your computer has an internet connection.

If all of these items are complete, you are ready to begin the Tutorial/Lab.

Helpful Resources


Visual Studio 2022 Downloads

Microsoft — .NET MAUI Documentation

Microsoft — Install .NET MAUI

Clone this wiki locally