8000 GitHub - MrAhmedSayedAli/Fluent-Qt: Modern Fluent / WinUI-style Qt Widgets components and Gallery app for native C++ desktop applications. · GitHub
[go: up one dir, main page]

Skip to content

About

Modern Fluent / WinUI-style Qt Widgets components and Gallery app for native C++ desktop applications.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

405 Commits

Folders and files

Repository files navigation

English | 简体中文

Fluent-Qt logo

Fluent-Qt

A cross-platform Fluent-style C++ UI component library for Qt Widgets.

CI GitHub stars MIT License Platform Qt Widgets Qt C++17

Fluent-Qt Gallery preview

🧱 Dependencies

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

🚀 Quick Start

Integration

Integration CMake
FetchContent integration FetchContent_MakeAvailable(fluentqt)
Source integration add_subdirectory(Fluent-Qt)
Installed package integration find_package(FluentQt CONFIG REQUIRED)

FetchContent integration

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)

Source integration

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)

Installed package integration

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.

Minimal example

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.

🛠 Build

Library

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

Source package

Create the reduced library source package for offline or source integration:

cmake --build build/fluentqt --target fluent_qt_source_package

🖼 Gallery

Gallery is used to browse, demonstrate, and validate FluentQt components.

Release packages

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

Run locally

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

Package locally

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.

📚 Documentation

🔗 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

⭐ Star History

Fluent-Qt Star History Chart

License

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.

About

Modern Fluent / WinUI-style Qt Widgets components and Gallery app for native C++ desktop applications.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0