Fluent-Qt

Qt Widgets용 Fluent UI 컴포넌트 라이브러리

입력, 내비게이션, 테이블, 차트 등 핵심 컨트롤과 기본 제공 테마, 부드러운 애니메이션으로 크로스 플랫폼 데스크톱 UI를 손쉽게 구축하세요.

C++17 Qt 5.15+ / 6.2+ MIT

Python / PySide6 PySide6를 통해 Python에서도 동일한 컨트롤을 사용할 수 있습니다 pip install FluentQt Gallery
3D 및 Mica가 활성화된 Windows 환경의 Fluent-Qt Gallery Home 실제 스크린샷으로, 컨트롤 카탈로그와 예제를 보여 줍니다
UI 런타임
Qt Widgets
Qt 지원
5.15+ / 6.2+
툴체인
CMake + C++17
지원 플랫폼
Windows / macOS / Linux / Web

03 / CHECKBOX

속성 미리 보기

지원되는 컴포넌트 페이지에서 실제 Qt 위젯의 속성을 조절해 보고 생성된 C++ 또는 PySide6 코드를 복사하세요.

체크된 CheckBox와 생성된 C++ 코드를 보여 주는 속성 패널.

04 / GUI SKILL

AI와 함께 데스크톱 GUI 구축

  • 프로젝트 구조깔끔한 C++ 또는 PySide6 앱 구조 생성
  • UI 및 테마 구성적합한 Fluent 컨트롤, 테마, 타이포그래피 적용
  • 실시간 미리 보기Live Scene에서 편집 내용을 먼저 보고 컴파일된 C++ 예제로 검증
  • UI 점검라이트/다크 테마, 좁은 창 레이아웃, 접근성 자동 점검
레퍼런스 구현 DeepSeek Desktop
C++ · FluentQt
build-fluentqt-gui로 구축한 DeepSeek Desktop 네이티브 참조 UI

작업 그룹, 실행 타임라인, 입력기 및 라이트 / 다크 테마.

FluentQt로 독립 구현한 예제이며 공식 DeepSeek 앱이 아닙니다.

원본 프로젝트

05 / QUICK START

빠른 시작

오른쪽 CMake 스니펫을 프로젝트에 추가하세요. add_subdirectory 및 find_package도 지원합니다.

  • 기존 Qt Widgets 프로젝트와 이벤트 루프 유지
  • 코어 라이브러리는 Qt Widgets에만 의존
  • Qt 5.15+ 및 Qt 6.2+에서 동일한 API
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 · 선택형 3D 확장

Spatial 3D 원근 뷰

기존 QWidget 레이아웃을 SpatialView에 배치해 3D 원근, 회전, 깊이감을 더하세요. 일반 2D 앱에서는 활성화할 필요가 없습니다.

  • 위젯을 다시 작성할 필요 없음

    기존 레이아웃, 시그널/슬롯, 모델을 그대로 두고 SpatialItem으로 3D 위치와 기울기만 제어합니다.

  • 하드웨어 가속 및 필요 시 갱신

    데스크톱에서는 OpenGL, 브라우저에서는 WebGL을 사용하며 정적인 화면은 캐시된 텍스처를 재사용합니다.

  • 선택적 사용 · 2D 경로 유지

    세션 시작이나 뷰 생성에 실패하면 앱이 일반 QWidget 레이아웃으로 자연스럽게 동작합니다.

Gallery: Settings → 3D Gallery를 켠 뒤 Plugins → Spatial을 여세요.

SpatialView · C++ / WebAssembly
예제를 불러오는 중…

슬라이더로 카메라를 조절하고 포인터를 움직여 깊이감을 확인하세요.

07 / QMLBRIDGE

QML 페이지 임베딩

QmlBridge를 사용하면 Qt Widgets 창 안에 QML 페이지를 호스팅하면서 앱 모델과 활성 Fluent 테마를 그대로 공유할 수 있습니다.

Gallery: Plugins → QmlBridge → QmlView.

C++ 스니펫

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
}
Widgets 입력 필드에 바인딩된 QML 텍스트 예제.

08 / POSITIONING

스타일시트가 아닌 전용 설계 컨트롤

모든 컨트롤은 고유한 C++ / Python API, 상호작용 상태, 레이아웃 동작을 제공합니다.

  1. 01

    표준 Qt Widgets 패턴

    기존 시그널/슬롯, 레이아웃, 이벤트 루프와 그대로 함께 작동합니다.

  2. 02

    Qt 5와 Qt 6의 단일 API

    버전별 분기 없이 하나의 애플리케이션 코드로 작성하세요.

  3. 03

    깔끔한 CMake 통합

    <FluentQt/FluentQt.h>를 포함하고 FluentQt::FluentQt를 링크하면 됩니다.

09 / DOWNLOAD

Gallery 다운로드

오프라인에서 컨트롤을 탐색할 수 있는 독립 실행형 데스크톱 빌드입니다. 프로젝트 통합은 CMake 또는 pip를 사용하세요.

10 / SPONSOR · 개발 후원

토큰 한 컵 보태실래요?

오픈소스는 애정과 카페인, 그리고 어마어마한 LLM 컨텍스트로 굴러갑니다. C++ 코드는 메인테이너의 집중력을 태우고, AI 에이전트는 토큰을 태웁니다. Fluent-Qt 덕분에 스타일시트 야근을 조금이라도 줄이셨다면 작은 응원을 보내 주세요.

WeChat Pay로 스캔
메인테이너의 WeChat Pay 수금 QR 코드
Alipay로 스캔
메인테이너의 Alipay 수금 QR 코드
Ko-fi QR 코드 스캔
메인테이너의 Ko-fi 페이지 QR 코드

Ko-fi에서 열기 ↗

모바일에서는 화면을 캡처한 뒤 결제 앱 앨범 스캐너에서 불러와 주세요.

100% 자발적인 후원이며 커피와 토큰 비용에 쓰입니다. 유료 SLA나 우선 지원은 제공되지 않습니다. 후원 안내

Ko-fi에서 Fluent-Qt 후원하기 (USD)

PayPal 및 카드 결제를 지원합니다. Esc 키로 닫거나 Ko-fi에서 열기 ↗