Fluent-Qt

A Fluent UI component library for Qt Widgets

Cross-platform controls for input, navigation, tables, and charts, with built-in themes and smooth animations.

C++17 Qt 5.15+ / 6.2+ MIT

Python / PySide6 Use the same controls from Python through PySide6 pip install FluentQt Gallery
Actual Fluent-Qt Gallery Home capture on Windows with 3D and Mica enabled, showing the control catalog and samples
UI runtime
Qt Widgets
Qt support
5.15+ / 6.2+
Toolchain
CMake + C++17
Platforms
Windows / macOS / Linux / Web

03 / CHECKBOX

Property preview

On supported component pages, adjust a real Qt widget, see the result, and copy the generated C++ or PySide6 code.

CheckBox property panel showing a checked box and its generated C++ code.

04 / GUI SKILL

Build desktop GUIs with AI

  • Project setupClean C++ or PySide6 app structure
  • UI & themingFluent controls, themes, and typography
  • Live previewPreview edits in Live Scene, then verify in the compiled C++ sample
  • UI checksCheck Light / Dark themes, narrow layouts, and accessibility
REFERENCE BUILD DeepSeek Desktop
C++ · FluentQt
Native DeepSeek Desktop reference UI built with build-fluentqt-gui

Task groups, run timeline, composer, and Light / Dark themes.

Independent FluentQt build; not an official DeepSeek app.

Upstream project

05 / QUICK START

Quick start

Add this CMake snippet to your project, or integrate via add_subdirectory or find_package.

  • Keep the Widgets project and event loop you already have
  • The core library depends only on Qt Widgets
  • Same API across Qt 5.15+ and Qt 6.2+
CMakeLists.txt
# Add Fluent-Qt to your existing project
include(FetchContent)

FetchContent_Declare(
  fluentqt
  GIT_REPOSITORY https://github.com/calvinhxx/Fluent-Qt.git
  GIT_TAG v1.12.1
  GIT_SHALLOW TRUE
)
FetchContent_MakeAvailable(fluentqt)

target_link_libraries(
  my_app PRIVATE FluentQt::FluentQt
)

06 / SPATIAL · OPTIONAL 3D EXTENSION

Spatial 3D perspective views

Place existing QWidget layouts inside SpatialView to add 3D perspective, rotation, and depth. Ordinary 2D apps do not need to enable it.

  • Keep your widgets

    Keep your layouts, signals, slots, and models while SpatialItem controls 3D position and tilt.

  • Hardware-accelerated, refreshed on demand

    OpenGL on desktop and WebGL in the browser; static content reuses cached textures.

  • Opt in. Keep the 2D path.

    If session activation or view creation fails, the app provides a QWidget layout.

Gallery: Settings → 3D Gallery, then Plugins → Spatial.

SpatialView · C++ / WebAssembly
Loading example…

Drag the sliders to adjust the camera and move the pointer to explore depth.

07 / QMLBRIDGE

Embed QML pages

Use QmlBridge to host QML pages inside Qt Widgets windows while sharing app models and the active Fluent theme.

Gallery: Plugins → QmlBridge → QmlView.

C++ snippet

if (view->setContextObject(
        "widgetInput", input)) {
    view->load(QUrl("qrc:/Page.qml"));
}

Page.qml

import QtQuick 2.15

Text {
    text: widgetInput.text
    color: fluentTheme.text
    font.family: fluentTheme.fontFamily
}
A QML text binding to a Widgets input field.

08 / POSITIONING

Dedicated controls, not just a stylesheet

Every control provides its own C++ and Python API, interaction states, and layout behavior.

  1. 01

    Standard Qt Widgets patterns

    Works with your existing signals, slots, layouts, and event loop.

  2. 02

    One API across Qt 5 and Qt 6

    Write application code once without version-specific branches.

  3. 03

    Clean CMake integration

    Include <FluentQt/FluentQt.h> and link FluentQt::FluentQt.

09 / DOWNLOAD

Download Gallery

Standalone desktop builds for browsing controls offline; integrate into your app via CMake or pip.

10 / SPONSOR · TOKEN FUND

Spare a few tokens?

Open source runs on love, caffeine, and an alarming amount of LLM context. Writing C++ costs the maintainer’s hairline; wrangling AI agents costs cold, hard tokens. If Fluent-Qt saved your UI from a late-night stylesheet meltdown, toss a few coins into the token furnace—every bit keeps the commits flowing.

Scan with WeChat Pay
The maintainer’s WeChat Pay collection QR code
Scan with Alipay
The maintainer’s Alipay collection QR code
Scan for Ko-fi
QR code for the maintainer’s Ko-fi page

Open on Ko-fi ↗

On your phone? Take a quick screenshot and load it from your payment app’s album scanner.

100% voluntary fuel for caffeine and tokens—no paid SLA or priority queue attached, just genuine gratitude. Support policy

Tip Fluent-Qt in USD on Ko-fi

PayPal and cards supported; press Esc to close, or Open on Ko-fi ↗