# WUI — Window User Interface Library

WUI is an open-source C++17 GUI library with a compact API, flat control ownership, event callbacks, themes and localization.

- Website: https://libwui.org/main/
- Russian: https://libwui.org/main_ru/
- Repository: https://github.com/intent-garden/wui
- Documentation: https://libwui.org/doc/ and https://libwui.org/doc_ru/
- Live WebAssembly examples: https://libwui.org/main/#playground
- License: Boost Software License 1.0

## Platforms

Windows uses WinAPI and GDI/GDI+. Linux uses X11/XCB and Cairo. The experimental macOS backend uses AppKit and CoreGraphics. The experimental WebAssembly backend uses Emscripten, Canvas 2D and DOM events. Controls and application logic are shared C++.

WUI is a compiled library, not header-only. Platform development dependencies are required. It is not an official Boost library. Consult the repository's current build guides for supported toolchains and installation steps.

## Live examples

The site embeds the actual hello_world, simple and demo executables compiled to WASM. They support shared controls, editing, themes and dialogs. Browser settings are in memory and reset on reload. The browser backend is single-threaded, has no native tray, and does not yet provide a complete accessibility tree. Clipboard and IME behavior follow the browser port's documented limits.

## Integration

Use add_subdirectory(path/to/wui) and target_link_libraries(my_app PRIVATE wui), or start from the included examples. The examples include the themes and localization resources needed for a working application.