Get Started

Install the templates

To install the templates for Fabulous for .NET MAUI, run the following command:

dotnet new install Fabulous.MauiControls.Templates

You can check the installed templates on your machine by running the command:

dotnet new list

You should see the installed Fabulous for .NET MAUI templates:

Template Name           Short Name             Language  Tags                       
----------------------  ---------------------  --------  ---------------------------
Fabulous Maui.Controls  fabulous-mauicontrols  F#        Fabulous/Maui/Maui.Controls

Create a project

To get started, we are going to use the simplest Fabulous for .NET MAUI template: Fabulous Maui.Controls (or fabulous-mauicontrols in the CLI).

Run the command:

dotnet new fabulous-mauicontrols -n GetStartedApp

This will create a new folder called GetStartedApp containing the new project.

In this folder, you'll find a project named GetStartedApp. This project uses the single project format to target several platforms from a single codebase.

See the official .NET MAUI documentation for more information about the supported platforms.

Run a project

We are now ready to run the project!

Go into the GetStartedApp directory and run:

# run the Android app
dotnet build -f net10.0-android -t:Run

# run the iOS app
dotnet build -f net10.0-ios -t:Run

# for other platforms, use the corresponding TFM (net10.0-xxx)

You can also open the solution GetStartedApp.sln with your favorite IDE and select the platform you want.

For detailed instructions on running and debugging Fabulous .NET MAUI applications from the CLI and Visual Studio, see Tutorials. If you are following the examples using the generated GetStartedApp project, replace Counter with GetStartedApp in all commands.