Duxel.Windows.App 0.2.11-preview

Duxel

<p align="center"> <img src="logo.svg" alt="Duxel logo" width="615" /> </p>

Immediate-mode GUI framework for .NET 8, .NET 9, and .NET 10, using a Vulkan renderer with a Windows-native platform backend.

Current published package version: 0.2.11-preview

Supported package targets: net8.0, net9.0, net10.0. The file-based app (FBA) workflow still requires the .NET 10 SDK.

• 한국어 문서: README.ko.md
• Version history: docs/version-history.md · 한국어
• Duxel agent reference: docs/duxel-agent-reference.md · 한국어
• Extended title bar guide: docs/extended-title-bar-guide.md · 한국어

What it provides

• Immediate-mode widget API (UiImmediateContext) with UiScreen.Render(...) lifecycle.
• Vulkan backend with profile-based defaults (Display / Render) and configurable MSAA.
• Windows-native window/input backend (keyboard, mouse, wheel, IME, clipboard).
• Windows 11-style extended title bars with application tabs, native caption behavior, Snap Layout, system menus, DPI, and multi-monitor support.
• NativeAOT-friendly runtime patterns.
• UI DSL (.ui) parser/runtime and source-generator path.

Packages

For a regular .NET 8 Windows application, target net8.0-windows7.0 (or a later Windows TFM). Duxel package assemblies provide portable net8.0 assets, while the Windows TFM makes the platform requirement explicit to analyzers and consumers. FBA samples continue to use net10.0 because file-based apps require the .NET 10 SDK.

Quick start (FBA, Windows)

Create hello.cs:

#:property TargetFramework=net10.0
#:property platform=windows
#:package Duxel.$(platform).App@*-*

using Duxel.App;
using Duxel.Core;
using Duxel.Windows.App;

DuxelWindowsApp.Run(new DuxelAppOptions
{
    Window = new DuxelWindowOptions { Title = "Hello Duxel" },
    Screen = new HelloScreen()
});

public sealed class HelloScreen : UiScreen
{
    public override void Render(UiImmediateContext ui)
    {
        ui.BeginWindow("Hello");
        ui.Text("Hello, Duxel!");
        ui.EndWindow();
    }
}

Run:

dotnet run hello.cs

Featured FBA showcase

If you want to see Duxel beyond a hello-world window, start with these representative FBA samples:

• samples/fba/all_features.cs — the broad widget gallery with typography, layout, popup/context, input diagnostics, item state, multi-select, layers, drawing, image, and markdown showcase windows, now opening Markdown Studio on first launch instead of a blank surface.
• samples/fba/ui_mixed_stress.cs — a balanced multi-window showcase that fills the screen with controls, forms, long lists, data tables, text rendering, and a dense canvas stress area.
• samples/fba/Duxel_perf_test_fba.cs — a polygon stress-test sample with live controls for VSync, MSAA, cache toggles, polygon settings, and profile-oriented renderer checks.

Samples

• Project sample: samples/Duxel.Sample
  • dotnet run --project samples/Duxel.Sample/
• FBA samples: samples/fba/*.cs
  • dotnet run samples/fba/all_features.cs
  • ./run-fba.ps1 samples/fba/all_features.cs (local project reference; NativeAOT by default)
  • all_features.cs now opens Markdown Studio by default and still includes dedicated typography, layout, popup/context, input-query, item-status, multi-select, and layer/animation showcase windows.

DSL

Duxel supports declarative .ui files (indent-based tree) and runtime/state bindings.

• DSL reference: docs/ui-dsl.md · 한국어
• Agent reference: docs/duxel-agent-reference.md · 한국어
• Extended title bar: docs/extended-title-bar-guide.md · 한국어
• FBA getting started: docs/getting-started-fba.md · 한국어
• FBA reference guide: docs/fba-reference-guide.md · 한국어
• FBA sample catalog: docs/fba-run-samples.md · 한국어
• Custom widgets: docs/custom-widgets.md · 한국어
• Design notes (Korean): docs/design.ko.md
• Optimization policy (Korean): docs/optimization-policy.ko.md

Build

dotnet build Duxel.slnx -c Release

License

MIT