Main Page
Maui Linux .NET
Welcome to **Maui Linux .NET** — a community reboot of the original **maui-linux** project. This project is a **fork of the community initiative “maui-linux”**, which attempted to bring **.NET MAUI** to Linux systems using **GtkSharp** (GTK).
The goal of Maui Linux .NET is to pick up where development stalled — rebuilding, documenting and maintaining a working Linux backend for MAUI applications.
Note: This project is not affiliated with Microsoft or the official .NET MAUI team.
📅 Timeline
| Date | Event | Notes |
|---|---|---|
| March 2021 | Early discussions on Linux backend for .NET MAUI | Community experiments using GtkSharp begin. |
| August 2021 | First commits to **maui-linux** repository | The project starts under the GitHub account of jsuarezruiz. |
| May 2022 | .NET MAUI 6.0 released | The original maui-linux fork updates its base. |
| Late 2022 – 2023 | Slow progress | Builds become unreliable; missing documentation limits contributors. |
| Early 2024 | Development stagnates | Few or no commits for months; open issues remain unanswered. |
| October 2025 | **Maui Linux .NET** fork created | New maintainers restart the project with focus on documentation, reproducible builds, and contributor onboarding. |
🚧 Project Status
Maui Linux .NET aims to make **.NET MAUI applications run natively on Linux desktops** through a **GtkSharp** backend.
However, the original *maui-linux* project suffered from several core problems:
- 📚 **Lack of documentation** – build steps and dependencies were unclear or outdated.
- 🧩 **Build failures** – even experienced developers struggled to compile a working binary.
- 💤 **No recent updates** – the last meaningful commits date back many months.
- 👥 **No community traction** – without guidance or working examples, contributors lost interest quickly.
- Maui Linux .NET** exists to change that — by re-organizing the codebase, documenting every step, and providing working templates for future contributors.
💪 Contribute
We’re rebuilding the project as a transparent, open collaboration. If you want to help, you can:
- **Fix and refactor** the GtkSharp backend.
- **Improve documentation** (build steps, dependencies, packaging).
- **Test** on multiple distributions (Ubuntu, Fedora, Arch, openSUSE).
- **Add automation** (CI pipelines, build scripts, sample apps).
Start here: How to Start If you encounter problems: Troubleshooting Guide
🧭 How to Start
- Install .NET 8 or newer and required GTK dependencies.
- Clone the repo and run the bootstrap script.
- Try to build the sample project with `dotnet build` or `dotnet run`.
- Report issues with logs and environment details.
Detailed instructions: How_to_Start
🔗 External Links
- Original repository: maui-linux (GitHub)