English | 简体中文
A cross-platform Fluent-style C++ UI component library for Qt Widgets.
| Scope | Dependencies |
|---|---|
| FluentQt library | C++17, CMake 3.16+, Qt Widgets |
| Gallery | FluentQt, Qt Network, spdlog/fmt |
| Tests | FluentQt, Qt Test/Network, GTest, spdlog/fmt |
| Integration | CMake |
|---|---|
FetchContent integration |
FetchContent_MakeAvailable(fluentqt) |
| Source integration | add_subdirectory(Fluent-Qt) |
| Installed package integration | find_package(FluentQt CONFIG REQUIRED) |
cmake_minimum_required(VERSION 3.16)
project(my_app LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
include(FetchContent)
FetchContent_Declare(
fluentqt
GIT_REPOSITORY https://github.com/calvinhxx/Fluent-Qt.git
GIT_TAG v1.5.3
GIT_SHALLOW TRUE
)
FetchContent_MakeAvailable(fluentqt)
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE FluentQt::FluentQt)Place the Fluent-Qt source in the project's Fluent-Qt directory:
cmake_minimum_required(VERSION 3.16)
project(my_app LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_subdirectory(Fluent-Qt)
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE FluentQt::FluentQt)cmake_minimum_required(VERSION 3.16)
project(my_app LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(FluentQt CONFIG REQUIRED)
add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE FluentQt::FluentQt)If FluentQt is outside the system search path, configure with -DCMAKE_PREFIX_PATH=/path/to/fluentqt.
main.cpp:
#include <FluentQt/FluentQt.h>
#include <QApplication>
#include <QString>
int main(int argc, char* argv[])
{
fluent::prepareHighDpiApplication();
QApplication app(argc, argv);
fluent::initializeResources();
fluent::basicinput::Button button(QStringLiteral("Hello FluentQt"));
button.show();
return app.exec();
}FluentQt follows the operating system display scale through Qt. Keep application geometry in device-independent coordinates and do not add a second app-level multiplier.
See examples/hello_world for the complete project, or run the fluentqt_hello_world target directly from an IDE.
cmake -S . -B build/fluentqt \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_PREFIX_PATH=/path/to/Qt
cmake --build build/fluentqt --config Release --target FluentQt --parallel
cmake --install build/fluentqt --config Release \
--component Development --prefix /path/to/installCreate the reduced library source package for offline or source integration:
cmake --build build/fluentqt --target fluent_qt_source_packageGallery is used to browse, demonstrate, and validate FluentQt components.
Download the Gallery for the required platform, Qt version, and architecture from GitHub Releases:
| Platform | Qt 5 / x64 | Qt 6 / x64 | Qt 6 / ARM64 | Format |
|---|---|---|---|---|
| Windows | 5.15.2 | 6.2.4 | 6.9.3 | .exe |
| macOS | 5.15.2 | 6.9.3 | 6.9.3 | .dmg |
| Linux | 5.15 | 6.2.4 | 6.2.4 | .deb |
| Platform | x64 preset | ARM64 preset |
|---|---|---|
| Windows | vcpkg-windows |
vcpkg-windows-arm64 |
| macOS | vcpkg-osx-x64 |
vcpkg-osx |
| Linux | vcpkg-linux |
vcpkg-linux-arm64 |
Replace PRESET with a value from the table:
cmake --preset PRESET
cmake --build --preset PRESET --target fluent_qt_gallery --parallel| Platform | x64 packaging preset | ARM64 packaging preset | Format |
|---|---|---|---|
| Windows | vcpkg-windows-installer |
vcpkg-windows-arm64-installer |
.exe |
| macOS | vcpkg-osx-x64-dmg |
vcpkg-osx-dmg |
.dmg |
| Linux | vcpkg-linux-deb |
vcpkg-linux-arm64-deb |
.deb |
See the Packaging Workflow for exact local packaging commands.
- Development workflow
- Testing and visual review
- Packaging workflow
- Release governance
- Architecture contracts
- Design language references
| Entry | Purpose |
|---|---|
| Windows UI Kit (Community) | Fluent / Windows visual reference |
| macOS 27 UI Kit (Community) | macOS style reference |
| Material 3 Design Kit (Community) | Material 3 style reference |
| WinUI Gallery | Component behavior and sample page reference |
Fluent-Qt's own source code is released under the MIT License. Bundled assets and packaged runtime dependencies retain their upstream terms; versions, provenance, source-availability rules, and license locations are listed in THIRD_PARTY_NOTICES.md. Product names, logos, and external design references are addressed in TRADEMARKS.md.