ATTENTION!

March 16, 2025 · View on GitHub

PLEASE USE THE BRAND NEW FluentUI Pro INSTEAD!

QML FluentUI

A Fluent Design component library for Qt QML, You need PySide6 PySide6-FluentUI-QML.

release-badge download-badge download-latest

This is a beautiful FluentUI component library based on Qt QML. Currently the main branch supports Qt 6. If you want to use it in Qt 5, checkout the Qt 5 branch.

Requirements

Qt Core, Qt Quick, Qt QML, Qt ShaderTool, Qt 5 Compatibility Module. (Essential)
Qt LinguistTool (optional,for translations)
Qt Svg (optional, however essential for Qt 5)

Use Qt Online Installers to acquire the modules (Recommended) or compile them first before using the library.

⚽ Get started

Download the pre-built release. (Please specify your platform and compilers.)
run example program.

Clone the repository.

git clone --recursive https://github.com/zhuzichu520/FluentUI.git

Build

git clone --recursive https://github.com/zhuzichu520/FluentUI.git
cd FluentUI
mkdir build
cd build
cmake -DCMAKE_PREFIX_PATH=<YOUR_QT_SDK_DIR_PATH> -DCMAKE_BUILD_TYPE=Release -GNinja <PATH_TO_THE_REPOSITORY>
cmake --build . --config Release --target all --parallel

Use your IDE (Qt Creator or CLion) to open the project. (only CMake supported).

Compile the project. Then try to execute the example demo program.
Great! Now you are ready to write your first QML FluentUI program! Check the documentations for more details.

📑 Documentations

(Work in progress...🚀)

Supported components

Catalog	Detail	Notes / Demos
FluApp	The initial entry of the program	Router supported(SPA)
FluWindow	Frameless Window	*This only works on windows
FluAppBar	Title bar on top of the window	Drag, minimize, maximize and close are supported.
FluText	Common text
FluButton	Common button
FluFilledButton	Filled button
FluTextButton	Text button
FluToggleButton	Toggle buttons
FluIcon	Common icon
FluRadioButton	radio button
FluTextBox	Single-line input box
FluMultiLineTextBox	Multi-lines input area
FluToggleSwitch	toggle switch