---
title: ".NET MAUI SDK setup"
description: "Install and initialize Gleap in your application with the Gleap .NET MAUI SDK. Follow the integration code examples."
url: https://docs.gleap.ai/en/articles/640-net-maui-sdk-setup
collection: ".NET MAUI (Beta)"
updated: 2026-11-01
language: en
---

# .NET MAUI SDK setup

Install and initialize Gleap in your application with the Gleap .NET MAUI SDK. Follow the integration code examples.

The Gleap SDK for .NET MAUI is the easiest way to integrate Gleap into your cross-platform apps. Communicate with your users directly and build better software by discovering their everyday pain points. Gleap is your all-in-one customer feedback tool for apps and websites.

For the SDK to work, you need an API key, which you can get for free at [app.gleap.ai](https://app.gleap.ai).

#### Supported platforms

<table style="min-width: 100px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>✅ Android</p></th><th colspan="1" rowspan="1"><p>✅ iOS</p></th><th colspan="1" rowspan="1"><p>✅ MacCatalyst</p></th><th colspan="1" rowspan="1"><p>✅ Windows</p></th></tr></tbody></table>

> **Info:** **Beta.** The Gleap C# SDK is published as a pre-release (`0.1.0-beta.1`). Expect the odd change before the stable `1.0` release.

## 🏗 Installation

The MAUI binding ships as the `Gleap.Maui` package (it reuses the shared `Gleap.Core` engine). MAUI supplies persistence (`Preferences`) and device metadata (`DeviceInfo`); you supply the native WebView bridge for each platform.

### Requirements

-   The `maui` **workload** — install with `dotnet workload install maui`.
    
-   The platform SDKs for the targets you build (Android SDK / Xcode for iOS & MacCatalyst).
    

### Add the package

```bash
dotnet add package Gleap.Maui --prerelease
```

The `--prerelease` flag is required while the SDK is in beta. This pulls in the shared `Gleap.Core` engine automatically.

### Configure the SDK

Gleap renders the web widget in a native WebView. Provide a `GleapSDK.Bridge.IWebViewChannel` over your MAUI `WebView` (a `MauiWebViewChannel` is included), then attach Gleap and initialize the session:

```csharp
using GleapSDK;
using GleapSDK.Maui;

// `channel` bridges the platform WebView (see the platform notes below).
await GleapMaui.AttachAsync(channel, "YOUR_SDK_KEY");
Gleap.Open();
```

Once attached, drive Gleap from anywhere via the stable static facade (`Gleap.StartConversation()`, `Gleap.TrackEvent(...)`, …).

Congratulations 🎉 You are all set 👋

## Platform notes

-   The one piece you wire per platform is the **WebView bridge**: iOS/MacCatalyst post to `window.webkit.messageHandlers.gleapCallback`, Android exposes `GleapJSBridge.gleapCallback`, and Windows reuses the WebView2 channel. See the [SDK README](https://github.com/GleapSDK/CSharp-SDK/blob/main/maui/Gleap.Maui/README.md) for the exact wiring.
    
-   **Screenshots / replays** depend on the WebView host and are not captured natively on every target yet.
    
-   The `net10.0-windows` target only builds on Windows; the mobile targets require their platform SDKs.
    

> **Note:** [Data regions](https://gleap-developer-docs.gleap.help/en/articles/711-data-regions) are not supported by this SDK yet. It always connects to the EU region.

## 🤝 Need help?

We are here to help! [hello@gleap.ai](mailto:hello@gleap.ai)

## Related

- [.NET MAUI SDK: User identity](https://docs.gleap.ai/en/articles/641-net-maui-sdk-user-identity.md)
- [.NET MAUI SDK: Track events](https://docs.gleap.ai/en/articles/642-net-maui-sdk-track-events.md)
- [.NET MAUI SDK: Track pages](https://docs.gleap.ai/en/articles/643-net-maui-sdk-track-pages.md)
- [.NET MAUI SDK: Forms](https://docs.gleap.ai/en/articles/644-net-maui-sdk-forms.md)
- [.NET MAUI SDK: Frontend tools](https://docs.gleap.ai/en/articles/645-net-maui-sdk-frontend-tools.md)