Maude is a plugin for .NET MAUI plugin to monitor and visualise app performance at runtime.
| Shake to open Maude | Memory chart overlay | Slide-in events sheet |
Best effort has been made for performance and correctness, but Maude continuously snapshots memory and stores recent samples in-memory; expect a small observer effect.
Please treat Maude’s numbers as a guidance, a heuristic.
Always use the native tools and platform specific profilers (Xcode Instruments, Android Studio profiler) or dotnet trace for authoritative measurements.
Add Maude to your MAUI app with minimal code.
- Configure the app builder:
// MauiProgram.cs
using Maude;
var builder = MauiApp.CreateBuilder()
.UseMauiApp<App>()
.UseMaude(); - Start tracking memory usage:
MaudeRuntime.Activate();- Show Maude:
// Show Maude as a slide in sheet.
MaudeRuntime.PresentSheet();
MaudeRuntime.DismissSheet();
// Show Maude as a window overlay.
MaudeRuntime.PresentOverlay();
MaudeRuntime.DismissOverlay();If you would prefer a one-liner, add the following to your MAUI app builder:
// MauiProgram.cs
using Maude;
var builder = MauiApp.CreateBuilder()
.UseMauiApp<App>()
.UseMaudeAndActivate(); // Register Maude and immediately start tracking.Looking for integration steps, builder options, and runtime usage guidance beyond the quickstart?
See docs.md for the full walkthrough, including event recording, customisation options, platform-specific initialisation, and FPS sampling tips.
| Metric | Description + Documentation |
|---|---|
| Resident Set Size (RSS) | Physical RAM currently mapped into the process (Java + native + runtime), excluding swapped pages. Android Memory Overview • /proc reference |
| Native Heap | Memory allocated through native allocators (malloc, new) used by the ART runtime and native libraries. Debug.getNativeHeapAllocatedSize |
| CLR (Managed Heap) | Managed heap consumed by the .NET/Mono runtime (GC generations, LOH, objects, metadata). .NET GC Fundamentals |
| Metric | Description + Documentation |
|---|---|
| Physical Footprint (Jetsam Footprint) | Total physical RAM attributed to the process by the kernel — the metric Jetsam uses to terminate apps. task_vm_info_data_t • WWDC Memory Deep Dive |
| CLR (Managed Heap) | Managed memory used by the .NET/Mono runtime on iOS (AOT GC heap + metadata). .NET GC Fundamentals |
MAUI’s WindowOverlay attaches to the root window, so modal pages can obscure the overlay. Use the slide-in sheet (PresentSheet) for modal-heavy flows.
On Android, the overlay is a transparent FrameLayout added to the current activity’s decor view; it stays on top of your main content but under system UI and will not be visible on modal pages.
On iOS, a non-interactive UIView is injected into every active UIWindow (per scene); the overlay follows window bounds but will sit behind any OS-owned alerts or modal views.
Maude is explicitly built for .NET 9+ to leverage Span<T> optimisations, which enables some performance oriented code in the chart rendering, and MAUI native embedding, which enables Maude's UIs to be built in MAUI but rendered inside native views.
As such, target frameworks earlier than .NET 9 are unsupported.
Minimal External Dependencies
Maude must not add undue dependencies to the integrating application.
As much as possible, Maude must use the core MAUI and platform APIs. Maudes only current external dependency is SkiaSharp.
Minimal Overhead
Maude should not impact the performance of the integrating application.
Maude should capture and present telemetry in the most efficient method possible and ensure it adds minimal memory overhead.
Simple Integration
Maude must be simple for the integrating application to add and use.
Currently, Maude can be added to an applicaton in one line .UseMaudeAndActivate().