This is a mobile app project template using Uno Platform and the latest .NET practices.
- It uses the MVVM pattern.
- Code is organized by application layer.
- It comes with dependency injection.
- There are built-in logs and diagnostic tools.
- There is scaffolding code showing sample features. When you run as-is, you get a Dad Jokes application.
From left to right: WinUI, iOS, and Android.
Note that scaling was adjusted to better fit this preview and therefore this image isn't representative of the actual device sizes.
Visual Studio 2022 with .Net 7 are required.
This template largely relies on Uno Platform, if you want to make sure you got everything installed correctly on your machine, we encourage you to use uno-check
, the documentation is available here
💡 It's also possible to use this template for a pure WinUI application, without any mobile aspect. All you would have to do is remove the
.Mobile
csproj from the generated solution.
We use dotnet
project templates to easily create new projects. It simplifies the project renaming and supports conditional inclusions.
-
Install the template using this command.
dotnet new install NV.Templates.Mobile
-
To run the template and create a new project, run the following command in the folder that will contain the new project.
dotnet new nv-mobile -n MyProjectName
⚠ The use of periods (
.
) in the project name is not supported and may result in compilation issues later on.💡 If all your projects are regrouped in a folder like
C:\Repos
, you want to be in that folder. The command would generate all the project files underC:\Repos\MyProjectName
.The following options are available when running the command.
- To get help:
dotnet new nv-mobile -h
- To get help:
-
Open the
README.md
and complete the documentation TODOs. -
Open the solution file from the generated folder using Visual Studio.
It's located at
MyProjectName/src/MyProjectName.sln
. -
In Visual Studio, go to the VIEW menu and open the Task List to get hints on next steps.
This template comes with several pointers on what you're most likely to change next.
This repository provides documentation on different topics under the doc folder.
The software architecture of the application is documented in the Architecture document.
Here's how to install the template directly from the code, in the case that you want to modify it and would like to test your changes.
-
Uninstall the template from nuget.org (if applicable).
dotnet new uninstall NV.Templates.Mobile
-
Clone this repository on your machine.
-
Open a command prompt at the root of the cloned repository.
-
Run the following command.
dotnet new install ./
Read this for more information on custom templates.
-
Open a command prompt at the root of the cloned repository.
-
Run the following command.
dotnet new uninstall ./
Please consult the CHANGELOG for more information about the version history.
This project is licensed under the Apache 2.0 license. See the LICENSE for details.
Please read CONTRIBUTING for details on the process for contributing to this project.
Be mindful of our Code of Conduct.