Avalonia Native Browser Stack

NativeWebView

NativeWebView gives Avalonia applications a consistent browser surface while staying on top of platform-native engines such as WebView2, WKWebView, WebKitGTK, mobile WebView, and browser host integrations. It supports embedded hosting, GPU-surface rendering, offscreen composition, dialogs, authentication broker flows, diagnostics, and ship-ready NuGet packaging.

Start Getting Started Explore Render Modes Browse API GitHub Repository

Start Here

Getting Started Overview

Understand package roles, backend registration, diagnostics, and the main integration path.

 Installation

Pick the correct platform packages, optional facades, and startup validation flow.

 Quickstart

Create the control in XAML, initialize it, switch render modes, and navigate.

 Sample Feature Explorer

Run the desktop sample that exercises webview, dialog, auth, rendering, and diagnostics.

Documentation Sections

Controls and Facades

NativeWebView, NativeWebDialog, and WebAuthenticationBroker usage, capabilities, and events.

 Rendering and Interop

Embedded, GPU-surface, offscreen, environment options, and native handle access.

 Platforms

Windows, macOS, Linux, iOS, Android, and Browser backend notes with registration snippets.

 Diagnostics and Operations

Runtime readiness, report generation, CI gates, release validation, and troubleshooting data.

 Reference

Package layout, platform support matrix, docs pipeline, and licensing.

 API Documentation

Generated .NET API pages for the core control, facades, abstractions, and platform packages.

Highlights

  • Native engine integration instead of shipping a bundled Chromium runtime.
  • Three render strategies: Embedded, GpuSurface, and Offscreen.
  • Desktop dialog hosting and cross-platform authentication broker abstraction.
  • Diagnostics and CI gate tooling for readiness, regressions, and release baselines.
  • Native-handle interop for advanced host integrations.

Repository