QWinUI3¶
Fluent / WinUI 3–inspired controls for Qt 6.5+ Quick (recommended 6.8 LTS; forward 6.10+).
This site is generated from QML source comments and shipped via GitHub Pages.
Start here¶
| Getting started | Paths A–E · qwinui3 init / doctor --fix (2.73) |
| Recipes hub | All LoB how-tos — also Gallery Recipes category |
| Docs IA v2 | 2.xx MkDocs regroup + hub mirror (2.46) |
| Developer diagnostics | FrameStats dev vs retail (2.44) |
| Experimental sweep | FL-004 badges + verdict matrix (2.45) |
| Stable API | What to rely on in 1.xx apps (promote/defer 1.37) |
| 1.xx maturity | Checkpoint verdict — harden-first (1.51) |
| 1.xx compatibility | Will-not-break Theme / shells / stable (1.40 / 1.51) |
| Upgrade notes | Consumer checklist + template (1.40) |
| Drag-drop & clipboard | FileDropZone / CopyButton / WindowHelper (1.41) |
| Adaptive layout | TwoPaneView / ListDetailsView breakpoints (1.42) |
| Color & contrast | AA diagnostics / Theme.contrastRatio (1.43) |
| Keyboard-first | Global chords → palette → dialogs → lists (1.44) |
| On-screen keyboard | Win11 OSK + app hardware (1.77); still experimental (1.78) |
| i18n / RTL | qsTr + zh_CN seed + LayoutMirroring (1.45) |
| Consumer packaging | Shared vs static / windeploy / strip (1.46) |
| Python / PySide6 / PyQt6 | Full Gallery from Python + shared kit (2.64) |
| Shell extras | Snap Layouts · taskbar · attention (1.47) |
| Dialogs & flyouts | ContentDialogQueue FIFO · Esc (1.48) |
| Component API | Full public + internal control index |
| Qt Creator | Open Gallery / examples (CMake only) |
| Roadmap | Small 1.xx slices |
Top recipes (also on the hub): Window shells · Navigation · Forms · Data collections · Feedback · System integration · Performance (cold start 1.39).
Platform note: Linux / Wayland edge cases (field failure matrix, 1.38).
Install / build¶
cmake --preset release # or use a Qt Creator Kit
cmake --build --preset release --target qwinui3_gallery
Shared libraries:
Python Gallery (PySide6 / PyQt6): packaging-python.md · python examples/python-gallery/main.py
Regenerate docs¶
Machine-readable catalog: components.json.
License¶
QWinUI3 is licensed under the Apache License 2.0 (Apache-2.0). See LICENSE, NOTICE, and licensing.md.
Qt itself remains LGPL-3.0 / commercial — Apache-2.0 on QWinUI3 does not relicense Qt.