Fluent-Qt

A Fluent UI component library for Qt Widgets

Build cross-platform desktop apps with input, navigation and data display components, built-in theming and smooth animations.

C++17 Qt 5.15+ / 6.2+ MIT

Open the online Gallery Setup guide

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

01 / 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

02 / GALLERY

Gallery examples

This Gallery runs in your browser and does not need a local Qt setup. Project integration still requires Qt 5.15+ or 6.2+.

Start the live Gallery

01
Search
Locate a page by control name
02
Verify
Switch Light, Dark, High Contrast, and motion levels
03
Open an example
Expand the corresponding C++ code

Starts automatically when you reach this section

Select “Load now” to start it earlier.

Open in a new page

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

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 / 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.9.3
  GIT_SHALLOW TRUE
)
FetchContent_MakeAvailable(fluentqt)

target_link_libraries(
  my_app PRIVATE FluentQt::FluentQt
)

05 / SPATIAL · OPTIONAL 3D EXTENSION

Familiar widgets. A new dimension.

Place an existing QWidget composition in SpatialView to add perspective, rotation, and depth. Ordinary 2D apps do not need to enable it.

Keep your widgets
Keep layouts, signals, slots, and models. SpatialItem controls the pose of the whole widget composition.
Compose in depth. Refresh on demand.
OpenGL on desktop, WebGL in WebAssembly. Unchanged content reuses its textures.
Opt in. Keep the 2D path.
Link FluentQt::Spatial in C++, or use the optional Python binding. Gallery falls back to 2D when acceleration is unavailable.

Read the Spatial integration guide ↗ Try it in Gallery →

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

Run the actual SpatialView

Two cards, live charts, and camera controls from the same C++ Gallery sample. Qt / WASM loads only when you start it.

Real Qt Widgets / WebGL. Adjust the camera sliders and move the pointer across the scene to explore depth.

06 / POSITIONING

Native controls C++ APIs

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

01

Native Qt Widgets usage

Uses signals, slots, layouts, and the event loop
02

One API for Qt 5 and Qt 6

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

CMake integration

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

07 / COMPONENTS

Controls by purpose

A selection from Gallery

BASIC INPUT

Button

Includes default, accent, disabled, and icon states

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

08 / DOWNLOAD

Download Gallery

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

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