From e7476f7c87687c94e4629716eb10dd8b53931d9c Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 08:57:57 +0200
Subject: [PATCH 01/21] chore(*): maui sdk

---
 .github/workflows/publish-maui.yml            |  34 ++
 CONTRIBUTING.md                               |   5 +-
 README.md                                     |   2 +
 commitlint.config.js                          |   4 +-
 examples/example-maui/App.xaml                |  10 +
 examples/example-maui/App.xaml.cs             |  10 +
 examples/example-maui/MainPage.xaml           |  23 ++
 examples/example-maui/MainPage.xaml.cs        | 115 ++++++
 examples/example-maui/MauiProgram.cs          |  33 ++
 examples/example-maui/README.md               |  15 +
 examples/example-maui/example-maui.csproj     |  16 +
 packages/sdk-maui/CHANGELOG.md                |   5 +
 packages/sdk-maui/Platforms/Android/.gitkeep  |   0
 .../Platforms/Android/HooksAndroid.cs         |  63 ++++
 .../Platforms/Android/Screeb.Android.cs       | 330 ++++++++++++++++++
 packages/sdk-maui/Platforms/iOS/.gitkeep      |   0
 .../sdk-maui/Platforms/iOS/ApiDefinitions.cs  | 121 +++++++
 packages/sdk-maui/Platforms/iOS/HooksIOS.cs   |  28 ++
 packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs | 324 +++++++++++++++++
 .../sdk-maui/Platforms/iOS/StructsAndEnums.cs |   3 +
 packages/sdk-maui/README.md                   |  33 ++
 packages/sdk-maui/Screeb.cs                   | 150 ++++++++
 packages/sdk-maui/ScreebHooks.cs              |  50 +++
 packages/sdk-maui/ScreebInitOptions.cs        |   7 +
 packages/sdk-maui/ScreebMaui.csproj           |  49 +++
 packages/sdk-maui/ScreebUtils.cs              |  35 ++
 packages/sdk-maui/native/ios/.gitkeep         |   0
 packages/sdk-maui/tests/ScreebUtilsTests.cs   |  63 ++++
 .../sdk-maui/tests/ScreebUtilsTests.csproj    |  18 +
 29 files changed, 1544 insertions(+), 2 deletions(-)
 create mode 100644 .github/workflows/publish-maui.yml
 create mode 100644 examples/example-maui/App.xaml
 create mode 100644 examples/example-maui/App.xaml.cs
 create mode 100644 examples/example-maui/MainPage.xaml
 create mode 100644 examples/example-maui/MainPage.xaml.cs
 create mode 100644 examples/example-maui/MauiProgram.cs
 create mode 100644 examples/example-maui/README.md
 create mode 100644 examples/example-maui/example-maui.csproj
 create mode 100644 packages/sdk-maui/CHANGELOG.md
 create mode 100644 packages/sdk-maui/Platforms/Android/.gitkeep
 create mode 100644 packages/sdk-maui/Platforms/Android/HooksAndroid.cs
 create mode 100644 packages/sdk-maui/Platforms/Android/Screeb.Android.cs
 create mode 100644 packages/sdk-maui/Platforms/iOS/.gitkeep
 create mode 100644 packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
 create mode 100644 packages/sdk-maui/Platforms/iOS/HooksIOS.cs
 create mode 100644 packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
 create mode 100644 packages/sdk-maui/Platforms/iOS/StructsAndEnums.cs
 create mode 100644 packages/sdk-maui/README.md
 create mode 100644 packages/sdk-maui/Screeb.cs
 create mode 100644 packages/sdk-maui/ScreebHooks.cs
 create mode 100644 packages/sdk-maui/ScreebInitOptions.cs
 create mode 100644 packages/sdk-maui/ScreebMaui.csproj
 create mode 100644 packages/sdk-maui/ScreebUtils.cs
 create mode 100644 packages/sdk-maui/native/ios/.gitkeep
 create mode 100644 packages/sdk-maui/tests/ScreebUtilsTests.cs
 create mode 100644 packages/sdk-maui/tests/ScreebUtilsTests.csproj

diff --git a/.github/workflows/publish-maui.yml b/.github/workflows/publish-maui.yml
new file mode 100644
index 0000000..6ff2bbf
--- /dev/null
+++ b/.github/workflows/publish-maui.yml
@@ -0,0 +1,34 @@
+name: Publish Screeb.Maui
+
+on:
+  push:
+    tags:
+      - 'sdk-maui/v*'
+
+jobs:
+  publish:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Install MAUI workloads
+        run: dotnet workload install android ios
+
+      - name: Restore
+        run: dotnet restore packages/sdk-maui/ScreebMaui.csproj
+
+      - name: Build Android
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-android -c Release --no-restore
+
+      - name: Build iOS
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-ios -c Release --no-restore
+
+      - name: Pack
+        run: dotnet pack packages/sdk-maui/ScreebMaui.csproj -c Release --no-build -o ./nupkg
+
+      - name: Push to NuGet
+        run: dotnet nuget push ./nupkg/*.nupkg --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json --skip-duplicate
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 9ea4ab3..26dc38f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -52,5 +52,8 @@ npx lerna version --scope=@screeb/sdk-browser
 
 # Flutter
 # 1. Bump version in packages/sdk-flutter/pubspec.yaml
-# 2. git tag sdk-flutter/vX.Y.Z && git push --tags
+git tag sdk-flutter/vX.Y.Z && git push --tags
+
+# MAUI (NuGet)
+git tag sdk-maui/v0.1.0 && git push --tags
 ```
diff --git a/README.md b/README.md
index 57f39a1..0b3c64d 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,7 @@ Public SDKs for [Screeb](https://screeb.app) — the Product Discovery platform.
 | Vue | [`@screeb/sdk-vue`](packages/sdk-vue) | [npm](https://www.npmjs.com/package/@screeb/sdk-vue) | [Install](https://developers.screeb.app/sdk-vue/install) |
 | Ionic | Uses `@screeb/sdk-angular` / `@screeb/sdk-react` / `@screeb/sdk-browser` | — | [Install](https://developers.screeb.app/sdk-js/sdk-ionic) |
 | React Native | [`@screeb/react-native`](packages/sdk-reactnative) | [npm](https://www.npmjs.com/package/@screeb/react-native) | [Install](https://developers.screeb.app/sdk-react-native/install) |
+| .NET MAUI | [`Screeb.Maui`](packages/sdk-maui) | [NuGet](https://www.nuget.org/packages/Screeb.Maui) | [Install](https://developers.screeb.app/sdk-maui/install) |
 | Flutter | [`plugin_screeb`](packages/sdk-flutter) | [pub.dev](https://pub.dev/packages/plugin_screeb) | [Install](https://developers.screeb.app/sdk-flutter/install) |
 | iOS | Closed source ([`sdk-ios-public`](https://github.com/ScreebApp/sdk-ios-public) — SPM mirror) | [SPM](https://github.com/ScreebApp/sdk-ios-public) | [Install](https://developers.screeb.app/sdk-ios/install) |
 | Android | Closed source | [Maven](https://central.sonatype.com/artifact/app.screeb.sdk/survey) | [Install](https://developers.screeb.app/sdk-android/install) |
@@ -29,6 +30,7 @@ Public SDKs for [Screeb](https://screeb.app) — the Product Discovery platform.
 | Ionic | Angular 16 + Capacitor | [`examples/example-ionic`](examples/example-ionic) |
 | Expo | React Native + Expo | [`examples/example-expo`](examples/example-expo) |
 | React Native | React Native CLI | [`examples/example-reactnative`](examples/example-reactnative) |
+| .NET MAUI | .NET MAUI | [`examples/example-maui`](examples/example-maui) |
 | Flutter | Flutter | [`examples/example-flutter`](examples/example-flutter) |
 | Android | Android (Kotlin) | [`examples/example-android`](examples/example-android) |
 | iOS | iOS (Swift) | [`examples/example-ios`](examples/example-ios) |
diff --git a/commitlint.config.js b/commitlint.config.js
index 3742de1..464f831 100644
--- a/commitlint.config.js
+++ b/commitlint.config.js
@@ -13,7 +13,9 @@ module.exports = {
             "sdk-angular",
             "example-angular",
             "sdk-vue",
-            "example-vue"
+            "example-vue",
+            "sdk-maui",
+            "example-maui"
         ]],
         "scope-empty": [2, "never"],
         "scope-min-length": [2, "always", 1],
diff --git a/examples/example-maui/App.xaml b/examples/example-maui/App.xaml
new file mode 100644
index 0000000..54475ab
--- /dev/null
+++ b/examples/example-maui/App.xaml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             x:Class="ExampleMaui.App">
+    <Application.Resources>
+        <ResourceDictionary>
+            <Color x:Key="ScreebPurple">#6200EE</Color>
+        </ResourceDictionary>
+    </Application.Resources>
+</Application>
diff --git a/examples/example-maui/App.xaml.cs b/examples/example-maui/App.xaml.cs
new file mode 100644
index 0000000..2316923
--- /dev/null
+++ b/examples/example-maui/App.xaml.cs
@@ -0,0 +1,10 @@
+namespace ExampleMaui;
+
+public partial class App : Application
+{
+    public App()
+    {
+        InitializeComponent();
+        MainPage = new NavigationPage(new MainPage());
+    }
+}
diff --git a/examples/example-maui/MainPage.xaml b/examples/example-maui/MainPage.xaml
new file mode 100644
index 0000000..7a1dd9b
--- /dev/null
+++ b/examples/example-maui/MainPage.xaml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             x:Class="ExampleMaui.MainPage"
+             Title="Screeb MAUI Example">
+    <ScrollView>
+        <VerticalStackLayout Padding="20" Spacing="10">
+            <Label Text="Screeb .NET MAUI SDK" FontSize="24" FontAttributes="Bold" HorizontalOptions="Center" />
+            <Label Text="SDK initialized on startup (see MauiProgram.cs)" HorizontalOptions="Center" />
+
+            <Button Text="Track Event" Clicked="OnTrackEventClicked" BackgroundColor="#6200EE" TextColor="White" />
+            <Button Text="Track Screen" Clicked="OnTrackScreenClicked" BackgroundColor="#6200EE" TextColor="White" />
+            <Button Text="Set Identity" Clicked="OnSetIdentityClicked" BackgroundColor="#6200EE" TextColor="White" />
+            <Button Text="Reset Identity" Clicked="OnResetIdentityClicked" BackgroundColor="#9E9E9E" TextColor="White" />
+            <Button Text="Get Identity" Clicked="OnGetIdentityClicked" BackgroundColor="#6200EE" TextColor="White" />
+            <Button Text="Assign Group" Clicked="OnAssignGroupClicked" BackgroundColor="#6200EE" TextColor="White" />
+            <Button Text="Start Survey" Clicked="OnStartSurveyClicked" BackgroundColor="#03DAC5" TextColor="Black" />
+            <Button Text="Start Message" Clicked="OnStartMessageClicked" BackgroundColor="#03DAC5" TextColor="Black" />
+
+            <Label x:Name="StatusLabel" Text="Ready" HorizontalOptions="Center" />
+        </VerticalStackLayout>
+    </ScrollView>
+</ContentPage>
diff --git a/examples/example-maui/MainPage.xaml.cs b/examples/example-maui/MainPage.xaml.cs
new file mode 100644
index 0000000..6cc4936
--- /dev/null
+++ b/examples/example-maui/MainPage.xaml.cs
@@ -0,0 +1,115 @@
+using Screeb.Maui;
+
+namespace ExampleMaui;
+
+public partial class MainPage : ContentPage
+{
+    public MainPage()
+    {
+        InitializeComponent();
+    }
+
+    private async void OnTrackEventClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            await Screeb.TrackEvent("button_clicked", new Dictionary<string, object> { ["button"] = "track_event" });
+            StatusLabel.Text = "Event tracked ✓";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+
+    private async void OnTrackScreenClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            await Screeb.TrackScreen("MainPage");
+            StatusLabel.Text = "Screen tracked ✓";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+
+    private async void OnSetIdentityClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            await Screeb.SetIdentity("maui-user-123", new Dictionary<string, object> { ["plan"] = "premium" });
+            StatusLabel.Text = "Identity set ✓";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+
+    private async void OnResetIdentityClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            await Screeb.ResetIdentity();
+            StatusLabel.Text = "Identity reset ✓";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+
+    private async void OnGetIdentityClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            var identity = await Screeb.GetIdentity();
+            StatusLabel.Text = $"Identity: {identity?.Count ?? 0} props";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+
+    private async void OnAssignGroupClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            await Screeb.AssignGroup("company", "Screeb", new Dictionary<string, object> { ["plan"] = "enterprise" });
+            StatusLabel.Text = "Group assigned ✓";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+
+    private async void OnStartSurveyClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            await Screeb.StartSurvey("<YOUR_SURVEY_ID>");
+            StatusLabel.Text = "Survey started ✓";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+
+    private async void OnStartMessageClicked(object sender, EventArgs e)
+    {
+        try
+        {
+            await Screeb.StartMessage("<YOUR_MESSAGE_ID>");
+            StatusLabel.Text = "Message started ✓";
+        }
+        catch (Exception ex)
+        {
+            StatusLabel.Text = $"Error: {ex.Message}";
+        }
+    }
+}
diff --git a/examples/example-maui/MauiProgram.cs b/examples/example-maui/MauiProgram.cs
new file mode 100644
index 0000000..9d97526
--- /dev/null
+++ b/examples/example-maui/MauiProgram.cs
@@ -0,0 +1,33 @@
+using Microsoft.Extensions.Logging;
+using Screeb.Maui;
+
+namespace ExampleMaui;
+
+public static class MauiProgram
+{
+    public static MauiApp CreateMauiApp()
+    {
+        var builder = MauiApp.CreateBuilder();
+        builder.UseMauiApp<App>();
+
+        // Initialize Screeb — replace with your channel ID
+        Task.Run(async () =>
+        {
+            await Screeb.InitSdk(
+                channelId: "<YOUR_CHANNEL_ID>",
+                userId: "maui-user-123",
+                properties: new Dictionary<string, object>
+                {
+                    ["platform"] = "maui",
+                    ["plan"] = "free"
+                }
+            );
+        });
+
+#if DEBUG
+        builder.Logging.AddDebug();
+#endif
+
+        return builder.Build();
+    }
+}
diff --git a/examples/example-maui/README.md b/examples/example-maui/README.md
new file mode 100644
index 0000000..a7e1e4e
--- /dev/null
+++ b/examples/example-maui/README.md
@@ -0,0 +1,15 @@
+# example-maui
+
+Example .NET MAUI app demonstrating the Screeb SDK.
+
+## Run
+
+```bash
+# Android
+dotnet build -t:Run -f net8.0-android
+
+# iOS (macOS only)
+dotnet build -t:Run -f net8.0-ios
+```
+
+Replace `<YOUR_CHANNEL_ID>` in `MauiProgram.cs` with your Screeb channel ID.
diff --git a/examples/example-maui/example-maui.csproj b/examples/example-maui/example-maui.csproj
new file mode 100644
index 0000000..24fb90f
--- /dev/null
+++ b/examples/example-maui/example-maui.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFrameworks>net8.0-android;net8.0-ios</TargetFrameworks>
+    <OutputType>Exe</OutputType>
+    <RootNamespace>ExampleMaui</RootNamespace>
+    <ApplicationId>app.screeb.example.maui</ApplicationId>
+    <ApplicationVersion>1</ApplicationVersion>
+    <ApplicationDisplayVersion>0.1.0</ApplicationDisplayVersion>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <UseMaui>true</UseMaui>
+  </PropertyGroup>
+  <ItemGroup>
+    <ProjectReference Include="../../packages/sdk-maui/ScreebMaui.csproj" />
+  </ItemGroup>
+</Project>
diff --git a/packages/sdk-maui/CHANGELOG.md b/packages/sdk-maui/CHANGELOG.md
new file mode 100644
index 0000000..26138ab
--- /dev/null
+++ b/packages/sdk-maui/CHANGELOG.md
@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0 (initial release)
+- Android + iOS support
+- 18 methods: InitSdk, SetIdentity, SetProperties, AssignGroup, UnassignGroup, TrackEvent, TrackScreen, StartSurvey, StartMessage, CloseSdk, CloseSurvey, CloseMessage, SessionReplayStart, SessionReplayStop, ResetIdentity, GetIdentity, Debug, DebugTargeting
diff --git a/packages/sdk-maui/Platforms/Android/.gitkeep b/packages/sdk-maui/Platforms/Android/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/packages/sdk-maui/Platforms/Android/HooksAndroid.cs b/packages/sdk-maui/Platforms/Android/HooksAndroid.cs
new file mode 100644
index 0000000..2fb00ba
--- /dev/null
+++ b/packages/sdk-maui/Platforms/Android/HooksAndroid.cs
@@ -0,0 +1,63 @@
+// packages/sdk-maui/Platforms/Android/HooksAndroid.cs
+#if ANDROID
+using Java.Util;
+
+namespace Screeb.Maui;
+
+internal static class HooksAndroid
+{
+    internal static HashMap? ToGlobalHooks(Dictionary<string, string> uuidMap)
+        => BuildHooksMap(uuidMap);
+
+    internal static HashMap? ToSurveyHooks(Dictionary<string, string> uuidMap)
+        => BuildHooksMap(uuidMap);
+
+    private static HashMap? BuildHooksMap(Dictionary<string, string> uuidMap)
+    {
+        if (uuidMap.Count == 0) return null;
+        var map = new HashMap();
+        foreach (var (key, value) in uuidMap)
+        {
+            if (key == "version")
+            {
+                map.Put(key, new Java.Lang.String(value));
+            }
+            else
+            {
+                var uuid = value; // capture
+                map.Put(key, new KotlinHookCallback(payload =>
+                {
+                    var fn = HooksRegistry.Get(uuid);
+                    if (fn != null)
+                    {
+                        // Fire and forget — run the C# callback asynchronously
+                        Task.Run(() => fn(payload?.ToString() ?? "{}"));
+                    }
+                }));
+            }
+        }
+        return map;
+    }
+}
+
+/// <summary>
+/// Wraps a C# Action as a Kotlin Function1&lt;Object, Unit&gt; so the
+/// Android Screeb SDK can call it as a hook callback.
+/// </summary>
+[Android.Runtime.Register("app/screeb/maui/KotlinHookCallback")]
+internal class KotlinHookCallback : Java.Lang.Object, Kotlin.Jvm.Functions.IFunction1
+{
+    private readonly Action<Java.Lang.Object?> _onHook;
+
+    public KotlinHookCallback(Action<Java.Lang.Object?> onHook)
+    {
+        _onHook = onHook;
+    }
+
+    public Java.Lang.Object? Invoke(Java.Lang.Object? p0)
+    {
+        _onHook(p0);
+        return null; // Kotlin Unit → null
+    }
+}
+#endif
diff --git a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
new file mode 100644
index 0000000..01a6728
--- /dev/null
+++ b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
@@ -0,0 +1,330 @@
+// packages/sdk-maui/Platforms/Android/Screeb.Android.cs
+#if ANDROID
+using Android.OS;
+using App.Screeb.Sdk;
+using Java.Util;
+
+namespace Screeb.Maui;
+
+public static partial class Screeb
+{
+    private static Android.Content.Context AppContext =>
+        Android.App.Application.Context;
+
+    private static IEnumerable<string>? _globalHookUuids;
+
+    public static partial async Task<bool?> InitSdk(
+        string channelId,
+        string? userId,
+        Dictionary<string, object>? properties,
+        ScreebHooks? hooks,
+        ScreebInitOptions? initOptions,
+        string? language)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", "0.1.0");
+                var jProps = ToHashMap(ScreebUtils.FormatProperties(properties));
+                var jInitOptions = ToInitOptionsMap(initOptions);
+                var uuidMap = HooksRegistry.RegisterHooks(hooks);
+                _globalHookUuids = uuidMap.Values.ToList();
+                var jHooks = HooksAndroid.ToGlobalHooks(uuidMap);
+                App.Screeb.Sdk.Screeb.Instance.PluginInit(
+                    channelId, userId, jProps, jInitOptions, jHooks, language);
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> CloseSdk()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                if (_globalHookUuids != null)
+                {
+                    HooksRegistry.Unregister(_globalHookUuids);
+                    _globalHookUuids = null;
+                }
+                App.Screeb.Sdk.Screeb.Instance.CloseSdk();
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                App.Screeb.Sdk.Screeb.Instance.SetIdentity(userId, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> SetProperties(Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                var props = ToHashMap(ScreebUtils.FormatProperties(properties));
+                if (props != null) App.Screeb.Sdk.Screeb.Instance.SetVisitorProperties(props);
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> ResetIdentity()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try { App.Screeb.Sdk.Screeb.Instance.ResetIdentity(); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial Task<Dictionary<string, object>?> GetIdentity()
+    {
+        var tcs = new TaskCompletionSource<Dictionary<string, object>?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            App.Screeb.Sdk.Screeb.Instance.GetIdentity((identity, error) =>
+            {
+                if (error != null) tcs.SetException(new Exception(error.Message));
+                else tcs.SetResult(FromHashMap(identity));
+            });
+        });
+        return tcs.Task;
+    }
+
+    public static partial async Task<bool?> AssignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                App.Screeb.Sdk.Screeb.Instance.AssignGroup(groupType, groupName, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> UnassignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                App.Screeb.Sdk.Screeb.Instance.UnassignGroup(groupType, groupName, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> TrackEvent(string name, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                App.Screeb.Sdk.Screeb.Instance.TrackEvent(name, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> TrackScreen(string name, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                App.Screeb.Sdk.Screeb.Instance.TrackScreen(name, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> StartSurvey(
+        string surveyId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
+        bool ignoreSurveyStatus, ScreebHooks? hooks, string? language, string? distributionId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                var jHooks = HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks));
+                // TODO: unregister survey hooks on close
+                App.Screeb.Sdk.Screeb.Instance.StartSurvey(
+                    surveyId, allowMultipleResponses, ToHashMap(ScreebUtils.FormatProperties(hiddenFields)),
+                    ignoreSurveyStatus, jHooks, language, distributionId);
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> CloseSurvey(string? surveyId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try { App.Screeb.Sdk.Screeb.Instance.CloseSurvey(surveyId); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> StartMessage(
+        string messageId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
+        bool ignoreMessageStatus, ScreebHooks? hooks, string? language, string? distributionId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try
+            {
+                var jHooks = HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks));
+                // TODO: unregister message hooks on close
+                App.Screeb.Sdk.Screeb.Instance.StartMessage(
+                    messageId, allowMultipleResponses, ToHashMap(ScreebUtils.FormatProperties(hiddenFields)),
+                    ignoreMessageStatus, jHooks, language, distributionId);
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> CloseMessage(string? messageId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try { App.Screeb.Sdk.Screeb.Instance.CloseMessage(messageId); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> SessionReplayStart()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try { App.Screeb.Sdk.Screeb.Instance.SessionReplayStart(); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial async Task<bool?> SessionReplayStop()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            try { App.Screeb.Sdk.Screeb.Instance.SessionReplayStop(); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return await tcs.Task;
+    }
+
+    public static partial Task<string?> Debug()
+    {
+        var tcs = new TaskCompletionSource<string?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            App.Screeb.Sdk.Screeb.Instance.Debug((info, error) =>
+            {
+                if (error != null) tcs.SetException(new Exception(error.Message));
+                else tcs.SetResult(info);
+            });
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<string?> DebugTargeting()
+    {
+        var tcs = new TaskCompletionSource<string?>();
+        new Handler(Looper.MainLooper!).Post(() =>
+        {
+            App.Screeb.Sdk.Screeb.Instance.DebugTargeting((info, error) =>
+            {
+                if (error != null) tcs.SetException(new Exception(error.Message));
+                else tcs.SetResult(info);
+            });
+        });
+        return tcs.Task;
+    }
+
+    // --- Helpers ---
+
+    private static HashMap? ToHashMap(Dictionary<string, object>? dict)
+    {
+        if (dict == null) return null;
+        var map = new HashMap();
+        foreach (var (k, v) in dict)
+            map.Put(k, v is string s ? new Java.Lang.String(s) :
+                       v is bool b ? Java.Lang.Boolean.ValueOf(b) :
+                       v is int i ? Java.Lang.Integer.ValueOf(i) :
+                       v is long l ? Java.Lang.Long.ValueOf(l) :
+                       v is double d ? Java.Lang.Double.ValueOf(d) :
+                       Java.Lang.Object.FromArray(new[] { v.ToString() }));
+        return map;
+    }
+
+    private static Dictionary<string, object>? FromHashMap(Java.Util.HashMap? map)
+    {
+        if (map == null) return null;
+        var result = new Dictionary<string, object>();
+        var entries = map.EntrySet();
+        if (entries == null) return result;
+        foreach (Java.Util.IMapEntry entry in entries)
+            result[entry.Key?.ToString() ?? ""] = entry.Value?.ToString() ?? "";
+        return result;
+    }
+
+    private static HashMap? ToInitOptionsMap(ScreebInitOptions? opts)
+    {
+        if (opts == null) return null;
+        var map = new HashMap();
+        map.Put("isDebugMode", Java.Lang.Boolean.ValueOf(opts.IsDebugMode));
+        map.Put("disableMirror", Java.Lang.Boolean.ValueOf(opts.DisableMirror));
+        return map;
+    }
+}
+#endif
diff --git a/packages/sdk-maui/Platforms/iOS/.gitkeep b/packages/sdk-maui/Platforms/iOS/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
new file mode 100644
index 0000000..e720352
--- /dev/null
+++ b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
@@ -0,0 +1,121 @@
+// packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
+using Foundation;
+using UIKit;
+using ObjCRuntime;
+
+namespace Screeb.iOS.Binding;
+
+[Static]
+[DisableDefaultCtor]
+interface Screeb
+{
+    [Static]
+    [Export("setSecondarySDK:version:")]
+    void SetSecondarySDK(string name, string version);
+
+    [Static]
+    [Export("initSdk:channelId:identity:visitorProperty:initOptions:hooks:language:")]
+    void InitSdk(
+        [NullAllowed] UIViewController context,
+        string channelId,
+        [NullAllowed] string identity,
+        NSDictionary visitorProperty,
+        [NullAllowed] InitOptions initOptions,
+        [NullAllowed] NSDictionary hooks,
+        [NullAllowed] string language);
+
+    [Static]
+    [Export("closeSdk")]
+    void CloseSdk();
+
+    [Static]
+    [Export("setIdentity:visitorProperty:")]
+    void SetIdentity(string uniqueVisitorId, NSDictionary visitorProperty);
+
+    [Static]
+    [Export("visitorProperty:")]
+    void VisitorProperty(NSDictionary visitorProperty);
+
+    [Static]
+    [Export("resetIdentity")]
+    void ResetIdentity();
+
+    [Static]
+    [Export("getIdentity:")]
+    void GetIdentity(Action<NSDictionary?, NSError?> completion);
+
+    [Static]
+    [Export("assignGroup:name:properties:")]
+    void AssignGroup([NullAllowed] string type, string name, NSDictionary properties);
+
+    [Static]
+    [Export("unassignGroup:name:properties:")]
+    void UnassignGroup([NullAllowed] string type, string name, NSDictionary properties);
+
+    [Static]
+    [Export("trackEvent:trackingEventProperties:")]
+    void TrackEvent(string name, NSDictionary trackingEventProperties);
+
+    [Static]
+    [Export("trackScreen:trackingEventProperties:")]
+    void TrackScreen(string name, NSDictionary trackingEventProperties);
+
+    [Static]
+    [Export("startSurvey:allowMultipleResponses:hiddenFields:ignoreSurveyStatus:hooks:language:distributionId:")]
+    void StartSurvey(
+        string surveyId,
+        bool allowMultipleResponses,
+        NSDictionary hiddenFields,
+        bool ignoreSurveyStatus,
+        [NullAllowed] NSDictionary hooks,
+        [NullAllowed] string language,
+        [NullAllowed] string distributionId);
+
+    [Static]
+    [Export("closeSurvey:")]
+    void CloseSurvey([NullAllowed] string surveyId);
+
+    [Static]
+    [Export("startMessage:allowMultipleResponses:hiddenFields:ignoreMessageStatus:hooks:language:distributionId:")]
+    void StartMessage(
+        string messageId,
+        bool allowMultipleResponses,
+        NSDictionary hiddenFields,
+        bool ignoreMessageStatus,
+        [NullAllowed] NSDictionary hooks,
+        [NullAllowed] string language,
+        [NullAllowed] string distributionId);
+
+    [Static]
+    [Export("closeMessage:")]
+    void CloseMessage([NullAllowed] string messageId);
+
+    [Static]
+    [Export("sessionReplayStart")]
+    void SessionReplayStart();
+
+    [Static]
+    [Export("sessionReplayStop")]
+    void SessionReplayStop();
+
+    [Static]
+    [Export("debug:")]
+    void Debug(Action<string?, NSError?> completion);
+
+    [Static]
+    [Export("debugTargeting:")]
+    void DebugTargeting(Action<string?, NSError?> completion);
+}
+
+[BaseType(typeof(NSObject))]
+interface InitOptions
+{
+    [Export("initWithDict:")]
+    NativeHandle Constructor(NSDictionary dict);
+
+    [Export("isDebugMode")]
+    bool IsDebugMode { get; set; }
+
+    [Export("disableMirror")]
+    bool DisableMirror { get; set; }
+}
diff --git a/packages/sdk-maui/Platforms/iOS/HooksIOS.cs b/packages/sdk-maui/Platforms/iOS/HooksIOS.cs
new file mode 100644
index 0000000..2cf3494
--- /dev/null
+++ b/packages/sdk-maui/Platforms/iOS/HooksIOS.cs
@@ -0,0 +1,28 @@
+#if IOS
+using Foundation;
+
+namespace Screeb.Maui;
+
+internal static class HooksIOS
+{
+    /// <summary>
+    /// Converts hook UUIDs to NSDictionary for passing to native iOS SDK.
+    /// NOTE: ObjC block-based hook callbacks are not yet supported in v0.1.0.
+    /// The "version" key is passed as a string; other hook keys are registered
+    /// in HooksRegistry but callbacks will not fire from the native iOS side.
+    /// </summary>
+    internal static NSDictionary? ToNSDictionary(Dictionary<string, string> uuidMap)
+    {
+        if (uuidMap.Count == 0) return null;
+        var keys = new List<NSObject>();
+        var values = new List<NSObject>();
+
+        foreach (var (key, value) in uuidMap)
+        {
+            keys.Add(new NSString(key));
+            values.Add(new NSString(value));
+        }
+        return NSDictionary.FromObjectsAndKeys(values.ToArray(), keys.ToArray());
+    }
+}
+#endif
diff --git a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
new file mode 100644
index 0000000..823a5d7
--- /dev/null
+++ b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
@@ -0,0 +1,324 @@
+#if IOS
+using Foundation;
+using Screeb.iOS.Binding;
+
+namespace Screeb.Maui;
+
+public static partial class Screeb
+{
+    public static partial Task<bool?> InitSdk(
+        string channelId, string? userId, Dictionary<string, object>? properties,
+        ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.SetSecondarySDK("maui", "0.1.0");
+                var ioOpts = new Screeb.iOS.Binding.InitOptions(NSDictionary.FromObjectsAndKeys(
+                    new object[] { 
+                        NSNumber.FromBoolean(initOptions?.IsDebugMode ?? false), 
+                        NSNumber.FromBoolean(initOptions?.DisableMirror ?? false) 
+                    },
+                    new object[] { "isDebugMode", "disableMirror" }));
+                var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
+                Screeb.iOS.Binding.Screeb.InitSdk(
+                    null, channelId, userId,
+                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary(),
+                    ioOpts, jHooks, language);
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> CloseSdk()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try { Screeb.iOS.Binding.Screeb.CloseSdk(); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.SetIdentity(userId,
+                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> SetProperties(Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.VisitorProperty(
+                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> ResetIdentity()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try { Screeb.iOS.Binding.Screeb.ResetIdentity(); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<Dictionary<string, object>?> GetIdentity()
+    {
+        var tcs = new TaskCompletionSource<Dictionary<string, object>?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.GetIdentity((identity, error) =>
+                {
+                    if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
+                    else tcs.SetResult(FromNSDictionary(identity));
+                });
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> AssignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.AssignGroup(groupType, groupName,
+                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> UnassignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.UnassignGroup(groupType, groupName,
+                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> TrackEvent(string name, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.TrackEvent(name,
+                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> TrackScreen(string name, Dictionary<string, object>? properties)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.TrackScreen(name,
+                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> StartSurvey(
+        string surveyId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
+        bool ignoreSurveyStatus, ScreebHooks? hooks, string? language, string? distributionId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
+                Screeb.iOS.Binding.Screeb.StartSurvey(
+                    surveyId, allowMultipleResponses,
+                    ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
+                    ignoreSurveyStatus, jHooks, language, distributionId);
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> CloseSurvey(string? surveyId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try { Screeb.iOS.Binding.Screeb.CloseSurvey(surveyId); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> StartMessage(
+        string messageId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
+        bool ignoreMessageStatus, ScreebHooks? hooks, string? language, string? distributionId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
+                Screeb.iOS.Binding.Screeb.StartMessage(
+                    messageId, allowMultipleResponses,
+                    ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
+                    ignoreMessageStatus, jHooks, language, distributionId);
+                tcs.SetResult(true);
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> CloseMessage(string? messageId)
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try { Screeb.iOS.Binding.Screeb.CloseMessage(messageId); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> SessionReplayStart()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try { Screeb.iOS.Binding.Screeb.SessionReplayStart(); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<bool?> SessionReplayStop()
+    {
+        var tcs = new TaskCompletionSource<bool?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try { Screeb.iOS.Binding.Screeb.SessionReplayStop(); tcs.SetResult(true); }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<string?> Debug()
+    {
+        var tcs = new TaskCompletionSource<string?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.Debug((info, error) =>
+                {
+                    if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
+                    else tcs.SetResult(info);
+                });
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    public static partial Task<string?> DebugTargeting()
+    {
+        var tcs = new TaskCompletionSource<string?>();
+        MainThread.InvokeOnMainThread(() =>
+        {
+            try
+            {
+                Screeb.iOS.Binding.Screeb.DebugTargeting((info, error) =>
+                {
+                    if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
+                    else tcs.SetResult(info);
+                });
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
+        });
+        return tcs.Task;
+    }
+
+    // --- Helpers ---
+
+    private static NSDictionary? ToNSDictionary(Dictionary<string, object>? dict)
+    {
+        if (dict == null) return null;
+        var keys = new List<NSObject>();
+        var values = new List<NSObject>();
+        foreach (var (k, v) in dict)
+        {
+            keys.Add(new NSString(k));
+            values.Add(v is string s ? new NSString(s) :
+                       v is bool b ? NSNumber.FromBoolean(b) :
+                       v is int i ? NSNumber.FromInt32(i) :
+                       v is long l ? NSNumber.FromInt64(l) :
+                       v is double d ? NSNumber.FromDouble(d) :
+                       new NSString(v.ToString() ?? ""));
+        }
+        return NSDictionary.FromObjectsAndKeys(values.ToArray(), keys.ToArray());
+    }
+
+    private static Dictionary<string, object>? FromNSDictionary(NSDictionary? dict)
+    {
+        if (dict == null) return null;
+        var result = new Dictionary<string, object>();
+        foreach (var key in dict.Keys)
+            result[key.ToString() ?? ""] = dict[key]?.ToString() ?? "";
+        return result;
+    }
+}
+#endif
diff --git a/packages/sdk-maui/Platforms/iOS/StructsAndEnums.cs b/packages/sdk-maui/Platforms/iOS/StructsAndEnums.cs
new file mode 100644
index 0000000..dcd345f
--- /dev/null
+++ b/packages/sdk-maui/Platforms/iOS/StructsAndEnums.cs
@@ -0,0 +1,3 @@
+// packages/sdk-maui/Platforms/iOS/StructsAndEnums.cs
+// iOS SDK enums and structs — empty for Screeb SDK v0.1.0
+// (Screeb iOS SDK uses no exported enums at the ObjC bridge level)
diff --git a/packages/sdk-maui/README.md b/packages/sdk-maui/README.md
new file mode 100644
index 0000000..2736592
--- /dev/null
+++ b/packages/sdk-maui/README.md
@@ -0,0 +1,33 @@
+# Screeb.Maui
+
+.NET MAUI SDK for [Screeb](https://screeb.app) — Continuous Product Discovery.
+
+## Installation
+
+```sh
+dotnet add package Screeb.Maui
+```
+
+## Usage
+
+```csharp
+// In MauiProgram.cs or App.xaml.cs
+await Screeb.InitSdk(
+    channelId: "<YOUR_CHANNEL_ID>",
+    userId: "user-123",
+    properties: new Dictionary<string, object> { ["plan"] = "premium" }
+);
+```
+
+## Development Setup
+
+### iOS XCFramework
+
+The iOS SDK is distributed as a binary XCFramework. Before building for iOS:
+
+1. Download the latest release from https://github.com/ScreebApp/sdk-ios-public/releases
+2. Extract `Screeb.xcframework` to `packages/sdk-maui/native/ios/Screeb.xcframework/`
+
+The XCFramework is excluded from git (binary, large file).
+
+See [full documentation](https://developers.screeb.app/sdk-maui/install).
diff --git a/packages/sdk-maui/Screeb.cs b/packages/sdk-maui/Screeb.cs
new file mode 100644
index 0000000..54dd751
--- /dev/null
+++ b/packages/sdk-maui/Screeb.cs
@@ -0,0 +1,150 @@
+namespace Screeb.Maui;
+
+/// <summary>
+/// Screeb SDK for .NET MAUI. All methods are thread-safe and run on the main thread.
+/// Call InitSdk before any other method.
+/// </summary>
+public static partial class Screeb
+{
+    /// <summary>
+    /// Initialize the Screeb SDK. Must be called before any other method.
+    /// </summary>
+    /// <param name="channelId">Your Screeb channel ID from the Screeb dashboard.</param>
+    /// <param name="userId">Visitor identifier. Pass null for anonymous visitors.</param>
+    /// <param name="properties">User properties. Supports string, int, double, bool, DateTime, and nested Dictionary values. Pass null for no properties.</param>
+    /// <param name="hooks">Optional lifecycle callbacks for survey/message events.</param>
+    /// <param name="initOptions">Optional SDK configuration options.</param>
+    /// <param name="language">ISO 639-1 language code (e.g. "en", "fr"). Pass null to use device locale.</param>
+    /// <returns>true if initialization succeeded, false if it failed or SDK already initialized, null if unsupported.</returns>
+    public static partial Task<bool?> InitSdk(
+        string channelId,
+        string? userId = null,
+        Dictionary<string, object>? properties = null,
+        ScreebHooks? hooks = null,
+        ScreebInitOptions? initOptions = null,
+        string? language = null);
+
+    /// <summary>Stop the SDK. Opposite of InitSdk.</summary>
+    /// <returns>true if closure succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> CloseSdk();
+
+    /// <summary>Identify the current user with optional properties.</summary>
+    /// <param name="userId">Visitor identifier.</param>
+    /// <param name="properties">User properties. Supports string, int, double, bool, DateTime, and nested Dictionary values. Pass null for no properties.</param>
+    /// <returns>true if identification succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> SetIdentity(
+        string userId,
+        Dictionary<string, object>? properties = null);
+
+    /// <summary>Send visitor properties without changing the identity.</summary>
+    /// <param name="properties">User properties. Supports string, int, double, bool, DateTime, and nested Dictionary values. Pass null for no properties.</param>
+    /// <returns>true if properties update succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> SetProperties(
+        Dictionary<string, object>? properties = null);
+
+    /// <summary>Reset user identity (e.g. on logout).</summary>
+    /// <returns>true if reset succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> ResetIdentity();
+
+    /// <summary>Get current visitor identity and properties.</summary>
+    /// <returns>Dictionary of current identity and properties, or null if identity is unavailable or SDK not initialized.</returns>
+    public static partial Task<Dictionary<string, object>?> GetIdentity();
+
+    /// <summary>Assign the current user to a group.</summary>
+    /// <param name="groupType">Group type identifier, or null for the default group type.</param>
+    /// <param name="groupName">Group name identifier.</param>
+    /// <param name="properties">User properties. Supports string, int, double, bool, DateTime, and nested Dictionary values. Pass null for no properties.</param>
+    /// <returns>true if assignment succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> AssignGroup(
+        string? groupType,
+        string groupName,
+        Dictionary<string, object>? properties = null);
+
+    /// <summary>Remove the current user from a group.</summary>
+    /// <param name="groupType">Group type identifier, or null for the default group type.</param>
+    /// <param name="groupName">Group name identifier.</param>
+    /// <param name="properties">User properties. Supports string, int, double, bool, DateTime, and nested Dictionary values. Pass null for no properties.</param>
+    /// <returns>true if removal succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> UnassignGroup(
+        string? groupType,
+        string groupName,
+        Dictionary<string, object>? properties = null);
+
+    /// <summary>Track a custom event.</summary>
+    /// <param name="name">Event name.</param>
+    /// <param name="properties">User properties. Supports string, int, double, bool, DateTime, and nested Dictionary values. Pass null for no properties.</param>
+    /// <returns>true if event tracking succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> TrackEvent(
+        string name,
+        Dictionary<string, object>? properties = null);
+
+    /// <summary>Track a screen navigation event.</summary>
+    /// <param name="name">Event name.</param>
+    /// <param name="properties">User properties. Supports string, int, double, bool, DateTime, and nested Dictionary values. Pass null for no properties.</param>
+    /// <returns>true if screen tracking succeeded, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> TrackScreen(
+        string name,
+        Dictionary<string, object>? properties = null);
+
+    /// <summary>Start a specific survey programmatically.</summary>
+    /// <param name="surveyId">Survey identifier.</param>
+    /// <param name="allowMultipleResponses">Allow the same visitor to respond multiple times.</param>
+    /// <param name="hiddenFields">Pre-filled hidden field values.</param>
+    /// <param name="ignoreSurveyStatus">Show survey even if it has already been completed.</param>
+    /// <param name="hooks">Optional lifecycle callbacks for survey/message events.</param>
+    /// <param name="language">ISO 639-1 language code (e.g. "en", "fr"). Pass null to use device locale.</param>
+    /// <param name="distributionId">Distribution identifier. Pass null to use the default distribution.</param>
+    /// <returns>true if survey started successfully, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> StartSurvey(
+        string surveyId,
+        bool allowMultipleResponses = true,
+        Dictionary<string, object>? hiddenFields = null,
+        bool ignoreSurveyStatus = true,
+        ScreebHooks? hooks = null,
+        string? language = null,
+        string? distributionId = null);
+
+    /// <summary>Close the currently displayed survey.</summary>
+    /// <param name="surveyId">Survey identifier.</param>
+    /// <returns>true if survey closed successfully, false if it failed or no survey is displayed, null if unsupported.</returns>
+    public static partial Task<bool?> CloseSurvey(string? surveyId = null);
+
+    /// <summary>Start a specific message programmatically.</summary>
+    /// <param name="messageId">Message identifier.</param>
+    /// <param name="allowMultipleResponses">Allow the same visitor to respond multiple times.</param>
+    /// <param name="hiddenFields">Pre-filled hidden field values.</param>
+    /// <param name="ignoreMessageStatus">Show message even if it has already been seen.</param>
+    /// <param name="hooks">Optional lifecycle callbacks for survey/message events.</param>
+    /// <param name="language">ISO 639-1 language code (e.g. "en", "fr"). Pass null to use device locale.</param>
+    /// <param name="distributionId">Distribution identifier. Pass null to use the default distribution.</param>
+    /// <returns>true if message started successfully, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> StartMessage(
+        string messageId,
+        bool allowMultipleResponses = true,
+        Dictionary<string, object>? hiddenFields = null,
+        bool ignoreMessageStatus = true,
+        ScreebHooks? hooks = null,
+        string? language = null,
+        string? distributionId = null);
+
+    /// <summary>Close the currently displayed message.</summary>
+    /// <param name="messageId">Message identifier.</param>
+    /// <returns>true if message closed successfully, false if it failed or no message is displayed, null if unsupported.</returns>
+    public static partial Task<bool?> CloseMessage(string? messageId = null);
+
+    /// <summary>Start session replay recording.</summary>
+    /// <returns>true if recording started successfully, false if it failed or SDK not initialized, null if unsupported.</returns>
+    public static partial Task<bool?> SessionReplayStart();
+
+    /// <summary>Stop session replay recording.</summary>
+    /// <returns>true if recording stopped successfully, false if it failed or recording not active, null if unsupported.</returns>
+    public static partial Task<bool?> SessionReplayStop();
+
+    /// <summary>Get SDK debug information.</summary>
+    /// <returns>Debug information string, or null if SDK is not initialized.</returns>
+    public static partial Task<string?> Debug();
+
+    /// <summary>Get targeting debug information (why surveys aren't showing).</summary>
+    /// <returns>Targeting debug information string, or null if SDK is not initialized.</returns>
+    public static partial Task<string?> DebugTargeting();
+}
diff --git a/packages/sdk-maui/ScreebHooks.cs b/packages/sdk-maui/ScreebHooks.cs
new file mode 100644
index 0000000..64101f8
--- /dev/null
+++ b/packages/sdk-maui/ScreebHooks.cs
@@ -0,0 +1,50 @@
+namespace Screeb.Maui;
+
+public class ScreebHooks
+{
+    public string? Version { get; set; }
+
+    /// <summary>
+    /// Hook callbacks: key = hook name (e.g. "onSurveyShowed"),
+    /// value = async callback receiving the JSON payload string.
+    /// </summary>
+    public Dictionary<string, Func<string, Task<object?>>> Callbacks { get; set; } = new();
+}
+
+/// <summary>
+/// Internal registry mapping UUID → C# callback. Used by platform implementations.
+/// Thread-safe via ConcurrentDictionary — callbacks are registered from the main thread
+/// but invoked from native Android/iOS callback threads.
+/// </summary>
+internal static class HooksRegistry
+{
+    private static readonly System.Collections.Concurrent.ConcurrentDictionary<string, Func<string, Task<object?>>> _registry = new();
+
+    internal static Dictionary<string, string> RegisterHooks(ScreebHooks? hooks)
+    {
+        var uuidMap = new Dictionary<string, string>();
+        if (hooks == null) return uuidMap;
+        if (hooks.Version != null)
+            uuidMap["version"] = hooks.Version;
+        foreach (var (key, callback) in hooks.Callbacks)
+        {
+            var uuid = Guid.NewGuid().ToString("N") + "_" + key;
+            _registry[uuid] = callback;
+            uuidMap[key] = uuid;
+        }
+        return uuidMap;
+    }
+
+    internal static Func<string, Task<object?>>? Get(string uuid)
+        => _registry.TryGetValue(uuid, out var fn) ? fn : null;
+
+    /// <summary>
+    /// Removes registered callbacks by UUID. Call after SDK teardown or hook de-registration
+    /// to prevent unbounded memory growth across repeated InitSdk/StartSurvey calls.
+    /// </summary>
+    internal static void Unregister(IEnumerable<string> uuids)
+    {
+        foreach (var uuid in uuids)
+            _registry.TryRemove(uuid, out _);
+    }
+}
diff --git a/packages/sdk-maui/ScreebInitOptions.cs b/packages/sdk-maui/ScreebInitOptions.cs
new file mode 100644
index 0000000..fe08b2b
--- /dev/null
+++ b/packages/sdk-maui/ScreebInitOptions.cs
@@ -0,0 +1,7 @@
+namespace Screeb.Maui;
+
+public class ScreebInitOptions
+{
+    public bool IsDebugMode { get; set; } = false;
+    public bool DisableMirror { get; set; } = false;
+}
diff --git a/packages/sdk-maui/ScreebMaui.csproj b/packages/sdk-maui/ScreebMaui.csproj
new file mode 100644
index 0000000..bc659f7
--- /dev/null
+++ b/packages/sdk-maui/ScreebMaui.csproj
@@ -0,0 +1,49 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFrameworks>net8.0-android;net8.0-ios</TargetFrameworks>
+    <RootNamespace>Screeb.Maui</RootNamespace>
+    <AssemblyName>Screeb.Maui</AssemblyName>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <SingleProject>true</SingleProject>
+    <!-- NuGet metadata -->
+    <PackageId>Screeb.Maui</PackageId>
+    <Version>0.1.0</Version>
+    <Authors>Screeb</Authors>
+    <Company>Screeb</Company>
+    <Description>Screeb Continuous Product Discovery SDK for .NET MAUI (Android + iOS)</Description>
+    <PackageLicenseExpression>MIT</PackageLicenseExpression>
+    <PackageProjectUrl>https://developers.screeb.app/sdk-maui/install</PackageProjectUrl>
+    <RepositoryUrl>https://github.com/ScreebApp/sdk</RepositoryUrl>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
+    <PackageTags>maui android ios screeb survey analytics</PackageTags>
+    <RepositoryType>git</RepositoryType>
+  </PropertyGroup>
+
+  <!-- Android native binding -->
+  <ItemGroup Condition="$(TargetFramework.Contains('-android'))">
+    <AndroidMavenLibrary
+      Include="app.screeb.sdk:survey"
+      Version="3.2.0"
+      Bind="true" />
+  </ItemGroup>
+
+  <!-- iOS native binding -->
+  <ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
+    <NativeReference Include="native/ios/Screeb.xcframework">
+      <Kind>Framework</Kind>
+      <Frameworks>Foundation UIKit</Frameworks>
+      <IsCxx>false</IsCxx>
+    </NativeReference>
+    <Compile Include="Platforms/iOS/ApiDefinitions.cs" />
+    <Compile Include="Platforms/iOS/StructsAndEnums.cs" />
+  </ItemGroup>
+
+  <!-- NuGet: include README and native iOS framework -->
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="/" />
+    <Content Include="native/ios/Screeb.xcframework/**"
+             Pack="true"
+             PackagePath="runtimes/ios/native/" />
+  </ItemGroup>
+</Project>
diff --git a/packages/sdk-maui/ScreebUtils.cs b/packages/sdk-maui/ScreebUtils.cs
new file mode 100644
index 0000000..4382e85
--- /dev/null
+++ b/packages/sdk-maui/ScreebUtils.cs
@@ -0,0 +1,35 @@
+namespace Screeb.Maui;
+
+public static class ScreebUtils
+{
+    /// <summary>
+    /// Converts DateTime/DateTimeOffset values to ISO 8601 strings with timezone offset,
+    /// e.g. "2024-01-15T10:30:00.000+02:00". Recursively processes nested dictionaries.
+    /// Mirrors Flutter's _formatDates and React Native's normalizeValue.
+    /// </summary>
+    public static Dictionary<string, object>? FormatProperties(Dictionary<string, object>? props)
+    {
+        if (props == null) return null;
+        var result = new Dictionary<string, object>(props.Count);
+        foreach (var (key, value) in props)
+            result[key] = FormatValue(value);
+        return result;
+    }
+
+    private static object FormatValue(object value) => value switch
+    {
+        DateTimeOffset dto => FormatDateTimeOffset(dto),
+        DateTime dt => FormatDateTimeOffset(new DateTimeOffset(dt)),
+        Dictionary<string, object> nested => FormatProperties(nested)!,
+        _ => value
+    };
+
+    private static string FormatDateTimeOffset(DateTimeOffset dto)
+    {
+        var offset = dto.Offset;
+        var sign = offset >= TimeSpan.Zero ? "+" : "-";
+        var absHours = Math.Abs(offset.Hours).ToString("D2");
+        var mins = Math.Abs(offset.Minutes).ToString("D2");
+        return $"{dto:yyyy-MM-ddTHH:mm:ss.fff}{sign}{absHours}:{mins}";
+    }
+}
diff --git a/packages/sdk-maui/native/ios/.gitkeep b/packages/sdk-maui/native/ios/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/packages/sdk-maui/tests/ScreebUtilsTests.cs b/packages/sdk-maui/tests/ScreebUtilsTests.cs
new file mode 100644
index 0000000..0cf30ef
--- /dev/null
+++ b/packages/sdk-maui/tests/ScreebUtilsTests.cs
@@ -0,0 +1,63 @@
+using Screeb.Maui;
+using Xunit;
+
+namespace Screeb.Maui.Tests;
+
+public class ScreebUtilsTests
+{
+    [Fact]
+    public void FormatProperties_NullInput_ReturnsNull()
+    {
+        var result = ScreebUtils.FormatProperties(null);
+        Assert.Null(result);
+    }
+
+    [Fact]
+    public void FormatProperties_NoDateValues_ReturnsSameDictionary()
+    {
+        var input = new Dictionary<string, object> { ["name"] = "Alice", ["age"] = 30 };
+        var result = ScreebUtils.FormatProperties(input)!;
+        Assert.Equal("Alice", result["name"]);
+        Assert.Equal(30, result["age"]);
+    }
+
+    [Fact]
+    public void FormatProperties_DateTimeValue_ConvertsToIso8601WithOffset()
+    {
+        var dt = new DateTimeOffset(2024, 1, 15, 10, 30, 0, TimeSpan.FromHours(2));
+        var input = new Dictionary<string, object> { ["created_at"] = dt };
+        var result = ScreebUtils.FormatProperties(input)!;
+        Assert.Equal("2024-01-15T10:30:00.000+02:00", result["created_at"]);
+    }
+
+    [Fact]
+    public void FormatProperties_NestedDictionary_RecursivelyFormats()
+    {
+        var dt = new DateTimeOffset(2024, 6, 1, 0, 0, 0, TimeSpan.Zero);
+        var input = new Dictionary<string, object>
+        {
+            ["meta"] = new Dictionary<string, object> { ["at"] = dt }
+        };
+        var result = ScreebUtils.FormatProperties(input)!;
+        var nested = (Dictionary<string, object>)result["meta"];
+        Assert.Equal("2024-06-01T00:00:00.000+00:00", nested["at"]);
+    }
+
+    [Fact]
+    public void FormatProperties_DateTimeUtcValue_ConvertsToIso8601WithZeroOffset()
+    {
+        var dt = DateTime.SpecifyKind(new DateTime(2024, 1, 15, 10, 30, 0), DateTimeKind.Utc);
+        var input = new Dictionary<string, object> { ["ts"] = dt };
+        var result = ScreebUtils.FormatProperties(input)!;
+        Assert.Equal("2024-01-15T10:30:00.000+00:00", result["ts"]);
+    }
+
+    [Fact]
+    public void FormatProperties_NegativeOffsetDate_IncludesMinusSign()
+    {
+        var dt = new DateTimeOffset(2024, 1, 15, 10, 30, 0, TimeSpan.FromHours(-5));
+        var input = new Dictionary<string, object> { ["ts"] = dt };
+        var result = ScreebUtils.FormatProperties(input)!;
+        Assert.Equal("2024-01-15T10:30:00.000-05:00", result["ts"]);
+    }
+}
diff --git a/packages/sdk-maui/tests/ScreebUtilsTests.csproj b/packages/sdk-maui/tests/ScreebUtilsTests.csproj
new file mode 100644
index 0000000..499c6d4
--- /dev/null
+++ b/packages/sdk-maui/tests/ScreebUtilsTests.csproj
@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <IsTestProject>true</IsTestProject>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
+    <PackageReference Include="xunit" Version="2.7.0" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.5.7">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+    <!-- Reference only ScreebUtils.cs, not the full MAUI project -->
+    <Compile Include="../ScreebUtils.cs" />
+  </ItemGroup>
+</Project>

From 79bc8f055a40847e45cabd7b9e0d0171a773828e Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:01:42 +0200
Subject: [PATCH 02/21] ci: add MAUI build job to CI

---
 .github/workflows/ci.yml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index fcccc7f..b86c4ac 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -35,3 +35,22 @@ jobs:
           channel: 'stable'
       - run: cd packages/sdk-flutter && flutter pub get
       - run: cd packages/sdk-flutter && flutter analyze
+
+  maui:
+    name: .NET MAUI SDK
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+      - name: Install MAUI workloads
+        run: dotnet workload install android ios
+      - name: Restore
+        run: dotnet restore packages/sdk-maui/ScreebMaui.csproj
+      - name: Build Android
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-android --no-restore
+      - name: Build iOS
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-ios --no-restore
+      - name: Run unit tests
+        run: dotnet test packages/sdk-maui/tests/ScreebUtilsTests.csproj

From 4d6d09b202c48afaa74a170c836aa1d05704a819 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:05:44 +0200
Subject: [PATCH 03/21] fix(sdk-maui): upgrade target frameworks from net8.0 to
 net9.0

---
 .github/workflows/ci.yml                        | 6 +++---
 .github/workflows/publish-maui.yml              | 6 +++---
 packages/sdk-maui/ScreebMaui.csproj             | 2 +-
 packages/sdk-maui/tests/ScreebUtilsTests.csproj | 2 +-
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index b86c4ac..c403c0f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -43,14 +43,14 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: '8.0.x'
+          dotnet-version: '9.0.x'
       - name: Install MAUI workloads
         run: dotnet workload install android ios
       - name: Restore
         run: dotnet restore packages/sdk-maui/ScreebMaui.csproj
       - name: Build Android
-        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-android --no-restore
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net9.0-android --no-restore
       - name: Build iOS
-        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-ios --no-restore
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net9.0-ios --no-restore
       - name: Run unit tests
         run: dotnet test packages/sdk-maui/tests/ScreebUtilsTests.csproj
diff --git a/.github/workflows/publish-maui.yml b/.github/workflows/publish-maui.yml
index 6ff2bbf..89c5c09 100644
--- a/.github/workflows/publish-maui.yml
+++ b/.github/workflows/publish-maui.yml
@@ -13,7 +13,7 @@ jobs:
 
       - uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: '8.0.x'
+          dotnet-version: '9.0.x'
 
       - name: Install MAUI workloads
         run: dotnet workload install android ios
@@ -22,10 +22,10 @@ jobs:
         run: dotnet restore packages/sdk-maui/ScreebMaui.csproj
 
       - name: Build Android
-        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-android -c Release --no-restore
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net9.0-android -c Release --no-restore
 
       - name: Build iOS
-        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net8.0-ios -c Release --no-restore
+        run: dotnet build packages/sdk-maui/ScreebMaui.csproj -f net9.0-ios -c Release --no-restore
 
       - name: Pack
         run: dotnet pack packages/sdk-maui/ScreebMaui.csproj -c Release --no-build -o ./nupkg
diff --git a/packages/sdk-maui/ScreebMaui.csproj b/packages/sdk-maui/ScreebMaui.csproj
index bc659f7..09237e3 100644
--- a/packages/sdk-maui/ScreebMaui.csproj
+++ b/packages/sdk-maui/ScreebMaui.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>net8.0-android;net8.0-ios</TargetFrameworks>
+    <TargetFrameworks>net9.0-android;net9.0-ios</TargetFrameworks>
     <RootNamespace>Screeb.Maui</RootNamespace>
     <AssemblyName>Screeb.Maui</AssemblyName>
     <Nullable>enable</Nullable>
diff --git a/packages/sdk-maui/tests/ScreebUtilsTests.csproj b/packages/sdk-maui/tests/ScreebUtilsTests.csproj
index 499c6d4..2125b43 100644
--- a/packages/sdk-maui/tests/ScreebUtilsTests.csproj
+++ b/packages/sdk-maui/tests/ScreebUtilsTests.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <IsTestProject>true</IsTestProject>

From 9c5ad7fa294790a6449cbc0482ceb4ce2d923647 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:10:05 +0200
Subject: [PATCH 04/21] fix(sdk-maui): add missing NuGet packages for
 transitive Android Maven deps (XA4242)

---
 packages/sdk-maui/ScreebMaui.csproj | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/sdk-maui/ScreebMaui.csproj b/packages/sdk-maui/ScreebMaui.csproj
index 09237e3..3cfce2e 100644
--- a/packages/sdk-maui/ScreebMaui.csproj
+++ b/packages/sdk-maui/ScreebMaui.csproj
@@ -26,6 +26,12 @@
       Include="app.screeb.sdk:survey"
       Version="3.2.0"
       Bind="true" />
+    <!-- Transitive Maven dependencies required by app.screeb.sdk:survey -->
+    <PackageReference Include="Xamarin.Kotlin.StdLib.Jdk8" Version="2.3.21" />
+    <PackageReference Include="Xamarin.AndroidX.Core.Core.Ktx" Version="1.18.0" />
+    <PackageReference Include="Xamarin.AndroidX.WebKit" Version="1.16.0" />
+    <PackageReference Include="Xamarin.Google.Android.Play.Review" Version="2.0.2.7" />
+    <PackageReference Include="Xamarin.Google.Android.Play.Review.Ktx" Version="2.0.2.7" />
   </ItemGroup>
 
   <!-- iOS native binding -->

From 013d16d9232675cf0f2d1a2851831f17fda4b776 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:15:17 +0200
Subject: [PATCH 05/21] fix(sdk-maui): exclude platform-specific and test files
 from default SDK glob

---
 packages/sdk-maui/ScreebMaui.csproj | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/packages/sdk-maui/ScreebMaui.csproj b/packages/sdk-maui/ScreebMaui.csproj
index 3cfce2e..6326a5a 100644
--- a/packages/sdk-maui/ScreebMaui.csproj
+++ b/packages/sdk-maui/ScreebMaui.csproj
@@ -20,6 +20,27 @@
     <RepositoryType>git</RepositoryType>
   </PropertyGroup>
 
+  <!-- Exclude platform-specific and test files from the default SDK glob -->
+  <ItemGroup>
+    <Compile Remove="Platforms/Android/**/*.cs" />
+    <Compile Remove="Platforms/iOS/**/*.cs" />
+    <Compile Remove="tests/**/*.cs" />
+  </ItemGroup>
+
+  <!-- Android platform files -->
+  <ItemGroup Condition="$(TargetFramework.Contains('-android'))">
+    <Compile Include="Platforms/Android/Screeb.Android.cs" />
+    <Compile Include="Platforms/Android/HooksAndroid.cs" />
+  </ItemGroup>
+
+  <!-- iOS platform files -->
+  <ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
+    <Compile Include="Platforms/iOS/ApiDefinitions.cs" />
+    <Compile Include="Platforms/iOS/StructsAndEnums.cs" />
+    <Compile Include="Platforms/iOS/Screeb.iOS.cs" />
+    <Compile Include="Platforms/iOS/HooksIOS.cs" />
+  </ItemGroup>
+
   <!-- Android native binding -->
   <ItemGroup Condition="$(TargetFramework.Contains('-android'))">
     <AndroidMavenLibrary
@@ -41,8 +62,6 @@
       <Frameworks>Foundation UIKit</Frameworks>
       <IsCxx>false</IsCxx>
     </NativeReference>
-    <Compile Include="Platforms/iOS/ApiDefinitions.cs" />
-    <Compile Include="Platforms/iOS/StructsAndEnums.cs" />
   </ItemGroup>
 
   <!-- NuGet: include README and native iOS framework -->

From 62ea3eec5525a50f0143c92ce53d8043c27837e8 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:25:13 +0200
Subject: [PATCH 06/21] fix(sdk-maui): use IDictionary<string,JavaObject> and
 KotlinResultCallback for Android binding

---
 .../Platforms/Android/HooksAndroid.cs         |  38 +++++--
 .../Platforms/Android/Screeb.Android.cs       | 104 ++++++++++--------
 2 files changed, 87 insertions(+), 55 deletions(-)

diff --git a/packages/sdk-maui/Platforms/Android/HooksAndroid.cs b/packages/sdk-maui/Platforms/Android/HooksAndroid.cs
index 2fb00ba..ca25138 100644
--- a/packages/sdk-maui/Platforms/Android/HooksAndroid.cs
+++ b/packages/sdk-maui/Platforms/Android/HooksAndroid.cs
@@ -1,39 +1,36 @@
 // packages/sdk-maui/Platforms/Android/HooksAndroid.cs
 #if ANDROID
-using Java.Util;
-
 namespace Screeb.Maui;
 
 internal static class HooksAndroid
 {
-    internal static HashMap? ToGlobalHooks(Dictionary<string, string> uuidMap)
+    internal static IDictionary<string, Java.Lang.Object>? ToGlobalHooks(Dictionary<string, string> uuidMap)
         => BuildHooksMap(uuidMap);
 
-    internal static HashMap? ToSurveyHooks(Dictionary<string, string> uuidMap)
+    internal static IDictionary<string, Java.Lang.Object>? ToSurveyHooks(Dictionary<string, string> uuidMap)
         => BuildHooksMap(uuidMap);
 
-    private static HashMap? BuildHooksMap(Dictionary<string, string> uuidMap)
+    private static IDictionary<string, Java.Lang.Object>? BuildHooksMap(Dictionary<string, string> uuidMap)
     {
         if (uuidMap.Count == 0) return null;
-        var map = new HashMap();
+        var map = new Dictionary<string, Java.Lang.Object>();
         foreach (var (key, value) in uuidMap)
         {
             if (key == "version")
             {
-                map.Put(key, new Java.Lang.String(value));
+                map[key] = new Java.Lang.String(value);
             }
             else
             {
                 var uuid = value; // capture
-                map.Put(key, new KotlinHookCallback(payload =>
+                map[key] = new KotlinHookCallback(payload =>
                 {
                     var fn = HooksRegistry.Get(uuid);
                     if (fn != null)
                     {
-                        // Fire and forget — run the C# callback asynchronously
                         Task.Run(() => fn(payload?.ToString() ?? "{}"));
                     }
-                }));
+                });
             }
         }
         return map;
@@ -60,4 +57,25 @@ public KotlinHookCallback(Action<Java.Lang.Object?> onHook)
         return null; // Kotlin Unit → null
     }
 }
+
+/// <summary>
+/// Wraps a C# Action as a Kotlin Function2&lt;Object, Object, Unit&gt; for
+/// result/error callbacks (GetIdentity, Debug, DebugTargeting).
+/// </summary>
+[Android.Runtime.Register("app/screeb/maui/KotlinResultCallback")]
+internal sealed class KotlinResultCallback : Java.Lang.Object, Kotlin.Jvm.Functions.IFunction2
+{
+    private readonly Action<Java.Lang.Object?, Java.Lang.Object?> _callback;
+
+    internal KotlinResultCallback(Action<Java.Lang.Object?, Java.Lang.Object?> callback)
+    {
+        _callback = callback;
+    }
+
+    public Java.Lang.Object? Invoke(Java.Lang.Object? p1, Java.Lang.Object? p2)
+    {
+        _callback(p1, p2);
+        return null; // Kotlin Unit → null
+    }
+}
 #endif
diff --git a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
index 01a6728..ea7b479 100644
--- a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
+++ b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
@@ -2,7 +2,6 @@
 #if ANDROID
 using Android.OS;
 using App.Screeb.Sdk;
-using Java.Util;
 
 namespace Screeb.Maui;
 
@@ -27,7 +26,7 @@ public static partial class Screeb
             try
             {
                 App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", "0.1.0");
-                var jProps = ToHashMap(ScreebUtils.FormatProperties(properties));
+                var jProps = ToJavaDictionary(ScreebUtils.FormatProperties(properties));
                 var jInitOptions = ToInitOptionsMap(initOptions);
                 var uuidMap = HooksRegistry.RegisterHooks(hooks);
                 _globalHookUuids = uuidMap.Values.ToList();
@@ -68,7 +67,7 @@ public static partial class Screeb
         {
             try
             {
-                App.Screeb.Sdk.Screeb.Instance.SetIdentity(userId, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                App.Screeb.Sdk.Screeb.Instance.SetIdentity(userId, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
                 tcs.SetResult(true);
             }
             catch (Exception ex) { tcs.SetException(ex); }
@@ -83,7 +82,7 @@ public static partial class Screeb
         {
             try
             {
-                var props = ToHashMap(ScreebUtils.FormatProperties(properties));
+                var props = ToJavaDictionary(ScreebUtils.FormatProperties(properties));
                 if (props != null) App.Screeb.Sdk.Screeb.Instance.SetVisitorProperties(props);
                 tcs.SetResult(true);
             }
@@ -108,11 +107,15 @@ public static partial class Screeb
         var tcs = new TaskCompletionSource<Dictionary<string, object>?>();
         new Handler(Looper.MainLooper!).Post(() =>
         {
-            App.Screeb.Sdk.Screeb.Instance.GetIdentity((identity, error) =>
+            try
             {
-                if (error != null) tcs.SetException(new Exception(error.Message));
-                else tcs.SetResult(FromHashMap(identity));
-            });
+                App.Screeb.Sdk.Screeb.Instance.GetIdentity(new KotlinResultCallback((identity, error) =>
+                {
+                    if (error != null) tcs.SetException(new Exception(error.ToString()));
+                    else tcs.SetResult(FromJavaObject(identity));
+                }));
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
     }
@@ -124,7 +127,7 @@ public static partial class Screeb
         {
             try
             {
-                App.Screeb.Sdk.Screeb.Instance.AssignGroup(groupType, groupName, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                App.Screeb.Sdk.Screeb.Instance.AssignGroup(groupType, groupName, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
                 tcs.SetResult(true);
             }
             catch (Exception ex) { tcs.SetException(ex); }
@@ -139,7 +142,7 @@ public static partial class Screeb
         {
             try
             {
-                App.Screeb.Sdk.Screeb.Instance.UnassignGroup(groupType, groupName, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                App.Screeb.Sdk.Screeb.Instance.UnassignGroup(groupType, groupName, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
                 tcs.SetResult(true);
             }
             catch (Exception ex) { tcs.SetException(ex); }
@@ -154,7 +157,7 @@ public static partial class Screeb
         {
             try
             {
-                App.Screeb.Sdk.Screeb.Instance.TrackEvent(name, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                App.Screeb.Sdk.Screeb.Instance.TrackEvent(name, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
                 tcs.SetResult(true);
             }
             catch (Exception ex) { tcs.SetException(ex); }
@@ -169,7 +172,7 @@ public static partial class Screeb
         {
             try
             {
-                App.Screeb.Sdk.Screeb.Instance.TrackScreen(name, ToHashMap(ScreebUtils.FormatProperties(properties)));
+                App.Screeb.Sdk.Screeb.Instance.TrackScreen(name, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
                 tcs.SetResult(true);
             }
             catch (Exception ex) { tcs.SetException(ex); }
@@ -187,9 +190,9 @@ public static partial class Screeb
             try
             {
                 var jHooks = HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks));
-                // TODO: unregister survey hooks on close
+                // TODO: unregister survey hooks on close (v0.2.0)
                 App.Screeb.Sdk.Screeb.Instance.StartSurvey(
-                    surveyId, allowMultipleResponses, ToHashMap(ScreebUtils.FormatProperties(hiddenFields)),
+                    surveyId, allowMultipleResponses, ToJavaDictionary(ScreebUtils.FormatProperties(hiddenFields)),
                     ignoreSurveyStatus, jHooks, language, distributionId);
                 tcs.SetResult(true);
             }
@@ -219,9 +222,9 @@ public static partial class Screeb
             try
             {
                 var jHooks = HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks));
-                // TODO: unregister message hooks on close
+                // TODO: unregister message hooks on close (v0.2.0)
                 App.Screeb.Sdk.Screeb.Instance.StartMessage(
-                    messageId, allowMultipleResponses, ToHashMap(ScreebUtils.FormatProperties(hiddenFields)),
+                    messageId, allowMultipleResponses, ToJavaDictionary(ScreebUtils.FormatProperties(hiddenFields)),
                     ignoreMessageStatus, jHooks, language, distributionId);
                 tcs.SetResult(true);
             }
@@ -268,11 +271,15 @@ public static partial class Screeb
         var tcs = new TaskCompletionSource<string?>();
         new Handler(Looper.MainLooper!).Post(() =>
         {
-            App.Screeb.Sdk.Screeb.Instance.Debug((info, error) =>
+            try
             {
-                if (error != null) tcs.SetException(new Exception(error.Message));
-                else tcs.SetResult(info);
-            });
+                App.Screeb.Sdk.Screeb.Instance.Debug(new KotlinResultCallback((info, error) =>
+                {
+                    if (error != null) tcs.SetException(new Exception(error.ToString()));
+                    else tcs.SetResult(info?.ToString());
+                }));
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
     }
@@ -282,49 +289,56 @@ public static partial class Screeb
         var tcs = new TaskCompletionSource<string?>();
         new Handler(Looper.MainLooper!).Post(() =>
         {
-            App.Screeb.Sdk.Screeb.Instance.DebugTargeting((info, error) =>
+            try
             {
-                if (error != null) tcs.SetException(new Exception(error.Message));
-                else tcs.SetResult(info);
-            });
+                App.Screeb.Sdk.Screeb.Instance.DebugTargeting(new KotlinResultCallback((info, error) =>
+                {
+                    if (error != null) tcs.SetException(new Exception(error.ToString()));
+                    else tcs.SetResult(info?.ToString());
+                }));
+            }
+            catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
     }
 
     // --- Helpers ---
 
-    private static HashMap? ToHashMap(Dictionary<string, object>? dict)
+    private static IDictionary<string, Java.Lang.Object>? ToJavaDictionary(Dictionary<string, object>? dict)
     {
         if (dict == null) return null;
-        var map = new HashMap();
+        var map = new Dictionary<string, Java.Lang.Object>();
         foreach (var (k, v) in dict)
-            map.Put(k, v is string s ? new Java.Lang.String(s) :
-                       v is bool b ? Java.Lang.Boolean.ValueOf(b) :
-                       v is int i ? Java.Lang.Integer.ValueOf(i) :
-                       v is long l ? Java.Lang.Long.ValueOf(l) :
-                       v is double d ? Java.Lang.Double.ValueOf(d) :
-                       Java.Lang.Object.FromArray(new[] { v.ToString() }));
+            map[k] = v is string s ? new Java.Lang.String(s) :
+                       v is bool b ? Java.Lang.Boolean.ValueOf(b)! :
+                       v is int i ? Java.Lang.Integer.ValueOf(i)! :
+                       v is long l ? Java.Lang.Long.ValueOf(l)! :
+                       v is double d ? Java.Lang.Double.ValueOf(d)! :
+                       new Java.Lang.String(v.ToString() ?? "");
         return map;
     }
 
-    private static Dictionary<string, object>? FromHashMap(Java.Util.HashMap? map)
+    private static Dictionary<string, object>? FromJavaObject(Java.Lang.Object? obj)
     {
-        if (map == null) return null;
-        var result = new Dictionary<string, object>();
-        var entries = map.EntrySet();
-        if (entries == null) return result;
-        foreach (Java.Util.IMapEntry entry in entries)
-            result[entry.Key?.ToString() ?? ""] = entry.Value?.ToString() ?? "";
-        return result;
+        if (obj == null) return null;
+        if (obj is IDictionary<string, Java.Lang.Object> dict)
+        {
+            var result = new Dictionary<string, object>();
+            foreach (var (k, v) in dict)
+                result[k] = v?.ToString() ?? "";
+            return result;
+        }
+        return null;
     }
 
-    private static HashMap? ToInitOptionsMap(ScreebInitOptions? opts)
+    private static IDictionary<string, Java.Lang.Object>? ToInitOptionsMap(ScreebInitOptions? opts)
     {
         if (opts == null) return null;
-        var map = new HashMap();
-        map.Put("isDebugMode", Java.Lang.Boolean.ValueOf(opts.IsDebugMode));
-        map.Put("disableMirror", Java.Lang.Boolean.ValueOf(opts.DisableMirror));
-        return map;
+        return new Dictionary<string, Java.Lang.Object>
+        {
+            ["isDebugMode"] = Java.Lang.Boolean.ValueOf(opts.IsDebugMode)!,
+            ["disableMirror"] = Java.Lang.Boolean.ValueOf(opts.DisableMirror)!
+        };
     }
 }
 #endif

From ebcd3e02d0cc4f723bf539f303abcac075b7d4ca Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:45:44 +0200
Subject: [PATCH 07/21] =?UTF-8?q?fix(sdk-maui):=20fix=20iOS=20build=20?=
 =?UTF-8?q?=E2=80=94=20xcframework=20download,=20Content=E2=86=92None,=20b?=
 =?UTF-8?q?gen=20fixes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add XCFramework download step in CI (ci.yml, publish-maui.yml)
- Change <Content> to <None> for xcframework glob to avoid MSBuild
  processing binary framework files as build items (LocalDefiningProjectFullPath error)
- Add using System; and [BaseType(typeof(NSObject))] to ApiDefinitions.cs
- Add ScreebClassPtr.cs to provide missing class_ptr for bgen static class
- Replace MainThread.InvokeOnMainThread → NSRunLoop.Main.BeginInvokeOnMainThread
- Add NativeScreeb alias to resolve naming conflict in Screeb.iOS.cs
- Gitignore native/ios binaries (downloaded at build time)
---
 .github/workflows/ci.yml                      |  6 ++
 .github/workflows/publish-maui.yml            |  7 ++
 .gitignore                                    |  5 ++
 .../sdk-maui/Platforms/iOS/ApiDefinitions.cs  |  2 +
 packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs | 77 ++++++++++---------
 .../sdk-maui/Platforms/iOS/ScreebClassPtr.cs  | 13 ++++
 packages/sdk-maui/ScreebMaui.csproj           | 16 ++--
 7 files changed, 83 insertions(+), 43 deletions(-)
 create mode 100644 packages/sdk-maui/Platforms/iOS/ScreebClassPtr.cs

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index c403c0f..b48f607 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -46,6 +46,12 @@ jobs:
           dotnet-version: '9.0.x'
       - name: Install MAUI workloads
         run: dotnet workload install android ios
+      - name: Download Screeb iOS XCFramework
+        run: |
+          curl -sL https://github.com/ScreebApp/sdk-ios-public/releases/download/3.2.3/Screeb.zip -o /tmp/Screeb.zip
+          unzip -q /tmp/Screeb.zip -d /tmp/screeb_ios
+          mkdir -p packages/sdk-maui/native/ios
+          cp -r /tmp/screeb_ios/Screeb.xcframework packages/sdk-maui/native/ios/
       - name: Restore
         run: dotnet restore packages/sdk-maui/ScreebMaui.csproj
       - name: Build Android
diff --git a/.github/workflows/publish-maui.yml b/.github/workflows/publish-maui.yml
index 89c5c09..a29f365 100644
--- a/.github/workflows/publish-maui.yml
+++ b/.github/workflows/publish-maui.yml
@@ -18,6 +18,13 @@ jobs:
       - name: Install MAUI workloads
         run: dotnet workload install android ios
 
+      - name: Download Screeb iOS XCFramework
+        run: |
+          curl -sL https://github.com/ScreebApp/sdk-ios-public/releases/download/3.2.3/Screeb.zip -o /tmp/Screeb.zip
+          unzip -q /tmp/Screeb.zip -d /tmp/screeb_ios
+          mkdir -p packages/sdk-maui/native/ios
+          cp -r /tmp/screeb_ios/Screeb.xcframework packages/sdk-maui/native/ios/
+
       - name: Restore
         run: dotnet restore packages/sdk-maui/ScreebMaui.csproj
 
diff --git a/.gitignore b/.gitignore
index cae1ee9..1accf51 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,3 +30,8 @@ yarn-error.log*
 .config.env
 
 .vscode
+
+# MAUI SDK - native binaries (downloaded at build time)
+packages/sdk-maui/native/ios/Screeb.xcframework/
+packages/sdk-maui/native/ios/Screeb.zip
+packages/sdk-maui/native/ios/sdk-ios-public-*/
diff --git a/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
index e720352..7fcee24 100644
--- a/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
+++ b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
@@ -1,4 +1,5 @@
 // packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
+using System;
 using Foundation;
 using UIKit;
 using ObjCRuntime;
@@ -7,6 +8,7 @@ namespace Screeb.iOS.Binding;
 
 [Static]
 [DisableDefaultCtor]
+[BaseType(typeof(NSObject))]
 interface Screeb
 {
     [Static]
diff --git a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
index 823a5d7..8c2bd5d 100644
--- a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
+++ b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
@@ -1,6 +1,7 @@
 #if IOS
 using Foundation;
 using Screeb.iOS.Binding;
+using NativeScreeb = global::Screeb.iOS.Binding.Screeb;
 
 namespace Screeb.Maui;
 
@@ -11,19 +12,19 @@ public static partial class Screeb
         ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.SetSecondarySDK("maui", "0.1.0");
-                var ioOpts = new Screeb.iOS.Binding.InitOptions(NSDictionary.FromObjectsAndKeys(
+                NativeScreeb.SetSecondarySDK("maui", "0.1.0");
+                var ioOpts = new InitOptions(NSDictionary.FromObjectsAndKeys(
                     new object[] { 
                         NSNumber.FromBoolean(initOptions?.IsDebugMode ?? false), 
                         NSNumber.FromBoolean(initOptions?.DisableMirror ?? false) 
                     },
                     new object[] { "isDebugMode", "disableMirror" }));
                 var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
-                Screeb.iOS.Binding.Screeb.InitSdk(
+                NativeScreeb.InitSdk(
                     null, channelId, userId,
                     ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary(),
                     ioOpts, jHooks, language);
@@ -37,9 +38,9 @@ public static partial class Screeb
     public static partial Task<bool?> CloseSdk()
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try { Screeb.iOS.Binding.Screeb.CloseSdk(); tcs.SetResult(true); }
+            try { NativeScreeb.CloseSdk(); tcs.SetResult(true); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
@@ -48,11 +49,11 @@ public static partial class Screeb
     public static partial Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.SetIdentity(userId,
+                NativeScreeb.SetIdentity(userId,
                     ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
                 tcs.SetResult(true);
             }
@@ -64,11 +65,11 @@ public static partial class Screeb
     public static partial Task<bool?> SetProperties(Dictionary<string, object>? properties)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.VisitorProperty(
+                NativeScreeb.VisitorProperty(
                     ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
                 tcs.SetResult(true);
             }
@@ -80,9 +81,9 @@ public static partial class Screeb
     public static partial Task<bool?> ResetIdentity()
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try { Screeb.iOS.Binding.Screeb.ResetIdentity(); tcs.SetResult(true); }
+            try { NativeScreeb.ResetIdentity(); tcs.SetResult(true); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
@@ -91,11 +92,11 @@ public static partial class Screeb
     public static partial Task<Dictionary<string, object>?> GetIdentity()
     {
         var tcs = new TaskCompletionSource<Dictionary<string, object>?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.GetIdentity((identity, error) =>
+                NativeScreeb.GetIdentity((identity, error) =>
                 {
                     if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
                     else tcs.SetResult(FromNSDictionary(identity));
@@ -109,11 +110,11 @@ public static partial class Screeb
     public static partial Task<bool?> AssignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.AssignGroup(groupType, groupName,
+                NativeScreeb.AssignGroup(groupType, groupName,
                     ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
                 tcs.SetResult(true);
             }
@@ -125,11 +126,11 @@ public static partial class Screeb
     public static partial Task<bool?> UnassignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.UnassignGroup(groupType, groupName,
+                NativeScreeb.UnassignGroup(groupType, groupName,
                     ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
                 tcs.SetResult(true);
             }
@@ -141,11 +142,11 @@ public static partial class Screeb
     public static partial Task<bool?> TrackEvent(string name, Dictionary<string, object>? properties)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.TrackEvent(name,
+                NativeScreeb.TrackEvent(name,
                     ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
                 tcs.SetResult(true);
             }
@@ -157,11 +158,11 @@ public static partial class Screeb
     public static partial Task<bool?> TrackScreen(string name, Dictionary<string, object>? properties)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.TrackScreen(name,
+                NativeScreeb.TrackScreen(name,
                     ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
                 tcs.SetResult(true);
             }
@@ -175,12 +176,12 @@ public static partial class Screeb
         bool ignoreSurveyStatus, ScreebHooks? hooks, string? language, string? distributionId)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
                 var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
-                Screeb.iOS.Binding.Screeb.StartSurvey(
+                NativeScreeb.StartSurvey(
                     surveyId, allowMultipleResponses,
                     ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
                     ignoreSurveyStatus, jHooks, language, distributionId);
@@ -194,9 +195,9 @@ public static partial class Screeb
     public static partial Task<bool?> CloseSurvey(string? surveyId)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try { Screeb.iOS.Binding.Screeb.CloseSurvey(surveyId); tcs.SetResult(true); }
+            try { NativeScreeb.CloseSurvey(surveyId); tcs.SetResult(true); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
@@ -207,12 +208,12 @@ public static partial class Screeb
         bool ignoreMessageStatus, ScreebHooks? hooks, string? language, string? distributionId)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
                 var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
-                Screeb.iOS.Binding.Screeb.StartMessage(
+                NativeScreeb.StartMessage(
                     messageId, allowMultipleResponses,
                     ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
                     ignoreMessageStatus, jHooks, language, distributionId);
@@ -226,9 +227,9 @@ public static partial class Screeb
     public static partial Task<bool?> CloseMessage(string? messageId)
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try { Screeb.iOS.Binding.Screeb.CloseMessage(messageId); tcs.SetResult(true); }
+            try { NativeScreeb.CloseMessage(messageId); tcs.SetResult(true); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
@@ -237,9 +238,9 @@ public static partial class Screeb
     public static partial Task<bool?> SessionReplayStart()
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try { Screeb.iOS.Binding.Screeb.SessionReplayStart(); tcs.SetResult(true); }
+            try { NativeScreeb.SessionReplayStart(); tcs.SetResult(true); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
@@ -248,9 +249,9 @@ public static partial class Screeb
     public static partial Task<bool?> SessionReplayStop()
     {
         var tcs = new TaskCompletionSource<bool?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try { Screeb.iOS.Binding.Screeb.SessionReplayStop(); tcs.SetResult(true); }
+            try { NativeScreeb.SessionReplayStop(); tcs.SetResult(true); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
@@ -259,11 +260,11 @@ public static partial class Screeb
     public static partial Task<string?> Debug()
     {
         var tcs = new TaskCompletionSource<string?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.Debug((info, error) =>
+                NativeScreeb.Debug((info, error) =>
                 {
                     if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
                     else tcs.SetResult(info);
@@ -277,11 +278,11 @@ public static partial class Screeb
     public static partial Task<string?> DebugTargeting()
     {
         var tcs = new TaskCompletionSource<string?>();
-        MainThread.InvokeOnMainThread(() =>
+        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try
             {
-                Screeb.iOS.Binding.Screeb.DebugTargeting((info, error) =>
+                NativeScreeb.DebugTargeting((info, error) =>
                 {
                     if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
                     else tcs.SetResult(info);
diff --git a/packages/sdk-maui/Platforms/iOS/ScreebClassPtr.cs b/packages/sdk-maui/Platforms/iOS/ScreebClassPtr.cs
new file mode 100644
index 0000000..0165514
--- /dev/null
+++ b/packages/sdk-maui/Platforms/iOS/ScreebClassPtr.cs
@@ -0,0 +1,13 @@
+// packages/sdk-maui/Platforms/iOS/ScreebClassPtr.cs
+// Supplies the missing class_ptr for the bgen-generated static partial class.
+// bgen emits `static partial class Screeb` that references class_ptr but does
+// not initialize it for [Static] interfaces — we complete the partial here.
+using ObjCRuntime;
+
+namespace Screeb.iOS.Binding
+{
+    public static unsafe partial class Screeb
+    {
+        static readonly NativeHandle class_ptr = Class.GetHandle("Screeb");
+    }
+}
diff --git a/packages/sdk-maui/ScreebMaui.csproj b/packages/sdk-maui/ScreebMaui.csproj
index 6326a5a..d31a0c2 100644
--- a/packages/sdk-maui/ScreebMaui.csproj
+++ b/packages/sdk-maui/ScreebMaui.csproj
@@ -33,10 +33,16 @@
     <Compile Include="Platforms/Android/HooksAndroid.cs" />
   </ItemGroup>
 
+  <!-- iOS: activate bgen binding generation -->
+  <PropertyGroup Condition="$(TargetFramework.Contains('-ios'))">
+    <IsBindingProject>true</IsBindingProject>
+  </PropertyGroup>
+
   <!-- iOS platform files -->
   <ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
-    <Compile Include="Platforms/iOS/ApiDefinitions.cs" />
-    <Compile Include="Platforms/iOS/StructsAndEnums.cs" />
+    <ObjcBindingApiDefinition Include="Platforms/iOS/ApiDefinitions.cs" />
+    <ObjcBindingCoreSource Include="Platforms/iOS/StructsAndEnums.cs" />
+    <Compile Include="Platforms/iOS/ScreebClassPtr.cs" />
     <Compile Include="Platforms/iOS/Screeb.iOS.cs" />
     <Compile Include="Platforms/iOS/HooksIOS.cs" />
   </ItemGroup>
@@ -67,8 +73,8 @@
   <!-- NuGet: include README and native iOS framework -->
   <ItemGroup>
     <None Include="README.md" Pack="true" PackagePath="/" />
-    <Content Include="native/ios/Screeb.xcframework/**"
-             Pack="true"
-             PackagePath="runtimes/ios/native/" />
+    <None Include="native/ios/Screeb.xcframework/**"
+          Pack="true"
+          PackagePath="runtimes/ios/native/" />
   </ItemGroup>
 </Project>

From 8532d22739aee903b5013d9105c89af7b6fe3bd0 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:55:03 +0200
Subject: [PATCH 08/21] refactor(sdk-maui): extract OnMain helpers to eliminate
 TCS boilerplate

Replace 18x repeated TaskCompletionSource+dispatch+try/catch pattern with:
- OnMain(Action) -> Task<bool?> for simple fire-and-forget calls
- OnMain(Action<TCS<bool?>>) -> Task<bool?> for calls with custom result/cleanup
- OnMain<T>(Action<TCS<T?>>) where T : class -> Task<T?> for reference-type results

Android: 344 -> 184 lines (-46%)
iOS: 325 -> 166 lines (-49%)
---
 .../Platforms/Android/Screeb.Android.cs       | 338 +++++-------------
 packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs | 301 ++++------------
 2 files changed, 160 insertions(+), 479 deletions(-)

diff --git a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
index ea7b479..502dc7a 100644
--- a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
+++ b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
@@ -7,300 +7,141 @@ namespace Screeb.Maui;
 
 public static partial class Screeb
 {
-    private static Android.Content.Context AppContext =>
-        Android.App.Application.Context;
-
     private static IEnumerable<string>? _globalHookUuids;
 
-    public static partial async Task<bool?> InitSdk(
-        string channelId,
-        string? userId,
-        Dictionary<string, object>? properties,
-        ScreebHooks? hooks,
-        ScreebInitOptions? initOptions,
-        string? language)
+    // Dispatches body to the main thread; catches exceptions and forwards them to the returned Task.
+    private static Task<bool?> OnMain(Action<TaskCompletionSource<bool?>> body)
     {
         var tcs = new TaskCompletionSource<bool?>();
         new Handler(Looper.MainLooper!).Post(() =>
         {
-            try
-            {
-                App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", "0.1.0");
-                var jProps = ToJavaDictionary(ScreebUtils.FormatProperties(properties));
-                var jInitOptions = ToInitOptionsMap(initOptions);
-                var uuidMap = HooksRegistry.RegisterHooks(hooks);
-                _globalHookUuids = uuidMap.Values.ToList();
-                var jHooks = HooksAndroid.ToGlobalHooks(uuidMap);
-                App.Screeb.Sdk.Screeb.Instance.PluginInit(
-                    channelId, userId, jProps, jInitOptions, jHooks, language);
-                tcs.SetResult(true);
-            }
+            try { body(tcs); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
-        return await tcs.Task;
+        return tcs.Task;
     }
 
-    public static partial async Task<bool?> CloseSdk()
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
-            {
-                if (_globalHookUuids != null)
-                {
-                    HooksRegistry.Unregister(_globalHookUuids);
-                    _globalHookUuids = null;
-                }
-                App.Screeb.Sdk.Screeb.Instance.CloseSdk();
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    private static Task<bool?> OnMain(Action body) =>
+        OnMain(tcs => { body(); tcs.SetResult(true); });
 
-    public static partial async Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
+    private static Task<T?> OnMain<T>(Action<TaskCompletionSource<T?>> body) where T : class
     {
-        var tcs = new TaskCompletionSource<bool?>();
+        var tcs = new TaskCompletionSource<T?>();
         new Handler(Looper.MainLooper!).Post(() =>
         {
-            try
-            {
-                App.Screeb.Sdk.Screeb.Instance.SetIdentity(userId, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
-                tcs.SetResult(true);
-            }
+            try { body(tcs); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
-        return await tcs.Task;
+        return tcs.Task;
     }
 
-    public static partial async Task<bool?> SetProperties(Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
+    public static partial Task<bool?> InitSdk(
+        string channelId, string? userId, Dictionary<string, object>? properties,
+        ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
+        => OnMain(() =>
         {
-            try
-            {
-                var props = ToJavaDictionary(ScreebUtils.FormatProperties(properties));
-                if (props != null) App.Screeb.Sdk.Screeb.Instance.SetVisitorProperties(props);
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
+            App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", "0.1.0");
+            var uuidMap = HooksRegistry.RegisterHooks(hooks);
+            _globalHookUuids = uuidMap.Values.ToList();
+            App.Screeb.Sdk.Screeb.Instance.PluginInit(
+                channelId, userId,
+                ToJavaDictionary(ScreebUtils.FormatProperties(properties)),
+                ToInitOptionsMap(initOptions),
+                HooksAndroid.ToGlobalHooks(uuidMap),
+                language);
         });
-        return await tcs.Task;
-    }
 
-    public static partial async Task<bool?> ResetIdentity()
+    public static partial Task<bool?> CloseSdk() => OnMain(() =>
     {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
+        if (_globalHookUuids != null) { HooksRegistry.Unregister(_globalHookUuids); _globalHookUuids = null; }
+        App.Screeb.Sdk.Screeb.Instance.CloseSdk();
+    });
+
+    public static partial Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.SetIdentity(
+            userId, ToJavaDictionary(ScreebUtils.FormatProperties(properties))));
+
+    public static partial Task<bool?> SetProperties(Dictionary<string, object>? properties)
+        => OnMain(() =>
         {
-            try { App.Screeb.Sdk.Screeb.Instance.ResetIdentity(); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
+            var props = ToJavaDictionary(ScreebUtils.FormatProperties(properties));
+            if (props != null) App.Screeb.Sdk.Screeb.Instance.SetVisitorProperties(props);
         });
-        return await tcs.Task;
-    }
+
+    public static partial Task<bool?> ResetIdentity()
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.ResetIdentity());
 
     public static partial Task<Dictionary<string, object>?> GetIdentity()
-    {
-        var tcs = new TaskCompletionSource<Dictionary<string, object>?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
+        => OnMain<Dictionary<string, object>>(tcs =>
+            App.Screeb.Sdk.Screeb.Instance.GetIdentity(new KotlinResultCallback((identity, error) =>
             {
-                App.Screeb.Sdk.Screeb.Instance.GetIdentity(new KotlinResultCallback((identity, error) =>
-                {
-                    if (error != null) tcs.SetException(new Exception(error.ToString()));
-                    else tcs.SetResult(FromJavaObject(identity));
-                }));
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+                if (error != null) tcs.SetException(new Exception(error.ToString()));
+                else tcs.SetResult(FromJavaObject(identity));
+            })));
 
-    public static partial async Task<bool?> AssignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
-            {
-                App.Screeb.Sdk.Screeb.Instance.AssignGroup(groupType, groupName, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> AssignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.AssignGroup(
+            groupType, groupName, ToJavaDictionary(ScreebUtils.FormatProperties(properties))));
 
-    public static partial async Task<bool?> UnassignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
-            {
-                App.Screeb.Sdk.Screeb.Instance.UnassignGroup(groupType, groupName, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> UnassignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.UnassignGroup(
+            groupType, groupName, ToJavaDictionary(ScreebUtils.FormatProperties(properties))));
 
-    public static partial async Task<bool?> TrackEvent(string name, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
-            {
-                App.Screeb.Sdk.Screeb.Instance.TrackEvent(name, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> TrackEvent(string name, Dictionary<string, object>? properties)
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.TrackEvent(
+            name, ToJavaDictionary(ScreebUtils.FormatProperties(properties))));
 
-    public static partial async Task<bool?> TrackScreen(string name, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
-            {
-                App.Screeb.Sdk.Screeb.Instance.TrackScreen(name, ToJavaDictionary(ScreebUtils.FormatProperties(properties)));
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> TrackScreen(string name, Dictionary<string, object>? properties)
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.TrackScreen(
+            name, ToJavaDictionary(ScreebUtils.FormatProperties(properties))));
 
-    public static partial async Task<bool?> StartSurvey(
+    public static partial Task<bool?> StartSurvey(
         string surveyId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
         bool ignoreSurveyStatus, ScreebHooks? hooks, string? language, string? distributionId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
-            {
-                var jHooks = HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks));
-                // TODO: unregister survey hooks on close (v0.2.0)
-                App.Screeb.Sdk.Screeb.Instance.StartSurvey(
-                    surveyId, allowMultipleResponses, ToJavaDictionary(ScreebUtils.FormatProperties(hiddenFields)),
-                    ignoreSurveyStatus, jHooks, language, distributionId);
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.StartSurvey(
+            surveyId, allowMultipleResponses,
+            ToJavaDictionary(ScreebUtils.FormatProperties(hiddenFields)),
+            ignoreSurveyStatus,
+            HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks)),
+            language, distributionId));
 
-    public static partial async Task<bool?> CloseSurvey(string? surveyId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try { App.Screeb.Sdk.Screeb.Instance.CloseSurvey(surveyId); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> CloseSurvey(string? surveyId)
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.CloseSurvey(surveyId));
 
-    public static partial async Task<bool?> StartMessage(
+    public static partial Task<bool?> StartMessage(
         string messageId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
         bool ignoreMessageStatus, ScreebHooks? hooks, string? language, string? distributionId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
-            {
-                var jHooks = HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks));
-                // TODO: unregister message hooks on close (v0.2.0)
-                App.Screeb.Sdk.Screeb.Instance.StartMessage(
-                    messageId, allowMultipleResponses, ToJavaDictionary(ScreebUtils.FormatProperties(hiddenFields)),
-                    ignoreMessageStatus, jHooks, language, distributionId);
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.StartMessage(
+            messageId, allowMultipleResponses,
+            ToJavaDictionary(ScreebUtils.FormatProperties(hiddenFields)),
+            ignoreMessageStatus,
+            HooksAndroid.ToSurveyHooks(HooksRegistry.RegisterHooks(hooks)),
+            language, distributionId));
 
-    public static partial async Task<bool?> CloseMessage(string? messageId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try { App.Screeb.Sdk.Screeb.Instance.CloseMessage(messageId); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> CloseMessage(string? messageId)
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.CloseMessage(messageId));
 
-    public static partial async Task<bool?> SessionReplayStart()
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try { App.Screeb.Sdk.Screeb.Instance.SessionReplayStart(); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> SessionReplayStart()
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.SessionReplayStart());
 
-    public static partial async Task<bool?> SessionReplayStop()
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try { App.Screeb.Sdk.Screeb.Instance.SessionReplayStop(); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return await tcs.Task;
-    }
+    public static partial Task<bool?> SessionReplayStop()
+        => OnMain(() => App.Screeb.Sdk.Screeb.Instance.SessionReplayStop());
 
     public static partial Task<string?> Debug()
-    {
-        var tcs = new TaskCompletionSource<string?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
+        => OnMain<string>(tcs =>
+            App.Screeb.Sdk.Screeb.Instance.Debug(new KotlinResultCallback((info, error) =>
             {
-                App.Screeb.Sdk.Screeb.Instance.Debug(new KotlinResultCallback((info, error) =>
-                {
-                    if (error != null) tcs.SetException(new Exception(error.ToString()));
-                    else tcs.SetResult(info?.ToString());
-                }));
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+                if (error != null) tcs.SetException(new Exception(error.ToString()));
+                else tcs.SetResult(info?.ToString());
+            })));
 
     public static partial Task<string?> DebugTargeting()
-    {
-        var tcs = new TaskCompletionSource<string?>();
-        new Handler(Looper.MainLooper!).Post(() =>
-        {
-            try
+        => OnMain<string>(tcs =>
+            App.Screeb.Sdk.Screeb.Instance.DebugTargeting(new KotlinResultCallback((info, error) =>
             {
-                App.Screeb.Sdk.Screeb.Instance.DebugTargeting(new KotlinResultCallback((info, error) =>
-                {
-                    if (error != null) tcs.SetException(new Exception(error.ToString()));
-                    else tcs.SetResult(info?.ToString());
-                }));
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+                if (error != null) tcs.SetException(new Exception(error.ToString()));
+                else tcs.SetResult(info?.ToString());
+            })));
 
     // --- Helpers ---
 
@@ -324,8 +165,7 @@ public static partial class Screeb
         if (obj is IDictionary<string, Java.Lang.Object> dict)
         {
             var result = new Dictionary<string, object>();
-            foreach (var (k, v) in dict)
-                result[k] = v?.ToString() ?? "";
+            foreach (var (k, v) in dict) result[k] = v?.ToString() ?? "";
             return result;
         }
         return null;
diff --git a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
index 8c2bd5d..d3cb6eb 100644
--- a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
+++ b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
@@ -7,291 +7,132 @@ namespace Screeb.Maui;
 
 public static partial class Screeb
 {
-    public static partial Task<bool?> InitSdk(
-        string channelId, string? userId, Dictionary<string, object>? properties,
-        ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
+    // Dispatches body to the main thread; catches exceptions and forwards them to the returned Task.
+    private static Task<bool?> OnMain(Action<TaskCompletionSource<bool?>> body)
     {
         var tcs = new TaskCompletionSource<bool?>();
         NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try
-            {
-                NativeScreeb.SetSecondarySDK("maui", "0.1.0");
-                var ioOpts = new InitOptions(NSDictionary.FromObjectsAndKeys(
-                    new object[] { 
-                        NSNumber.FromBoolean(initOptions?.IsDebugMode ?? false), 
-                        NSNumber.FromBoolean(initOptions?.DisableMirror ?? false) 
-                    },
-                    new object[] { "isDebugMode", "disableMirror" }));
-                var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
-                NativeScreeb.InitSdk(
-                    null, channelId, userId,
-                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary(),
-                    ioOpts, jHooks, language);
-                tcs.SetResult(true);
-            }
+            try { body(tcs); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
     }
 
-    public static partial Task<bool?> CloseSdk()
+    private static Task<bool?> OnMain(Action body) =>
+        OnMain(tcs => { body(); tcs.SetResult(true); });
+
+    private static Task<T?> OnMain<T>(Action<TaskCompletionSource<T?>> body) where T : class
     {
-        var tcs = new TaskCompletionSource<bool?>();
+        var tcs = new TaskCompletionSource<T?>();
         NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
-            try { NativeScreeb.CloseSdk(); tcs.SetResult(true); }
+            try { body(tcs); }
             catch (Exception ex) { tcs.SetException(ex); }
         });
         return tcs.Task;
     }
 
-    public static partial Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
+    public static partial Task<bool?> InitSdk(
+        string channelId, string? userId, Dictionary<string, object>? properties,
+        ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
+        => OnMain(() =>
         {
-            try
-            {
-                NativeScreeb.SetIdentity(userId,
-                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
+            NativeScreeb.SetSecondarySDK("maui", "0.1.0");
+            NativeScreeb.InitSdk(null, channelId, userId,
+                ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary(),
+                new InitOptions(NSDictionary.FromObjectsAndKeys(
+                    new object[] { NSNumber.FromBoolean(initOptions?.IsDebugMode ?? false), NSNumber.FromBoolean(initOptions?.DisableMirror ?? false) },
+                    new object[] { "isDebugMode", "disableMirror" })),
+                HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks)),
+                language);
         });
-        return tcs.Task;
-    }
+
+    public static partial Task<bool?> CloseSdk()
+        => OnMain(() => NativeScreeb.CloseSdk());
+
+    public static partial Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
+        => OnMain(() => NativeScreeb.SetIdentity(
+            userId, ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary()));
 
     public static partial Task<bool?> SetProperties(Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
-            {
-                NativeScreeb.VisitorProperty(
-                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.VisitorProperty(
+            ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary()));
 
     public static partial Task<bool?> ResetIdentity()
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try { NativeScreeb.ResetIdentity(); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.ResetIdentity());
 
     public static partial Task<Dictionary<string, object>?> GetIdentity()
-    {
-        var tcs = new TaskCompletionSource<Dictionary<string, object>?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
+        => OnMain<Dictionary<string, object>>(tcs =>
+            NativeScreeb.GetIdentity((identity, error) =>
             {
-                NativeScreeb.GetIdentity((identity, error) =>
-                {
-                    if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
-                    else tcs.SetResult(FromNSDictionary(identity));
-                });
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+                if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
+                else tcs.SetResult(FromNSDictionary(identity));
+            }));
 
     public static partial Task<bool?> AssignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
-            {
-                NativeScreeb.AssignGroup(groupType, groupName,
-                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.AssignGroup(
+            groupType, groupName, ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary()));
 
     public static partial Task<bool?> UnassignGroup(string? groupType, string groupName, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
-            {
-                NativeScreeb.UnassignGroup(groupType, groupName,
-                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.UnassignGroup(
+            groupType, groupName, ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary()));
 
     public static partial Task<bool?> TrackEvent(string name, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
-            {
-                NativeScreeb.TrackEvent(name,
-                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.TrackEvent(
+            name, ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary()));
 
     public static partial Task<bool?> TrackScreen(string name, Dictionary<string, object>? properties)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
-            {
-                NativeScreeb.TrackScreen(name,
-                    ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary());
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.TrackScreen(
+            name, ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary()));
 
     public static partial Task<bool?> StartSurvey(
         string surveyId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
         bool ignoreSurveyStatus, ScreebHooks? hooks, string? language, string? distributionId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
-            {
-                var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
-                NativeScreeb.StartSurvey(
-                    surveyId, allowMultipleResponses,
-                    ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
-                    ignoreSurveyStatus, jHooks, language, distributionId);
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.StartSurvey(
+            surveyId, allowMultipleResponses,
+            ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
+            ignoreSurveyStatus,
+            HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks)),
+            language, distributionId));
 
     public static partial Task<bool?> CloseSurvey(string? surveyId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try { NativeScreeb.CloseSurvey(surveyId); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.CloseSurvey(surveyId));
 
     public static partial Task<bool?> StartMessage(
         string messageId, bool allowMultipleResponses, Dictionary<string, object>? hiddenFields,
         bool ignoreMessageStatus, ScreebHooks? hooks, string? language, string? distributionId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
-            {
-                var jHooks = HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks));
-                NativeScreeb.StartMessage(
-                    messageId, allowMultipleResponses,
-                    ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
-                    ignoreMessageStatus, jHooks, language, distributionId);
-                tcs.SetResult(true);
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.StartMessage(
+            messageId, allowMultipleResponses,
+            ToNSDictionary(ScreebUtils.FormatProperties(hiddenFields)) ?? new NSDictionary(),
+            ignoreMessageStatus,
+            HooksIOS.ToNSDictionary(HooksRegistry.RegisterHooks(hooks)),
+            language, distributionId));
 
     public static partial Task<bool?> CloseMessage(string? messageId)
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try { NativeScreeb.CloseMessage(messageId); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.CloseMessage(messageId));
 
     public static partial Task<bool?> SessionReplayStart()
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try { NativeScreeb.SessionReplayStart(); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.SessionReplayStart());
 
     public static partial Task<bool?> SessionReplayStop()
-    {
-        var tcs = new TaskCompletionSource<bool?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try { NativeScreeb.SessionReplayStop(); tcs.SetResult(true); }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+        => OnMain(() => NativeScreeb.SessionReplayStop());
 
     public static partial Task<string?> Debug()
-    {
-        var tcs = new TaskCompletionSource<string?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
+        => OnMain<string>(tcs =>
+            NativeScreeb.Debug((info, error) =>
             {
-                NativeScreeb.Debug((info, error) =>
-                {
-                    if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
-                    else tcs.SetResult(info);
-                });
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+                if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
+                else tcs.SetResult(info);
+            }));
 
     public static partial Task<string?> DebugTargeting()
-    {
-        var tcs = new TaskCompletionSource<string?>();
-        NSRunLoop.Main.BeginInvokeOnMainThread(() =>
-        {
-            try
+        => OnMain<string>(tcs =>
+            NativeScreeb.DebugTargeting((info, error) =>
             {
-                NativeScreeb.DebugTargeting((info, error) =>
-                {
-                    if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
-                    else tcs.SetResult(info);
-                });
-            }
-            catch (Exception ex) { tcs.SetException(ex); }
-        });
-        return tcs.Task;
-    }
+                if (error != null) tcs.SetException(new Exception(error.LocalizedDescription));
+                else tcs.SetResult(info);
+            }));
 
     // --- Helpers ---
 
@@ -308,7 +149,7 @@ public static partial class Screeb
                        v is int i ? NSNumber.FromInt32(i) :
                        v is long l ? NSNumber.FromInt64(l) :
                        v is double d ? NSNumber.FromDouble(d) :
-                       new NSString(v.ToString() ?? ""));
+                       (NSObject)new NSString(v.ToString() ?? ""));
         }
         return NSDictionary.FromObjectsAndKeys(values.ToArray(), keys.ToArray());
     }

From 3053efb74be29dafe8b181ad42888bb176df6361 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:55:48 +0200
Subject: [PATCH 09/21] ci(sdk-maui): download latest ios-public release
 instead of hardcoded version

---
 .github/workflows/ci.yml           | 3 ++-
 .github/workflows/publish-maui.yml | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index b48f607..6d0287a 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -48,7 +48,8 @@ jobs:
         run: dotnet workload install android ios
       - name: Download Screeb iOS XCFramework
         run: |
-          curl -sL https://github.com/ScreebApp/sdk-ios-public/releases/download/3.2.3/Screeb.zip -o /tmp/Screeb.zip
+          SCREEB_IOS_URL=$(curl -sL https://api.github.com/repos/ScreebApp/sdk-ios-public/releases/latest | python3 -c "import sys,json; print(next(a['browser_download_url'] for a in json.load(sys.stdin)['assets'] if a['name']=='Screeb.zip'))")
+          curl -sL "$SCREEB_IOS_URL" -o /tmp/Screeb.zip
           unzip -q /tmp/Screeb.zip -d /tmp/screeb_ios
           mkdir -p packages/sdk-maui/native/ios
           cp -r /tmp/screeb_ios/Screeb.xcframework packages/sdk-maui/native/ios/
diff --git a/.github/workflows/publish-maui.yml b/.github/workflows/publish-maui.yml
index a29f365..6edd3d1 100644
--- a/.github/workflows/publish-maui.yml
+++ b/.github/workflows/publish-maui.yml
@@ -20,7 +20,8 @@ jobs:
 
       - name: Download Screeb iOS XCFramework
         run: |
-          curl -sL https://github.com/ScreebApp/sdk-ios-public/releases/download/3.2.3/Screeb.zip -o /tmp/Screeb.zip
+          SCREEB_IOS_URL=$(curl -sL https://api.github.com/repos/ScreebApp/sdk-ios-public/releases/latest | python3 -c "import sys,json; print(next(a['browser_download_url'] for a in json.load(sys.stdin)['assets'] if a['name']=='Screeb.zip'))")
+          curl -sL "$SCREEB_IOS_URL" -o /tmp/Screeb.zip
           unzip -q /tmp/Screeb.zip -d /tmp/screeb_ios
           mkdir -p packages/sdk-maui/native/ios
           cp -r /tmp/screeb_ios/Screeb.xcframework packages/sdk-maui/native/ios/

From 1dab6586ee26188779875cc40b0b0927882df9ac Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:56:44 +0200
Subject: [PATCH 10/21] chore(sdk-maui): ignore build artifacts (bin/, obj/)

---
 .gitignore | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.gitignore b/.gitignore
index 1accf51..8ab0fe4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -35,3 +35,7 @@ yarn-error.log*
 packages/sdk-maui/native/ios/Screeb.xcframework/
 packages/sdk-maui/native/ios/Screeb.zip
 packages/sdk-maui/native/ios/sdk-ios-public-*/
+
+# .NET build artifacts
+packages/sdk-maui/bin/
+packages/sdk-maui/obj/

From 2cda7432221375887bedfe636fed3dabe07749b1 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 09:58:26 +0200
Subject: [PATCH 11/21] feat(sdk-maui): read sdk version dynamically from
 assembly

---
 packages/sdk-maui/Platforms/Android/Screeb.Android.cs | 2 +-
 packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs         | 2 +-
 packages/sdk-maui/Screeb.cs                           | 9 +++++++++
 3 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
index 502dc7a..2b4298d 100644
--- a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
+++ b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
@@ -40,7 +40,7 @@ public static partial class Screeb
         ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
         => OnMain(() =>
         {
-            App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", "0.1.0");
+            App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", SdkVersion);
             var uuidMap = HooksRegistry.RegisterHooks(hooks);
             _globalHookUuids = uuidMap.Values.ToList();
             App.Screeb.Sdk.Screeb.Instance.PluginInit(
diff --git a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
index d3cb6eb..214a54e 100644
--- a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
+++ b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
@@ -38,7 +38,7 @@ public static partial class Screeb
         ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
         => OnMain(() =>
         {
-            NativeScreeb.SetSecondarySDK("maui", "0.1.0");
+            NativeScreeb.SetSecondarySDK("maui", SdkVersion);
             NativeScreeb.InitSdk(null, channelId, userId,
                 ToNSDictionary(ScreebUtils.FormatProperties(properties)) ?? new NSDictionary(),
                 new InitOptions(NSDictionary.FromObjectsAndKeys(
diff --git a/packages/sdk-maui/Screeb.cs b/packages/sdk-maui/Screeb.cs
index 54dd751..66477a4 100644
--- a/packages/sdk-maui/Screeb.cs
+++ b/packages/sdk-maui/Screeb.cs
@@ -1,3 +1,5 @@
+using System.Reflection;
+
 namespace Screeb.Maui;
 
 /// <summary>
@@ -6,6 +8,13 @@ namespace Screeb.Maui;
 /// </summary>
 public static partial class Screeb
 {
+    internal static readonly string SdkVersion =
+        typeof(Screeb).Assembly
+            .GetCustomAttribute<AssemblyInformationalVersionAttribute>()
+            ?.InformationalVersion
+            ?.Split('+')[0]   // strip build metadata (e.g. "0.1.0+abc123" → "0.1.0")
+        ?? "0.0.0";
+
     /// <summary>
     /// Initialize the Screeb SDK. Must be called before any other method.
     /// </summary>

From a810bb3d3b7d181ea46aedd3dc3eb2b1f583ce11 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 10:03:21 +0200
Subject: [PATCH 12/21] fix(sdk-maui): hook cleanup on CloseSdk, static
 handler, RunContinuationsAsynchronously

---
 .../sdk-maui/Platforms/Android/Screeb.Android.cs  | 15 +++++++--------
 packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs     |  6 +++---
 packages/sdk-maui/ScreebHooks.cs                  | 14 +++++++++-----
 3 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
index 2b4298d..3840e94 100644
--- a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
+++ b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
@@ -7,13 +7,13 @@ namespace Screeb.Maui;
 
 public static partial class Screeb
 {
-    private static IEnumerable<string>? _globalHookUuids;
+    private static readonly Handler _mainHandler = new Handler(Looper.MainLooper!);
 
     // Dispatches body to the main thread; catches exceptions and forwards them to the returned Task.
     private static Task<bool?> OnMain(Action<TaskCompletionSource<bool?>> body)
     {
-        var tcs = new TaskCompletionSource<bool?>();
-        new Handler(Looper.MainLooper!).Post(() =>
+        var tcs = new TaskCompletionSource<bool?>(TaskCreationOptions.RunContinuationsAsynchronously);
+        _mainHandler.Post(() =>
         {
             try { body(tcs); }
             catch (Exception ex) { tcs.SetException(ex); }
@@ -26,8 +26,8 @@ public static partial class Screeb
 
     private static Task<T?> OnMain<T>(Action<TaskCompletionSource<T?>> body) where T : class
     {
-        var tcs = new TaskCompletionSource<T?>();
-        new Handler(Looper.MainLooper!).Post(() =>
+        var tcs = new TaskCompletionSource<T?>(TaskCreationOptions.RunContinuationsAsynchronously);
+        _mainHandler.Post(() =>
         {
             try { body(tcs); }
             catch (Exception ex) { tcs.SetException(ex); }
@@ -40,9 +40,8 @@ public static partial class Screeb
         ScreebHooks? hooks, ScreebInitOptions? initOptions, string? language)
         => OnMain(() =>
         {
-            App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", SdkVersion);
             var uuidMap = HooksRegistry.RegisterHooks(hooks);
-            _globalHookUuids = uuidMap.Values.ToList();
+            App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", SdkVersion);
             App.Screeb.Sdk.Screeb.Instance.PluginInit(
                 channelId, userId,
                 ToJavaDictionary(ScreebUtils.FormatProperties(properties)),
@@ -53,7 +52,7 @@ public static partial class Screeb
 
     public static partial Task<bool?> CloseSdk() => OnMain(() =>
     {
-        if (_globalHookUuids != null) { HooksRegistry.Unregister(_globalHookUuids); _globalHookUuids = null; }
+        HooksRegistry.UnregisterAll();
         App.Screeb.Sdk.Screeb.Instance.CloseSdk();
     });
 
diff --git a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
index 214a54e..7407e6f 100644
--- a/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
+++ b/packages/sdk-maui/Platforms/iOS/Screeb.iOS.cs
@@ -10,7 +10,7 @@ public static partial class Screeb
     // Dispatches body to the main thread; catches exceptions and forwards them to the returned Task.
     private static Task<bool?> OnMain(Action<TaskCompletionSource<bool?>> body)
     {
-        var tcs = new TaskCompletionSource<bool?>();
+        var tcs = new TaskCompletionSource<bool?>(TaskCreationOptions.RunContinuationsAsynchronously);
         NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try { body(tcs); }
@@ -24,7 +24,7 @@ public static partial class Screeb
 
     private static Task<T?> OnMain<T>(Action<TaskCompletionSource<T?>> body) where T : class
     {
-        var tcs = new TaskCompletionSource<T?>();
+        var tcs = new TaskCompletionSource<T?>(TaskCreationOptions.RunContinuationsAsynchronously);
         NSRunLoop.Main.BeginInvokeOnMainThread(() =>
         {
             try { body(tcs); }
@@ -49,7 +49,7 @@ public static partial class Screeb
         });
 
     public static partial Task<bool?> CloseSdk()
-        => OnMain(() => NativeScreeb.CloseSdk());
+        => OnMain(() => { HooksRegistry.UnregisterAll(); NativeScreeb.CloseSdk(); });
 
     public static partial Task<bool?> SetIdentity(string userId, Dictionary<string, object>? properties)
         => OnMain(() => NativeScreeb.SetIdentity(
diff --git a/packages/sdk-maui/ScreebHooks.cs b/packages/sdk-maui/ScreebHooks.cs
index 64101f8..1add8b7 100644
--- a/packages/sdk-maui/ScreebHooks.cs
+++ b/packages/sdk-maui/ScreebHooks.cs
@@ -2,7 +2,8 @@ namespace Screeb.Maui;
 
 public class ScreebHooks
 {
-    public string? Version { get; set; }
+    /// <summary>Hooks version identifier passed verbatim to the native SDK.</summary>
+    public required string Version { get; set; }
 
     /// <summary>
     /// Hook callbacks: key = hook name (e.g. "onSurveyShowed"),
@@ -38,13 +39,16 @@ internal static Dictionary<string, string> RegisterHooks(ScreebHooks? hooks)
     internal static Func<string, Task<object?>>? Get(string uuid)
         => _registry.TryGetValue(uuid, out var fn) ? fn : null;
 
-    /// <summary>
-    /// Removes registered callbacks by UUID. Call after SDK teardown or hook de-registration
-    /// to prevent unbounded memory growth across repeated InitSdk/StartSurvey calls.
-    /// </summary>
+    /// <summary>Removes registered callbacks by UUID.</summary>
     internal static void Unregister(IEnumerable<string> uuids)
     {
         foreach (var uuid in uuids)
             _registry.TryRemove(uuid, out _);
     }
+
+    /// <summary>
+    /// Removes all registered callbacks. Call on CloseSdk to prevent unbounded
+    /// memory growth across repeated InitSdk/StartSurvey/StartMessage calls.
+    /// </summary>
+    internal static void UnregisterAll() => _registry.Clear();
 }

From de5d40f150df21b30d756c8945be0d2c2b1ddf37 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 10:05:14 +0200
Subject: [PATCH 13/21] chore(example-maui): upgrade to net9.0, set channel ID

---
 examples/example-maui/MauiProgram.cs      | 2 +-
 examples/example-maui/example-maui.csproj | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/example-maui/MauiProgram.cs b/examples/example-maui/MauiProgram.cs
index 9d97526..b5a7663 100644
--- a/examples/example-maui/MauiProgram.cs
+++ b/examples/example-maui/MauiProgram.cs
@@ -14,7 +14,7 @@ public static MauiApp CreateMauiApp()
         Task.Run(async () =>
         {
             await Screeb.InitSdk(
-                channelId: "<YOUR_CHANNEL_ID>",
+                channelId: "0e2b609a-8dce-4695-a80f-966fbfa87a88",
                 userId: "maui-user-123",
                 properties: new Dictionary<string, object>
                 {
diff --git a/examples/example-maui/example-maui.csproj b/examples/example-maui/example-maui.csproj
index 24fb90f..d962128 100644
--- a/examples/example-maui/example-maui.csproj
+++ b/examples/example-maui/example-maui.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFrameworks>net8.0-android;net8.0-ios</TargetFrameworks>
+    <TargetFrameworks>net9.0-android;net9.0-ios</TargetFrameworks>
     <OutputType>Exe</OutputType>
     <RootNamespace>ExampleMaui</RootNamespace>
     <ApplicationId>app.screeb.example.maui</ApplicationId>

From be9646262b5c050e565d316c4a382cce4b5bd62c Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 10:10:47 +0200
Subject: [PATCH 14/21] chore(example-maui): ignore bin/obj, add Platforms, fix
 namespace

---
 .gitignore                                     |  2 ++
 examples/example-maui/MainPage.xaml.cs         | 18 +++++++++---------
 examples/example-maui/MauiProgram.cs           |  5 ++---
 .../Platforms/Android/MainActivity.cs          | 15 +++++++++++++++
 examples/example-maui/Platforms/iOS/Program.cs | 14 ++++++++++++++
 examples/example-maui/example-maui.csproj      | 15 +++++++++++++++
 6 files changed, 57 insertions(+), 12 deletions(-)
 create mode 100644 examples/example-maui/Platforms/Android/MainActivity.cs
 create mode 100644 examples/example-maui/Platforms/iOS/Program.cs

diff --git a/.gitignore b/.gitignore
index 8ab0fe4..2c00c19 100644
--- a/.gitignore
+++ b/.gitignore
@@ -39,3 +39,5 @@ packages/sdk-maui/native/ios/sdk-ios-public-*/
 # .NET build artifacts
 packages/sdk-maui/bin/
 packages/sdk-maui/obj/
+examples/example-maui/bin/
+examples/example-maui/obj/
diff --git a/examples/example-maui/MainPage.xaml.cs b/examples/example-maui/MainPage.xaml.cs
index 6cc4936..26c46db 100644
--- a/examples/example-maui/MainPage.xaml.cs
+++ b/examples/example-maui/MainPage.xaml.cs
@@ -1,4 +1,4 @@
-using Screeb.Maui;
+using static Screeb.Maui.Screeb;
 
 namespace ExampleMaui;
 
@@ -13,7 +13,7 @@ private async void OnTrackEventClicked(object sender, EventArgs e)
     {
         try
         {
-            await Screeb.TrackEvent("button_clicked", new Dictionary<string, object> { ["button"] = "track_event" });
+            await TrackEvent("button_clicked", new Dictionary<string, object> { ["button"] = "track_event" });
             StatusLabel.Text = "Event tracked ✓";
         }
         catch (Exception ex)
@@ -26,7 +26,7 @@ private async void OnTrackScreenClicked(object sender, EventArgs e)
     {
         try
         {
-            await Screeb.TrackScreen("MainPage");
+            await TrackScreen("MainPage");
             StatusLabel.Text = "Screen tracked ✓";
         }
         catch (Exception ex)
@@ -39,7 +39,7 @@ private async void OnSetIdentityClicked(object sender, EventArgs e)
     {
         try
         {
-            await Screeb.SetIdentity("maui-user-123", new Dictionary<string, object> { ["plan"] = "premium" });
+            await SetIdentity("maui-user-123", new Dictionary<string, object> { ["plan"] = "premium" });
             StatusLabel.Text = "Identity set ✓";
         }
         catch (Exception ex)
@@ -52,7 +52,7 @@ private async void OnResetIdentityClicked(object sender, EventArgs e)
     {
         try
         {
-            await Screeb.ResetIdentity();
+            await ResetIdentity();
             StatusLabel.Text = "Identity reset ✓";
         }
         catch (Exception ex)
@@ -65,7 +65,7 @@ private async void OnGetIdentityClicked(object sender, EventArgs e)
     {
         try
         {
-            var identity = await Screeb.GetIdentity();
+            var identity = await GetIdentity();
             StatusLabel.Text = $"Identity: {identity?.Count ?? 0} props";
         }
         catch (Exception ex)
@@ -78,7 +78,7 @@ private async void OnAssignGroupClicked(object sender, EventArgs e)
     {
         try
         {
-            await Screeb.AssignGroup("company", "Screeb", new Dictionary<string, object> { ["plan"] = "enterprise" });
+            await AssignGroup("company", "Screeb", new Dictionary<string, object> { ["plan"] = "enterprise" });
             StatusLabel.Text = "Group assigned ✓";
         }
         catch (Exception ex)
@@ -91,7 +91,7 @@ private async void OnStartSurveyClicked(object sender, EventArgs e)
     {
         try
         {
-            await Screeb.StartSurvey("<YOUR_SURVEY_ID>");
+            await StartSurvey("<YOUR_SURVEY_ID>");
             StatusLabel.Text = "Survey started ✓";
         }
         catch (Exception ex)
@@ -104,7 +104,7 @@ private async void OnStartMessageClicked(object sender, EventArgs e)
     {
         try
         {
-            await Screeb.StartMessage("<YOUR_MESSAGE_ID>");
+            await StartMessage("<YOUR_MESSAGE_ID>");
             StatusLabel.Text = "Message started ✓";
         }
         catch (Exception ex)
diff --git a/examples/example-maui/MauiProgram.cs b/examples/example-maui/MauiProgram.cs
index b5a7663..6dfdeb1 100644
--- a/examples/example-maui/MauiProgram.cs
+++ b/examples/example-maui/MauiProgram.cs
@@ -1,5 +1,5 @@
 using Microsoft.Extensions.Logging;
-using Screeb.Maui;
+using static Screeb.Maui.Screeb;
 
 namespace ExampleMaui;
 
@@ -10,10 +10,9 @@ public static MauiApp CreateMauiApp()
         var builder = MauiApp.CreateBuilder();
         builder.UseMauiApp<App>();
 
-        // Initialize Screeb — replace with your channel ID
         Task.Run(async () =>
         {
-            await Screeb.InitSdk(
+            await InitSdk(
                 channelId: "0e2b609a-8dce-4695-a80f-966fbfa87a88",
                 userId: "maui-user-123",
                 properties: new Dictionary<string, object>
diff --git a/examples/example-maui/Platforms/Android/MainActivity.cs b/examples/example-maui/Platforms/Android/MainActivity.cs
new file mode 100644
index 0000000..5ca2ccd
--- /dev/null
+++ b/examples/example-maui/Platforms/Android/MainActivity.cs
@@ -0,0 +1,15 @@
+using Android.App;
+using Android.Content.PM;
+
+namespace ExampleMaui;
+
+[Activity(
+    Theme = "@style/Maui.SplashTheme",
+    MainLauncher = true,
+    LaunchMode = LaunchMode.SingleTop,
+    ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation |
+                           ConfigChanges.UiMode | ConfigChanges.ScreenLayout |
+                           ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
+public class MainActivity : MauiAppCompatActivity
+{
+}
diff --git a/examples/example-maui/Platforms/iOS/Program.cs b/examples/example-maui/Platforms/iOS/Program.cs
new file mode 100644
index 0000000..a859462
--- /dev/null
+++ b/examples/example-maui/Platforms/iOS/Program.cs
@@ -0,0 +1,14 @@
+using UIKit;
+
+namespace ExampleMaui;
+
+public class Program
+{
+    static void Main(string[] args) =>
+        UIApplication.Main(args, null, typeof(AppDelegate));
+}
+
+public class AppDelegate : MauiUIApplicationDelegate
+{
+    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+}
diff --git a/examples/example-maui/example-maui.csproj b/examples/example-maui/example-maui.csproj
index d962128..cc784f9 100644
--- a/examples/example-maui/example-maui.csproj
+++ b/examples/example-maui/example-maui.csproj
@@ -10,7 +10,22 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <UseMaui>true</UseMaui>
   </PropertyGroup>
+
+  <!-- Exclude all platform files from default glob, include only for matching TFM -->
+  <ItemGroup>
+    <Compile Remove="Platforms/**/*.cs" />
+  </ItemGroup>
+  <ItemGroup Condition="$(TargetFramework.Contains('-android'))">
+    <Compile Include="Platforms/Android/**/*.cs" />
+  </ItemGroup>
+  <ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
+    <Compile Include="Platforms/iOS/**/*.cs" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="../../packages/sdk-maui/ScreebMaui.csproj" />
   </ItemGroup>
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="9.0.0" />
+  </ItemGroup>
 </Project>

From 5efbf5296bcee38539769bb2316d4acb5d878096 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 10:33:08 +0200
Subject: [PATCH 15/21] fix(example-maui): remove NavigationPage, move InitSdk
 to OnStart with isDebugMode

---
 examples/example-maui/App.xaml.cs    | 19 ++++++++++++++++++-
 examples/example-maui/MauiProgram.cs | 14 --------------
 2 files changed, 18 insertions(+), 15 deletions(-)

diff --git a/examples/example-maui/App.xaml.cs b/examples/example-maui/App.xaml.cs
index 2316923..dd7d14b 100644
--- a/examples/example-maui/App.xaml.cs
+++ b/examples/example-maui/App.xaml.cs
@@ -1,3 +1,5 @@
+using static Screeb.Maui.Screeb;
+
 namespace ExampleMaui;
 
 public partial class App : Application
@@ -5,6 +7,21 @@ public partial class App : Application
     public App()
     {
         InitializeComponent();
-        MainPage = new NavigationPage(new MainPage());
+        MainPage = new MainPage();
+    }
+
+    protected override async void OnStart()
+    {
+        base.OnStart();
+        await InitSdk(
+            channelId: "0e2b609a-8dce-4695-a80f-966fbfa87a88",
+            userId: "maui-user-123",
+            properties: new Dictionary<string, object>
+            {
+                ["platform"] = "maui",
+                ["plan"] = "free"
+            },
+            initOptions: new Screeb.Maui.ScreebInitOptions { IsDebugMode = true }
+        );
     }
 }
diff --git a/examples/example-maui/MauiProgram.cs b/examples/example-maui/MauiProgram.cs
index 6dfdeb1..baeff7e 100644
--- a/examples/example-maui/MauiProgram.cs
+++ b/examples/example-maui/MauiProgram.cs
@@ -1,5 +1,4 @@
 using Microsoft.Extensions.Logging;
-using static Screeb.Maui.Screeb;
 
 namespace ExampleMaui;
 
@@ -10,19 +9,6 @@ public static MauiApp CreateMauiApp()
         var builder = MauiApp.CreateBuilder();
         builder.UseMauiApp<App>();
 
-        Task.Run(async () =>
-        {
-            await InitSdk(
-                channelId: "0e2b609a-8dce-4695-a80f-966fbfa87a88",
-                userId: "maui-user-123",
-                properties: new Dictionary<string, object>
-                {
-                    ["platform"] = "maui",
-                    ["plan"] = "free"
-                }
-            );
-        });
-
 #if DEBUG
         builder.Logging.AddDebug();
 #endif

From 840a9ec29bc0ca39f1cf93e0df43153b906cbae9 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 10:36:53 +0200
Subject: [PATCH 16/21] fix(sdk-maui): update iOS binding selectors to match
 Swift @objcMembers WithXxx pattern

---
 .../sdk-maui/Platforms/iOS/ApiDefinitions.cs  | 36 +++++++++----------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
index 7fcee24..0d0ea29 100644
--- a/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
+++ b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
@@ -12,11 +12,11 @@ namespace Screeb.iOS.Binding;
 interface Screeb
 {
     [Static]
-    [Export("setSecondarySDK:version:")]
+    [Export("setSecondarySDKWithName:version:")]
     void SetSecondarySDK(string name, string version);
 
     [Static]
-    [Export("initSdk:channelId:identity:visitorProperty:initOptions:hooks:language:")]
+    [Export("initSdkWithContext:channelId:identity:visitorProperty:initOptions:hooks:language:")]
     void InitSdk(
         [NullAllowed] UIViewController context,
         string channelId,
@@ -31,11 +31,11 @@ void InitSdk(
     void CloseSdk();
 
     [Static]
-    [Export("setIdentity:visitorProperty:")]
+    [Export("setIdentityWithUniqueVisitorId:visitorProperty:")]
     void SetIdentity(string uniqueVisitorId, NSDictionary visitorProperty);
 
     [Static]
-    [Export("visitorProperty:")]
+    [Export("visitorPropertyWithVisitorProperty:")]
     void VisitorProperty(NSDictionary visitorProperty);
 
     [Static]
@@ -43,27 +43,27 @@ void InitSdk(
     void ResetIdentity();
 
     [Static]
-    [Export("getIdentity:")]
-    void GetIdentity(Action<NSDictionary?, NSError?> completion);
+    [Export("getIdentityWithCallback:")]
+    void GetIdentity(Action<NSDictionary?, NSError?> callback);
 
     [Static]
-    [Export("assignGroup:name:properties:")]
+    [Export("assignGroupWithType:name:properties:")]
     void AssignGroup([NullAllowed] string type, string name, NSDictionary properties);
 
     [Static]
-    [Export("unassignGroup:name:properties:")]
+    [Export("unassignGroupWithType:name:properties:")]
     void UnassignGroup([NullAllowed] string type, string name, NSDictionary properties);
 
     [Static]
-    [Export("trackEvent:trackingEventProperties:")]
+    [Export("trackEventWithName:trackingEventProperties:")]
     void TrackEvent(string name, NSDictionary trackingEventProperties);
 
     [Static]
-    [Export("trackScreen:trackingEventProperties:")]
+    [Export("trackScreenWithName:trackingEventProperties:")]
     void TrackScreen(string name, NSDictionary trackingEventProperties);
 
     [Static]
-    [Export("startSurvey:allowMultipleResponses:hiddenFields:ignoreSurveyStatus:hooks:language:distributionId:")]
+    [Export("startSurveyWithSurveyId:allowMultipleResponses:hiddenFields:ignoreSurveyStatus:hooks:language:distributionId:")]
     void StartSurvey(
         string surveyId,
         bool allowMultipleResponses,
@@ -74,11 +74,11 @@ void StartSurvey(
         [NullAllowed] string distributionId);
 
     [Static]
-    [Export("closeSurvey:")]
+    [Export("closeSurveyWithSurveyId:")]
     void CloseSurvey([NullAllowed] string surveyId);
 
     [Static]
-    [Export("startMessage:allowMultipleResponses:hiddenFields:ignoreMessageStatus:hooks:language:distributionId:")]
+    [Export("startMessageWithMessageId:allowMultipleResponses:hiddenFields:ignoreMessageStatus:hooks:language:distributionId:")]
     void StartMessage(
         string messageId,
         bool allowMultipleResponses,
@@ -89,7 +89,7 @@ void StartMessage(
         [NullAllowed] string distributionId);
 
     [Static]
-    [Export("closeMessage:")]
+    [Export("closeMessageWithMessageId:")]
     void CloseMessage([NullAllowed] string messageId);
 
     [Static]
@@ -101,12 +101,12 @@ void StartMessage(
     void SessionReplayStop();
 
     [Static]
-    [Export("debug:")]
-    void Debug(Action<string?, NSError?> completion);
+    [Export("debugWithCallback:")]
+    void Debug(Action<string?, NSError?> callback);
 
     [Static]
-    [Export("debugTargeting:")]
-    void DebugTargeting(Action<string?, NSError?> completion);
+    [Export("debugTargetingWithCallback:")]
+    void DebugTargeting(Action<string?, NSError?> callback);
 }
 
 [BaseType(typeof(NSObject))]

From 8b2e18c6fc05cddec1cd8c2d3efff61227834802 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 10:40:14 +0200
Subject: [PATCH 17/21] fix(sdk-maui): revert iOS binding selectors to stable
 explicit names

---
 .../sdk-maui/Platforms/iOS/ApiDefinitions.cs  | 36 +++++++++----------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
index 0d0ea29..7fcee24 100644
--- a/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
+++ b/packages/sdk-maui/Platforms/iOS/ApiDefinitions.cs
@@ -12,11 +12,11 @@ namespace Screeb.iOS.Binding;
 interface Screeb
 {
     [Static]
-    [Export("setSecondarySDKWithName:version:")]
+    [Export("setSecondarySDK:version:")]
     void SetSecondarySDK(string name, string version);
 
     [Static]
-    [Export("initSdkWithContext:channelId:identity:visitorProperty:initOptions:hooks:language:")]
+    [Export("initSdk:channelId:identity:visitorProperty:initOptions:hooks:language:")]
     void InitSdk(
         [NullAllowed] UIViewController context,
         string channelId,
@@ -31,11 +31,11 @@ void InitSdk(
     void CloseSdk();
 
     [Static]
-    [Export("setIdentityWithUniqueVisitorId:visitorProperty:")]
+    [Export("setIdentity:visitorProperty:")]
     void SetIdentity(string uniqueVisitorId, NSDictionary visitorProperty);
 
     [Static]
-    [Export("visitorPropertyWithVisitorProperty:")]
+    [Export("visitorProperty:")]
     void VisitorProperty(NSDictionary visitorProperty);
 
     [Static]
@@ -43,27 +43,27 @@ void InitSdk(
     void ResetIdentity();
 
     [Static]
-    [Export("getIdentityWithCallback:")]
-    void GetIdentity(Action<NSDictionary?, NSError?> callback);
+    [Export("getIdentity:")]
+    void GetIdentity(Action<NSDictionary?, NSError?> completion);
 
     [Static]
-    [Export("assignGroupWithType:name:properties:")]
+    [Export("assignGroup:name:properties:")]
     void AssignGroup([NullAllowed] string type, string name, NSDictionary properties);
 
     [Static]
-    [Export("unassignGroupWithType:name:properties:")]
+    [Export("unassignGroup:name:properties:")]
     void UnassignGroup([NullAllowed] string type, string name, NSDictionary properties);
 
     [Static]
-    [Export("trackEventWithName:trackingEventProperties:")]
+    [Export("trackEvent:trackingEventProperties:")]
     void TrackEvent(string name, NSDictionary trackingEventProperties);
 
     [Static]
-    [Export("trackScreenWithName:trackingEventProperties:")]
+    [Export("trackScreen:trackingEventProperties:")]
     void TrackScreen(string name, NSDictionary trackingEventProperties);
 
     [Static]
-    [Export("startSurveyWithSurveyId:allowMultipleResponses:hiddenFields:ignoreSurveyStatus:hooks:language:distributionId:")]
+    [Export("startSurvey:allowMultipleResponses:hiddenFields:ignoreSurveyStatus:hooks:language:distributionId:")]
     void StartSurvey(
         string surveyId,
         bool allowMultipleResponses,
@@ -74,11 +74,11 @@ void StartSurvey(
         [NullAllowed] string distributionId);
 
     [Static]
-    [Export("closeSurveyWithSurveyId:")]
+    [Export("closeSurvey:")]
     void CloseSurvey([NullAllowed] string surveyId);
 
     [Static]
-    [Export("startMessageWithMessageId:allowMultipleResponses:hiddenFields:ignoreMessageStatus:hooks:language:distributionId:")]
+    [Export("startMessage:allowMultipleResponses:hiddenFields:ignoreMessageStatus:hooks:language:distributionId:")]
     void StartMessage(
         string messageId,
         bool allowMultipleResponses,
@@ -89,7 +89,7 @@ void StartMessage(
         [NullAllowed] string distributionId);
 
     [Static]
-    [Export("closeMessageWithMessageId:")]
+    [Export("closeMessage:")]
     void CloseMessage([NullAllowed] string messageId);
 
     [Static]
@@ -101,12 +101,12 @@ void StartMessage(
     void SessionReplayStop();
 
     [Static]
-    [Export("debugWithCallback:")]
-    void Debug(Action<string?, NSError?> callback);
+    [Export("debug:")]
+    void Debug(Action<string?, NSError?> completion);
 
     [Static]
-    [Export("debugTargetingWithCallback:")]
-    void DebugTargeting(Action<string?, NSError?> callback);
+    [Export("debugTargeting:")]
+    void DebugTargeting(Action<string?, NSError?> completion);
 }
 
 [BaseType(typeof(NSObject))]

From ca02ebd379d4199e5c3104f890b9e2cfbd558d68 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 10:56:31 +0200
Subject: [PATCH 18/21] fix(example-maui): bump Android minSdk to 24, pin
 SavedState.Ktx to fix D8 duplicate class

---
 examples/example-maui/example-maui.csproj | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/examples/example-maui/example-maui.csproj b/examples/example-maui/example-maui.csproj
index cc784f9..2387674 100644
--- a/examples/example-maui/example-maui.csproj
+++ b/examples/example-maui/example-maui.csproj
@@ -9,6 +9,7 @@
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <UseMaui>true</UseMaui>
+    <SupportedOSPlatformVersion Condition="$(TargetFramework.Contains('-android'))">24.0</SupportedOSPlatformVersion>
   </PropertyGroup>
 
   <!-- Exclude all platform files from default glob, include only for matching TFM -->
@@ -28,4 +29,8 @@
   <ItemGroup>
     <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="9.0.0" />
   </ItemGroup>
+  <!-- Pin Android dependency versions to avoid duplicate class conflicts (D8/R8) -->
+  <ItemGroup Condition="$(TargetFramework.Contains('-android'))">
+    <PackageReference Include="Xamarin.AndroidX.SavedState.SavedState.Ktx" Version="1.4.0.2" />
+  </ItemGroup>
 </Project>

From 2b23aa82c86009c3e9034b4ab635c09a75cbeea9 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 11:07:57 +0200
Subject: [PATCH 19/21] fix(example-maui): fix Android grey screen + SDK init
 timing

- Switch InitSdk from PluginInit to InitSdk(Context, ...) so the
  SDK properly registers ActivityLifecycleCallbacks and can attach
  its WebView overlay to the active window (fixes 'null null' log)
- Move Android init from OnStart() to OnResume() with _sdkInitialized
  guard so init runs after the Activity window is ready
- Remove unused ToInitOptionsMap helper (replaced by native InitOptions)
- Add BackgroundColor=White to MainPage to prevent grey/black screen
---
 examples/example-maui/App.xaml.cs               |  8 ++++++--
 examples/example-maui/MainPage.xaml             |  3 ++-
 .../Platforms/Android/Screeb.Android.cs         | 17 ++++++-----------
 3 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/examples/example-maui/App.xaml.cs b/examples/example-maui/App.xaml.cs
index dd7d14b..5d07795 100644
--- a/examples/example-maui/App.xaml.cs
+++ b/examples/example-maui/App.xaml.cs
@@ -4,15 +4,19 @@ namespace ExampleMaui;
 
 public partial class App : Application
 {
+    private bool _sdkInitialized;
+
     public App()
     {
         InitializeComponent();
         MainPage = new MainPage();
     }
 
-    protected override async void OnStart()
+    protected override async void OnResume()
     {
-        base.OnStart();
+        base.OnResume();
+        if (_sdkInitialized) return;
+        _sdkInitialized = true;
         await InitSdk(
             channelId: "0e2b609a-8dce-4695-a80f-966fbfa87a88",
             userId: "maui-user-123",
diff --git a/examples/example-maui/MainPage.xaml b/examples/example-maui/MainPage.xaml
index 7a1dd9b..49d9be1 100644
--- a/examples/example-maui/MainPage.xaml
+++ b/examples/example-maui/MainPage.xaml
@@ -2,7 +2,8 @@
 <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
              x:Class="ExampleMaui.MainPage"
-             Title="Screeb MAUI Example">
+             Title="Screeb MAUI Example"
+             BackgroundColor="White">
     <ScrollView>
         <VerticalStackLayout Padding="20" Spacing="10">
             <Label Text="Screeb .NET MAUI SDK" FontSize="24" FontAttributes="Bold" HorizontalOptions="Center" />
diff --git a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
index 3840e94..aeb2cc5 100644
--- a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
+++ b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
@@ -42,10 +42,13 @@ public static partial class Screeb
         {
             var uuidMap = HooksRegistry.RegisterHooks(hooks);
             App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", SdkVersion);
-            App.Screeb.Sdk.Screeb.Instance.PluginInit(
+            App.Screeb.Sdk.Screeb.Instance.InitSdk(
+                Android.App.Application.Context,
                 channelId, userId,
                 ToJavaDictionary(ScreebUtils.FormatProperties(properties)),
-                ToInitOptionsMap(initOptions),
+                new App.Screeb.Sdk.InitOptions(
+                    initOptions?.IsDebugMode ?? false,
+                    initOptions?.DisableMirror ?? false),
                 HooksAndroid.ToGlobalHooks(uuidMap),
                 language);
         });
@@ -170,14 +173,6 @@ public static partial class Screeb
         return null;
     }
 
-    private static IDictionary<string, Java.Lang.Object>? ToInitOptionsMap(ScreebInitOptions? opts)
-    {
-        if (opts == null) return null;
-        return new Dictionary<string, Java.Lang.Object>
-        {
-            ["isDebugMode"] = Java.Lang.Boolean.ValueOf(opts.IsDebugMode)!,
-            ["disableMirror"] = Java.Lang.Boolean.ValueOf(opts.DisableMirror)!
-        };
-    }
+
 }
 #endif

From b07491cf5e37fded6d3ebf81acf68aed8baf6a7f Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 11:12:49 +0200
Subject: [PATCH 20/21] fix(example-maui): add MainApplication to bootstrap
 MAUI on Android

Without a MauiApplication subclass, the Android Application has no
MauiContext and MauiAppCompatActivity cannot bootstrap the rendering
pipeline, resulting in a grey/blank screen.

Also revert PluginInit (was incorrectly changed to InitSdk) and
restore ToInitOptionsMap helper. Revert OnResume back to OnStart.
---
 examples/example-maui/App.xaml.cs               |  8 ++------
 .../Platforms/Android/MainApplication.cs        | 15 +++++++++++++++
 .../Platforms/Android/Screeb.Android.cs         | 17 ++++++++++++-----
 3 files changed, 29 insertions(+), 11 deletions(-)
 create mode 100644 examples/example-maui/Platforms/Android/MainApplication.cs

diff --git a/examples/example-maui/App.xaml.cs b/examples/example-maui/App.xaml.cs
index 5d07795..dd7d14b 100644
--- a/examples/example-maui/App.xaml.cs
+++ b/examples/example-maui/App.xaml.cs
@@ -4,19 +4,15 @@ namespace ExampleMaui;
 
 public partial class App : Application
 {
-    private bool _sdkInitialized;
-
     public App()
     {
         InitializeComponent();
         MainPage = new MainPage();
     }
 
-    protected override async void OnResume()
+    protected override async void OnStart()
     {
-        base.OnResume();
-        if (_sdkInitialized) return;
-        _sdkInitialized = true;
+        base.OnStart();
         await InitSdk(
             channelId: "0e2b609a-8dce-4695-a80f-966fbfa87a88",
             userId: "maui-user-123",
diff --git a/examples/example-maui/Platforms/Android/MainApplication.cs b/examples/example-maui/Platforms/Android/MainApplication.cs
new file mode 100644
index 0000000..00ceb19
--- /dev/null
+++ b/examples/example-maui/Platforms/Android/MainApplication.cs
@@ -0,0 +1,15 @@
+using Android.App;
+using Android.Runtime;
+
+namespace ExampleMaui;
+
+[Application]
+public class MainApplication : MauiApplication
+{
+    public MainApplication(IntPtr handle, JniHandleOwnership ownership)
+        : base(handle, ownership)
+    {
+    }
+
+    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+}
diff --git a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
index aeb2cc5..f6877b1 100644
--- a/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
+++ b/packages/sdk-maui/Platforms/Android/Screeb.Android.cs
@@ -42,13 +42,10 @@ public static partial class Screeb
         {
             var uuidMap = HooksRegistry.RegisterHooks(hooks);
             App.Screeb.Sdk.Screeb.Instance.SetSecondarySDK("maui", SdkVersion);
-            App.Screeb.Sdk.Screeb.Instance.InitSdk(
-                Android.App.Application.Context,
+            App.Screeb.Sdk.Screeb.Instance.PluginInit(
                 channelId, userId,
                 ToJavaDictionary(ScreebUtils.FormatProperties(properties)),
-                new App.Screeb.Sdk.InitOptions(
-                    initOptions?.IsDebugMode ?? false,
-                    initOptions?.DisableMirror ?? false),
+                ToInitOptionsMap(initOptions),
                 HooksAndroid.ToGlobalHooks(uuidMap),
                 language);
         });
@@ -161,6 +158,16 @@ public static partial class Screeb
         return map;
     }
 
+    private static IDictionary<string, Java.Lang.Object>? ToInitOptionsMap(ScreebInitOptions? opts)
+    {
+        if (opts == null) return null;
+        return new Dictionary<string, Java.Lang.Object>
+        {
+            ["isDebugMode"] = Java.Lang.Boolean.ValueOf(opts.IsDebugMode)!,
+            ["disableMirror"] = Java.Lang.Boolean.ValueOf(opts.DisableMirror)!
+        };
+    }
+
     private static Dictionary<string, object>? FromJavaObject(Java.Lang.Object? obj)
     {
         if (obj == null) return null;

From 2d3276a420e1c8f27f5ac698ab13d85bf0a88508 Mon Sep 17 00:00:00 2001
From: Alex <alexisr245@gmail.com>
Date: Fri, 22 May 2026 14:30:21 +0200
Subject: [PATCH 21/21] docs(sdk-maui): update README with Android/iOS setup,
 full API reference
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add MainApplication.cs and minSdk 24 requirement for Android
- Add AppDelegate.cs requirement for iOS
- Show OnStart init pattern in App.xaml.cs
- Add ScreebInitOptions and ScreebHooks usage examples
- Add full API method reference table
- Fix example README: net8.0 → net9.0, MauiProgram.cs → App.xaml.cs
---
 examples/example-maui/README.md |  15 ++--
 packages/sdk-maui/README.md     | 126 +++++++++++++++++++++++++++++---
 2 files changed, 127 insertions(+), 14 deletions(-)

diff --git a/examples/example-maui/README.md b/examples/example-maui/README.md
index a7e1e4e..ef0ad1c 100644
--- a/examples/example-maui/README.md
+++ b/examples/example-maui/README.md
@@ -5,11 +5,16 @@ Example .NET MAUI app demonstrating the Screeb SDK.
 ## Run
 
 ```bash
-# Android
-dotnet build -t:Run -f net8.0-android
+# Android (API 24+)
+dotnet build -t:Run -f net9.0-android
 
-# iOS (macOS only)
-dotnet build -t:Run -f net8.0-ios
+# iOS (macOS only, iOS 14+)
+dotnet build -t:Run -f net9.0-ios
 ```
 
-Replace `<YOUR_CHANNEL_ID>` in `MauiProgram.cs` with your Screeb channel ID.
+The channel ID is configured in `App.xaml.cs`.
+
+## Notes
+
+- Android requires `Platforms/Android/MainApplication.cs` (already included) to bootstrap the MAUI runtime.
+- iOS requires the `Screeb.xcframework` binary in `packages/sdk-maui/native/ios/` (see SDK README for setup).
diff --git a/packages/sdk-maui/README.md b/packages/sdk-maui/README.md
index 2736592..b039f53 100644
--- a/packages/sdk-maui/README.md
+++ b/packages/sdk-maui/README.md
@@ -2,32 +2,140 @@
 
 .NET MAUI SDK for [Screeb](https://screeb.app) — Continuous Product Discovery.
 
+Supports **Android** (API 24+) and **iOS** (14.0+).
+
 ## Installation
 
 ```sh
 dotnet add package Screeb.Maui
 ```
 
+## Android Setup
+
+Add a `MainApplication.cs` under `Platforms/Android/` — this is required to bootstrap the MAUI runtime:
+
+```csharp
+using Android.App;
+using Android.Runtime;
+
+namespace YourApp;
+
+[Application]
+public class MainApplication : MauiApplication
+{
+    public MainApplication(IntPtr handle, JniHandleOwnership ownership)
+        : base(handle, ownership) { }
+
+    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+}
+```
+
+In your `.csproj`, set Android minimum SDK to 24:
+
+```xml
+<SupportedOSPlatformVersion Condition="$(TargetFramework.Contains('-android'))">24.0</SupportedOSPlatformVersion>
+```
+
+## iOS Setup
+
+Add a `AppDelegate.cs` under `Platforms/iOS/` if not already present:
+
+```csharp
+using Foundation;
+
+namespace YourApp;
+
+[Register("AppDelegate")]
+public class AppDelegate : MauiUIApplicationDelegate
+{
+    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
+}
+```
+
+The iOS SDK requires the `Screeb.xcframework` binary — see [Development Setup](#development-setup) below.
+
 ## Usage
 
+Call `InitSdk` in `App.xaml.cs` `OnStart`:
+
+```csharp
+using static Screeb.Maui.Screeb;
+
+public partial class App : Application
+{
+    public App()
+    {
+        InitializeComponent();
+        MainPage = new MainPage();
+    }
+
+    protected override async void OnStart()
+    {
+        base.OnStart();
+        await InitSdk(
+            channelId: "<YOUR_CHANNEL_ID>",
+            userId: "user-123",
+            properties: new Dictionary<string, object> { ["plan"] = "premium" },
+            initOptions: new ScreebInitOptions { IsDebugMode = true }
+        );
+    }
+}
+```
+
+### ScreebInitOptions
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `IsDebugMode` | `bool` | `false` | Enable verbose SDK logging |
+| `DisableMirror` | `bool` | `false` | Disable mirror/session replay |
+
+### ScreebHooks
+
+React to survey lifecycle events:
+
 ```csharp
-// In MauiProgram.cs or App.xaml.cs
-await Screeb.InitSdk(
-    channelId: "<YOUR_CHANNEL_ID>",
-    userId: "user-123",
-    properties: new Dictionary<string, object> { ["plan"] = "premium" }
-);
+var hooks = new ScreebHooks
+{
+    Version = "1.0.0",
+    Callbacks = new Dictionary<string, Func<string, Task<object?>>>
+    {
+        ["onSurveyShowed"] = async payload => { Console.WriteLine(payload); return null; },
+        ["onSurveyCompleted"] = async payload => { Console.WriteLine(payload); return null; }
+    }
+};
+await InitSdk(channelId: "<YOUR_CHANNEL_ID>", hooks: hooks);
 ```
 
+## API
+
+| Method | Description |
+|---|---|
+| `InitSdk(channelId, ...)` | Initialize the SDK |
+| `CloseSdk()` | Stop the SDK |
+| `SetIdentity(userId, properties)` | Identify the current user |
+| `SetProperties(properties)` | Update user properties |
+| `ResetIdentity()` | Reset user identity (e.g. on logout) |
+| `GetIdentity()` | Get current visitor identity |
+| `AssignGroup(type, name, properties)` | Add user to a group |
+| `UnassignGroup(type, name, properties)` | Remove user from a group |
+| `TrackEvent(name, properties)` | Track a custom event |
+| `TrackScreen(name, properties)` | Track a screen navigation |
+| `StartSurvey(surveyId, ...)` | Start a survey programmatically |
+| `CloseSurvey(surveyId)` | Close the current survey |
+| `StartMessage(messageId, ...)` | Start a message programmatically |
+| `CloseMessage(messageId)` | Close the current message |
+| `SessionReplayStart()` | Start session replay recording |
+| `SessionReplayStop()` | Stop session replay recording |
+| `Debug()` | Get SDK debug info |
+| `DebugTargeting()` | Get targeting debug info |
+
 ## Development Setup
 
 ### iOS XCFramework
 
-The iOS SDK is distributed as a binary XCFramework. Before building for iOS:
+The iOS SDK is distributed as a binary XCFramework (gitignored). Before building for iOS:
 
 1. Download the latest release from https://github.com/ScreebApp/sdk-ios-public/releases
 2. Extract `Screeb.xcframework` to `packages/sdk-maui/native/ios/Screeb.xcframework/`
 
-The XCFramework is excluded from git (binary, large file).
-
 See [full documentation](https://developers.screeb.app/sdk-maui/install).