This project contains a sample application written in C# with cross-platform graphical user interface (GUI) based on MAUI.NET and Cloud-based REST API based on ASP.NET Core
MIT License
This project contains a sample application based on the awesome Microsoft MAUI.NET and ASP.NET frameworks.
We use this sample project at the School of Engineering of the University of Applied Sciences Upper Austria in Wels, Austria for teaching courses in Mobile and Cloud Computing to our engineering and management students. Since we mainly use C# as a language and DotNet as a framework in our programming courses in the earlier semester, we decided to use the MAUI.NET and ASP.NET frameworks in this course. The MAUI.NET and ASP.NET frameworks provide the following capabilities:
The following diagram explains the package structure of the sample application:
Each package in this structure serves a different purpose:
CustomLib
package provides common classes and interfaces to the other packages and, hence, forms a contract between them.CustomApi
package provides a HTTP REST API server implementation with in-memory data store based on the Microsoft ASP.NET framework.CustomSdk
package provides a HTTP REST API client implementation for the two frontend applications as well as third party software.CustomCli
package provides a Command Line Interfaces (CLI) for sending requests to the HTTP REST API and printing responses.CustomApp
package provides a Graphical User Interface (GUI) based on the cross-platform Microsoft MAUI.NET framework.Note that we have used similar package structures for production-grade applications in the past. Hence, this package structure also represents a best practice recommendation that you are free to reuse at your own risk!
If you want to know more about this, we suggest diving into the code! 👩💻😉
The following set of guides helps you getting started with MAUI.NET and ASP.NET development on your local machine. Note that the guides have been prepared for Windows machines only. In principle, MAUI.NET and ASP.NET development should be possible also on OS X and Linux machines. However, we did not test that!
In the following, we provide screenshots of the sample application to give a first impression of its functionality. The following screenshots are included:
The MAUI.NET Users Page provides a list of existing users, allows you to reload the list of existing users, and provides means for editing existing users or creating new users. The users are retrieved from the backend service.
The MAUI.NET User Page provides means for editing the information of existing users or entering the information of new users and sending the information to the Cloud-based backend services for long-term storage.
The MAUI.NET Issues Page provides a list of existing issues, allows you to reload the list of existing issues, and provides means for editing existing issues or creating new issues. The issues are retrieved from the backend service.
The MAUI.NET Issue Page provides means for editing the information of existing issues or entering the information of new issues and sending the information to the Cloud-based backend services for long-term storage.
The ASP.NET Swagger UI provides a documentation of the Cloud-based backend services, which are exposed via HTTP REST API. For each endpoint, the expected inputs and provided outputs are shown including examples.
As for every open source project, we provide three standard documents: The license agreement for using the source code, rules for contributing to the source code of the project, and a change log summarizing relevant changes to the source code: