NativeWebHost 2.0.0

NativeWebHost

A .NET desktop WebView host focused on native OS shells.

NativeWebHost lets a .NET application host a web UI inside a native desktop window. The project now keeps one native path per operating system instead of carrying multiple UI-framework-specific shells.

Platform Strategy

Removed paths: NativeWebHost.WinForms, NativeWebHost.WebView2, and NativeWebHost.Cef. The Windows path is now raw Win32 plus WebView2Aot-based native WebView2, with no WinForms or WPF dependency.

The packaging goal is that end users do not install extra frameworks manually. Windows uses the OS WebView2 runtime or an app-packaged fixed WebView2 runtime. macOS uses system WebKit. Linux should package the needed GTK/WebKitGTK native libraries with the app image/package.

Quick Start

using NativeWebHost;
using NativeWebHost.Windows;

var app = NativeWebApp.CreateBuilder(args)
    .Configure(o =>
    {
        o.Title = "My App";
        o.CustomScheme = "app";
        o.ContentRootPath = Path.Combine(AppContext.BaseDirectory, "wwwroot");
        o.StartUrl = "app://localhost/index.html";
        o.Width = 1280;
        o.Height = 800;
    })
    .UseAdapter(new NativeWebView2AdapterFactory())
    .UseRuntime(new Win32Runtime())
    .Build();

await app.RunAsync();

NativeWebHost.Windows supports app://localhost/... local assets, JavaScript bridge injection, custom window chrome helpers, and built-in title-bar presets.

Linux uses the same app code shape with GtkRuntime and WebKitGtkAdapterFactory from NativeWebHost.Linux. See samples/NativeWebHost.Sample.CrossPlatform for the platform switch.

Features

• Native host windows with shared runtime/adapter abstractions
• nativeWeb.invoke(...) and nativeWeb.on(...) JavaScript bridge
• app://localhost/... local asset loading
• Multi-window startup and dynamic window management
• Splash windows
• Window style presets such as normal, frameless, DWM blur glass, and VS Code-style chrome where the OS runtime supports them
• ASP.NET Core, Blazor, Vue SPA, and static asset hosting examples

Documentation

License

MIT - see LICENSE.