Gleap.Core 0.1.0-beta.1

Gleap C# SDK

Cross-platform C# SDK for Gleap — customer support, in-app messenger, bug reporting, feature requests, surveys and more — for Unity, .NET MAUI, and Windows Desktop (WPF/WebView2).

Status: early access. The platform-agnostic core is implemented, unit-tested (129 tests, -warnaserror clean), and — the important part — validated live against the real Gleap server and web widget: the bridge handshake, config/session, messenger navigation, feedback submit (/bugs/v2), and the banner/modal outbound protocol were all confirmed against the live services. The host-side behaviour now mirrors the native iOS/Android SDKs (studied from their source), not just inference. Windows (WPF/WebView2) renders the live messenger natively; the MAUI and Unity bindings compile (their mobile/WebGL targets need the platform SDKs to build + run on a device). See Status & parity. Past "does it work", not yet a 1.0.

How it works

The real chat/messenger/help-center/survey UI is the same web widget used by all Gleap SDKs (messenger-app.gleap.io), hosted in a native WebView. This SDK follows the industry-standard pattern (Firebase/Sentry/AppsFlyer-style): a stable public Gleap facade over a small, platform-agnostic engine (Gleap.Core), with thin per-platform packages supplying the WebView host, persistence, metadata, and capture.

Gleap  (public facade — identical API everywhere)
  -> IGleapBackend
      -> ManagedBackend  (pure C# engine in Gleap.Core: session, config, the web-widget
                          bridge protocol, data collection, feedback, outbound polling, callbacks)
          -> IWebViewChannel / IHttpTransport / IKeyValueStore / IMetadataProvider / IScreenshotProvider
             (platform packages implement these seams)

Repository layout

src/Gleap.Core/              .NET Standard 2.0 engine - the reusable heart (unit-tested)
src/Gleap.WebView2/         Windows Desktop binding (WebView2) - net8.0-windows10.0.19041.0
examples/Gleap.Sample.Wpf/  WPF sample: a floating launcher + messenger overlay (GleapMessenger)
maui/Gleap.Maui/            .NET MAUI binding (reuses Gleap.Core) - net10.0-*
examples/Gleap.Sample.Maui/ MAUI sample app
unity/com.gleap.sdk/        Unity UPM package (reuses Gleap.Core; Core DLLs bundled)
tests/Gleap.Core.Tests/     xUnit tests for the core
docs/                       design specs + implementation plans (docs/superpowers)

Gleap.sln           Core + tests - builds cross-platform (macOS/Linux/Windows)
Gleap.Windows.sln   Core + WebView2 + WPF sample - Windows only

Build & test (core)

Requires the .NET 8 SDK (the repo also builds on the .NET 10 SDK). The WPF sample additionally needs the .NET 8 Desktop Runtime; the MAUI binding needs the maui workload (dotnet workload install maui).

dotnet test Gleap.sln                   # build + run the core tests (129)
dotnet build Gleap.sln -warnaserror     # quality gate (0 warnings)
dotnet format Gleap.sln --verify-no-changes

Gleap.Windows.sln (WebView2/WPF) builds on Windows only - see WINDOWS-RUNBOOK.md to run the sample app against the live widget. Unity and MAUI have their own READMEs (unity/com.gleap.sdk/README.md, maui/Gleap.Maui/README.md).

Quick start (Windows Desktop)

using GleapSDK;
using GleapSDK.WebView2;

// Drop the launcher control into your window: it floats a button (styled from your project config)
// that slides the messenger in as an overlay and back, like the web SDK. Session/config load lazily.
var messenger = new GleapMessenger { SdkKey = "YOUR_SDK_KEY" };
rootGrid.Children.Add(messenger);

// Drive it from anywhere via the stable facade:
Gleap.StartBot("");                     // or StartConversation / OpenHelpCenter / OpenNews / ShowSurvey
await Gleap.IdentifyContactAsync("user-123", new GleapSDK.Models.GleapUserProperty { Email = "a@b.c" });
Gleap.TrackEvent("checkout_completed");

(For full control you can instead host a WebView2 yourself and call GleapWebView2Host.AttachAsync(webView, "YOUR_SDK_KEY").)

Status & parity

Honest state (✅ = done + verified where noted; the host-side behaviour was checked against the native iOS/Android SDK source):

Design docs and per-feature implementation plans live under docs/superpowers/.

License

Copyright (C) 2026 Gleap GmbH. See LICENSE.md. Proprietary - use as-is; modifications and reselling require written permission from Gleap GmbH.