Fluent-Qt

Fluent controls for Qt Widgets

Native C++17 controls that keep your existing signals, slots, layouts, and project structure.

C++17 Qt 5.15+ / 6.2+ MIT

Open the online Gallery Setup guide

The Web Gallery needs no Qt installation.

Python / PySide6 Use the same controls from Python through PySide6 pip install FluentQt Gallery
Fluent-Qt Gallery home on Windows with Mica, 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

GET STARTED

Get started with Fluent-Qt

Open the online Gallery, or go straight to the C++ or Python setup guide.

01 Online Gallery

Search controls, switch themes, and interact with the C++ WebAssembly examples.

Open Gallery 02 C++ / Qt Widgets

Copy the CMake setup and follow the minimal example for an existing Qt Widgets project.

Read the C++ guide 03 Python / PySide6

Install FluentQt from PyPI and use the same controls through PySide6.

View installation

03 / GUI SKILL

Build desktop GUIs with AI

  • ProjectC++ / PySide6 application structure
  • UIFluent components, themes, and color
  • Fast previewSee saved changes in Live Scene, then check the compiled C++ sample
  • ChecksLight / Dark, narrow layouts, and interaction
Open the Skill Docs How it works
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

04 / POSITIONING

Native controls C++ APIs

Each control has its own C++ API, states, and layout behavior

  1. 01

    Native Qt Widgets usage

    Uses signals, slots, layouts, and the event loop

  2. 02

    One API for Qt 5 and Qt 6

    Application code does not need separate call sites for each major Qt version

  3. 03

    CMake integration

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

05 / COMPONENTS

Controls by purpose

A selection from Gallery

Button control page in Fluent-Qt Gallery on Windows with Mica
01

BASIC INPUT

Button

Includes default, accent, disabled, and icon states

SplitButtonComboBoxCheckBox
Collections page in Fluent-Qt Gallery on Windows with Mica
02 / COLLECTIONSListView · GridView · TreeView
Navigation and window UI in Fluent-Qt Gallery on Windows with Mica
03 / SHELLNavigation · Windowing
Browse the full API catalog
FoundationTheme · Typography · FontIcon
Basic inputButton · ComboBox · ToggleSwitch
CollectionsListView · GridView · TreeView
Date & timeCalendarView · DatePicker · TimePicker
Dialogs & flyoutsContentDialog · Flyout · TeachingTip
LayoutCard · Accordion · Expander
Menus & toolbarsMenu · MenuBar · CommandBar
NavigationNavigationView · TabView · Breadcrumb
ScrollingScrollView · PipsPager · AnnotatedScrollBar
Status & infoInfoBar · ProgressRing · Toast
Text fieldsLineEdit · PasswordBox · AutoSuggestBox
WindowingWindow · TitleBar · WindowBackdrop

06 / QUICK START

Quick start

Place this after add_executable(my_app ...). See hello_world for a complete project.

  • Keep the Widgets project and event loop you already have
  • The library target depends only on Qt Widgets
  • Use the same application-facing API with Qt 5 and Qt 6
Open the complete hello_world Python / PySide6 · pip install FluentQt Ask a question
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.8.5
  GIT_SHALLOW TRUE
)
FetchContent_MakeAvailable(fluentqt)

target_link_libraries(
  my_app PRIVATE FluentQt::FluentQt
)

07 / DOWNLOAD

Download Gallery

Desktop packages are for offline evaluation; integrate applications through CMake or PyPI.

Recommended for this device Download Gallery Windows · x64
Latest releaseLatest All versions and checksums
Windows x64 Windows ARM64 macOS x64 macOS ARM64 Linux x64 Linux ARM64
Optional compatibility Python / PySide6 python -m pip install FluentQt
FluentQt · PyPI Python Gallery