Platform guides
HuxerUI shares one C++ application, DSL, state model, layout engine, interaction system, semantic tree, and paint scene. Platform adapters own lifecycle, scheduling, native input, text services, file and network transports, window integration, and scene rendering.
Status language
Section titled “Status language”- Supported: the pinned HuxerUI revision contains a repository-owned backend implementation.
- Limited: an implementation exists with a material platform or composition restriction described in the platform guide.
- Platform API: an explicit integration header exists, but the application or embedding code must supply the producer/factory.
- Not exposed: the pinned revision does not expose that backend capability.
- Not validated here: the website build did not run that native backend; this is verification status, not a claim that its implementation is absent.
Capability matrix
Section titled “Capability matrix”| Capability | Windows | macOS | Linux | Web | Android | iOS |
|---|---|---|---|---|---|---|
| Render scene and text | Supported | Supported | Supported | Supported | Supported | Supported |
| Pointer, keyboard, and text input | Supported | Supported | Supported through X11/XIM | Supported through DOM input | Supported through View/JNI | Supported through UIKit/UITextInput |
| Accessibility bridge | Supported through UI Automation | Supported through AppKit accessibility | Not exposed | Not exposed; canvas is hidden from the DOM accessibility tree | Supported through an accessibility node provider | Supported through UIKit accessibility |
| Application files | Supported | Supported | Supported | Limited to browser storage/capability rules | Supported | Supported |
| File picker | Supported | Supported | Limited to an available desktop portal | Limited to browser picker capabilities | Supported | Supported |
| HTTP | Supported | Supported | Supported | Limited by browser origin/CORS policy | Supported | Supported |
| PlatformView | Limited HWND child composition | Platform API for NSView |
Not exposed | Platform API for DOM objects | Platform API for Android Views | Platform API for UIView |
| PlatformModule | Shared C++ registry | Shared C++ registry | Shared C++ registry | Shared C++ registry | Shared registry plus JNI factory API | Shared C++ registry |
| ExternalTexture | Platform API for copied RGBA/BGRA frames | Platform API for CVPixelBufferRef |
Platform API for copied RGBA/BGRA frames | Platform API for browser video frames | Platform API for Android Bitmap frames | Platform API for CVPixelBufferRef |
| Window and system UI | System/custom desktop chrome | AppKit window integration | X11 window integration | Browser viewport only | Safe area, edge-to-edge, and system bars | Safe area, edge-to-edge, and system bars |
| Typed URL/history routing | Application-defined navigation only | Application-defined navigation only | Application-defined navigation only | Supported by BrowserNavigationStack |
Application-defined navigation only | Application-defined navigation only |
| Activation and lifecycle | Supported | Supported | Supported | Supported through location/visibility events | Supported | Supported |
The matrix reports code present in the pinned revision, not a release certification statement. This website validates the shared public contracts and all listed Web examples; native device, X11, and Apple runtime behavior still requires the matching host toolchain and target environment.
Choose a platform guide
Section titled “Choose a platform guide”| Platform | Application shell | Native integration focus |
|---|---|---|
| Windows | CMake and MSVC executable | Win32 windowing, HWND PlatformView limits, UI Automation, external frames |
| macOS | CMake/Xcode executable | AppKit, NSTextInputClient, accessibility, NSView integration |
| Linux | CMake X11 executable | Cairo/EGL presentation, XIM, desktop portal, current missing bridges |
| Web | Emscripten static application | Browser policy, URL history, DOM views, current accessibility limit |
| Android | Gradle library and app modules | Java/JNI host, accessibility, system UI, Android Views |
| iOS | CMake/Xcode application shell | UIKit, UITextInput, accessibility, safe areas, UIView integration |
Use huxerui setup <platform> to prepare a target and huxerui run <platform> for development.
The generated project owns platform metadata while its C++ src tree remains shared.