Main Page: Difference between revisions

From Wiki Maui Linux NET
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
= WIKI MAUI Linux .NET =
= Maui Linux .NET =


Welcome to the **MAUI Linux .NET Wiki** — a community-driven effort to make [.NET MAUI](https://github.com/dotnet/maui) fully functional on Linux platforms.
Welcome to **Maui Linux .NET** — a community-maintained **fork of Microsoft’s .NET MAUI** to add **Linux support via GtkSharp** (GTK).
This project builds on prior community efforts (see the original **maui-linux** fork) and aims to deliver a usable developer experience on Linux.


Our goal is to provide developers with a modern, native .NET UI framework that runs seamlessly on **GNOME**, **KDE**, and other Linux environments.
''Note:''
* This is **not** an official Microsoft platform.
* It is a **fork** focused on Linux, using **GtkSharp** (GTK) bindings rather than a Skia-only approach.
* See: original fork and discussions for Linux + GTK backend. [Sources]


----
----
Line 11: Line 15:
! Date !! Event !! Notes
! Date !! Event !! Notes
|-
|-
| August 2021 || .NET MAUI Preview 7 || Early preview of MAUI (cross-platform successor to Xamarin.Forms)
| March 2021 || Community discussion on Linux/GTK for MAUI || Early planning around **GtkSharp** backend. [1]
|-
|-
| May 2022 || .NET MAUI 6.0 (RTM) || First stable release for Windows, macOS, Android, iOS
| May 23, 2022 || **.NET MAUI 6.0 GA** || First stable MAUI (Android, iOS, macOS, Windows). [2][3]
|-
|-
| November 2022 || .NET MAUI 7.0 || Performance improvements, XAML updates, bug fixes
| Nov 8, 2022 || **.NET MAUI 7.0** || Ships with .NET 7. [4]
|-
|-
| November 2023 || .NET MAUI 8.0 || LTS release; better tooling and SDK integration
| Nov 14, 2023 || **.NET MAUI 8.0 (LTS)** || Major quality & tooling updates. [5]
|-
|-
| March 2024 || MAUI-Linux project begins || Independent community effort to enable MAUI on Linux (based on MAUI.GTK)
| Nov 12, 2024 || **.NET MAUI 9.0 (GA)** || Performance & control updates. [6][7]
|-
|-
| April–October 2024 || Initial experiments and builds || Early GTK-based prototype; several contributors joined, but progress slowed
| 2021–2022 || **maui-linux** fork takes shape || Community fork from dotnet/maui to add Linux/GTK. [8][9]
|-
|-
| October 2025 || Project revival and reorganization || New maintainers take over with focus on build stability, documentation, and developer experience
| Oct 2025 || **Maui Linux .NET** (this fork) || Project reboot with focus on docs, builds, and contributor onboarding.
|}
|}
''Sources:'' 
[1] Linux + GTK discussion (2021) – GtkSharp options. 
[2] .NET MAUI GA news (May 2022). 
[3] Microsoft support policy page (dates). 
[4] Support policy lists MAUI 7 (Nov 2022). 
[5] “Announcing .NET MAUI in .NET 8” (Nov 2023). 
[6] “Announcing .NET 9” (MAUI 9 highlights). 
[7] What’s new in .NET MAUI 9 (docs). 
[8] **maui-linux** repo (forked from dotnet/maui). 
[9] HN/Community notes: fork uses **GtkSharp**.


----
----


== 🚧 Project Status ==
== 🚧 Project Status ==
The **MAUI-Linux** project aims to provide Linux support for MAUI apps through a GTKSharp backend.
**Goal:** make MAUI apps run on Linux via **GtkSharp** (GTK backend), with Wayland/X11 support and sane packaging.


However, the project currently faces significant challenges:
**Current challenges (why this fork exists):**
* ⚙️ **Lack of up-to-date documentation** – many components are undocumented or outdated.
* **Documentation gaps** – outdated or missing; hard to reproduce a working environment.
* 🧩 **Compilation difficulties** – even experienced developers struggle to build the current codebase.
* **Stalled upstream activity** – months without meaningful updates in the original fork; open issues linger. [10]
* 💤 **Stalled development** – the repository has seen no major commits for months.
* **Hard to compile** – repeated reports of build failures scare contributors away. [11]
* 👥 **No active community** – due to missing guidance and setup instructions, new contributors often give up early.
* **Thin community** – without docs and green builds, it’s tough to grow contributors.


The result: a promising idea without an active ecosystem. 
**Our focus:** fix the build (scripts/CI), write clear docs, and provide small, verifiable steps to success.
Our mission is to change that — by cleaning up, documenting, and rebuilding the project so others can join in easily.


----
----


== 💪 How You Can Help ==
== 💪 Contribute ==
The **MAUI Linux revival** depends on contributors from all areas:
We welcome:
* **Developers:** GTK handlers, windowing, input, WebView (WebKitGTK), packaging (Flatpak/Deb). 
* **Doc writers:** Getting Started, Troubleshooting, Architecture notes. 
* **Testers:** Ubuntu/Fedora/Arch; Wayland & X11; HiDPI.


* **Developers** – improve the build system, fix runtime issues, modernize dependencies.
Start here: [[How_to_Start|How to Start]] · [[Contributing|Contributing Guide]] · [[Roadmap|Roadmap]]
* **Documentation writers** – write “Getting Started” and troubleshooting pages.
* **Testers** – verify builds across Ubuntu, Fedora, Arch, and Wayland/X11.
* **Designers** – improve theming and native integration.
 
See the [[How_to_Start|How to Start]] page to get your environment ready and join the development.


----
----


== 🧭 Getting Started ==
== 🧭 How to Start ==
If you want to build or test MAUI on Linux:
* Follow [[How_to_Start|How to Start]] for prerequisites and the `bootstrap.sh`.   
 
* Try the sample: `dotnet build` / `dotnet run`.   
* Follow our [[How_to_Start|How to Start]] guide.   
* If it fails, see [[Troubleshooting]] and open an Issue with logs.
* Join the discussion on GitHub or Matrix/Discord.   
* File issues and document what works (and what doesn’t). 
 
Every small improvement helps the entire ecosystem.


----
----


== 🔗 External Links ==
== 🔗 External Links ==
* [https://github.com/jsuarezruiz/maui-linux Original MAUI-Linux repository (GitHub)]   
* Original fork: [https://github.com/jsuarezruiz/maui-linux maui-linux (GitHub)]   
* [https://github.com/jsuarezruiz/maui-gtk MAUI.GTK backend (GitHub)]   
* GTK backend community: [https://github.com/MauiGtk MauiGtk Community (GitHub)]   
* [https://github.com/dotnet/maui Official .NET MAUI project] 
* Official MAUI: [https://github.com/dotnet/maui dotnet/maui (GitHub)]
* [https://github.com/maui-linux Organization: MAUI Linux (Community Reboot)]


----
----


== 🌍 About This Wiki ==
== ℹ️ About this Wiki ==
This wiki is part of the **community effort** to document and rebuild MAUI-Linux from the ground up.
This wiki documents the **Maui Linux .NET** fork for Linux/GTK. It’s maintained by volunteers.
All information here is collected, tested, and maintained by volunteers.
Please improve this page, or contribute via PRs once repo ↔ wiki sync is enabled.
 
If you’d like to improve this page, please edit it — or contribute via GitHub pull requests once integration is enabled.


----
----
''Last updated: October 2025'' 
''Last updated: October 2025''
''Maintained by the MAUI-Linux community''

Revision as of 14:05, 5 October 2025

Maui Linux .NET

Welcome to **Maui Linux .NET** — a community-maintained **fork of Microsoft’s .NET MAUI** to add **Linux support via GtkSharp** (GTK). This project builds on prior community efforts (see the original **maui-linux** fork) and aims to deliver a usable developer experience on Linux.

Note:

  • This is **not** an official Microsoft platform.
  • It is a **fork** focused on Linux, using **GtkSharp** (GTK) bindings rather than a Skia-only approach.
  • See: original fork and discussions for Linux + GTK backend. [Sources]

📅 Timeline

Date Event Notes
March 2021 Community discussion on Linux/GTK for MAUI Early planning around **GtkSharp** backend. [1]
May 23, 2022 **.NET MAUI 6.0 GA** First stable MAUI (Android, iOS, macOS, Windows). [2][3]
Nov 8, 2022 **.NET MAUI 7.0** Ships with .NET 7. [4]
Nov 14, 2023 **.NET MAUI 8.0 (LTS)** Major quality & tooling updates. [5]
Nov 12, 2024 **.NET MAUI 9.0 (GA)** Performance & control updates. [6][7]
2021–2022 **maui-linux** fork takes shape Community fork from dotnet/maui to add Linux/GTK. [8][9]
Oct 2025 **Maui Linux .NET** (this fork) Project reboot with focus on docs, builds, and contributor onboarding.

Sources: [1] Linux + GTK discussion (2021) – GtkSharp options. [2] .NET MAUI GA news (May 2022). [3] Microsoft support policy page (dates). [4] Support policy lists MAUI 7 (Nov 2022). [5] “Announcing .NET MAUI in .NET 8” (Nov 2023). [6] “Announcing .NET 9” (MAUI 9 highlights). [7] What’s new in .NET MAUI 9 (docs). [8] **maui-linux** repo (forked from dotnet/maui). [9] HN/Community notes: fork uses **GtkSharp**.


🚧 Project Status

    • Goal:** make MAUI apps run on Linux via **GtkSharp** (GTK backend), with Wayland/X11 support and sane packaging.
    • Current challenges (why this fork exists):**
  • **Documentation gaps** – outdated or missing; hard to reproduce a working environment.
  • **Stalled upstream activity** – months without meaningful updates in the original fork; open issues linger. [10]
  • **Hard to compile** – repeated reports of build failures scare contributors away. [11]
  • **Thin community** – without docs and green builds, it’s tough to grow contributors.
    • Our focus:** fix the build (scripts/CI), write clear docs, and provide small, verifiable steps to success.

💪 Contribute

We welcome:

  • **Developers:** GTK handlers, windowing, input, WebView (WebKitGTK), packaging (Flatpak/Deb).
  • **Doc writers:** Getting Started, Troubleshooting, Architecture notes.
  • **Testers:** Ubuntu/Fedora/Arch; Wayland & X11; HiDPI.

Start here: How to Start · Contributing Guide · Roadmap


🧭 How to Start

  • Follow How to Start for prerequisites and the `bootstrap.sh`.
  • Try the sample: `dotnet build` / `dotnet run`.
  • If it fails, see Troubleshooting and open an Issue with logs.


ℹ️ About this Wiki

This wiki documents the **Maui Linux .NET** fork for Linux/GTK. It’s maintained by volunteers. Please improve this page, or contribute via PRs once repo ↔ wiki sync is enabled.


Last updated: October 2025