CsWebUi 2.5.0-beta.4.8

CS-WebUI

Build lightweight, cross-platform .NET desktop interfaces with HTML, CSS, and JavaScript. CsWebUi manages WebUI windows and callbacks so your application can use an installed browser or a supported WebView without taking on a native interop surface.

Install

dotnet add package CsWebUi --prerelease

CsWebUi targets .NET 10 and brings in CsWebUi.Native automatically. It is currently a prerelease package following the WebUI 2.5 beta ABI. Release packages include verified official WebUI native libraries for win-x64, linux-x64, linux-arm64, osx-x64, and osx-arm64.

Browser mode needs a supported installed browser. Embedded-WebView mode needs the platform runtime: WebView2 on Windows, WebKitGTK on Linux, or WebKit on macOS. To choose the browser executable, set CSWEBUI_BROWSER_PATH or call WebUiApplication.SetBrowserPath; WebUI itself reads no browser environment variable. When a window cannot be shown, WebUiShowException names the browser that was tried and why it failed.

First window

using CsWebUi;

using var window = new WebUiWindow();

window.Bind("multiply", static e =>
    WebUiResult.FromInt64(e.GetInt64() * e.GetInt64(1)));

window.Show("""
    <!doctype html>
    <script src="webui.js"></script>
    <button onclick="multiply(6, 7).then(alert)">Multiply</button>
    """);

WebUiApplication.Wait();

WebUiWindow.Dispose() destroys the native window after active managed callbacks finish. Use BindAsync when a JavaScript call needs an asynchronous ValueTask<WebUiResult> response. After WebUiApplication.Exit() or Clean(), WebUI no longer waits for pending asynchronous replies, and CS-WebUI discards any that complete later.

Choose this package

Use CsWebUi for application code. It is the ergonomic layer for windows, events, callbacks, JavaScript evaluation, browser and server configuration, custom file responses, browser selection, event blocking, frameless or transparent WebViews, custom browser parameters, and in-memory icons. Use CsWebUi.Native only when you need direct, unsafe access to the full WebUI C ABI.

For Windows win-x64 NativeAOT publishing, set CsWebUiStaticLink to true alongside PublishAot; static linking is opt-in and bypasses dynamic native library overrides. For all other deployments, the normal bundled native asset is used. To load a custom native library, call CsWebUi.Native.WebUiNativeLibrary.SetLibraryPath before the first WebUI call, or set CSWEBUI_NATIVE_LIBRARY.

Learn and get help

• Repository documentation
• Basic callback example
• High-level API example
• WebUI documentation
• Report an issue or request support

CS-WebUI is MIT licensed. See the license and WebUI notices for bundled-component terms.