# 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
)
- UI 런타임
- Qt Widgets
- Qt 지원
- 5.15+ / 6.2+
- 툴체인
- CMake + C++17
- 지원 플랫폼
- Windows / macOS / Linux / Web
01 / 시작하기
Fluent-Qt 시작하기
브라우저에서 Gallery를 바로 체험하거나 C++ / Python 설치 가이드로 이동하세요.
02 / GALLERY
Gallery 예제
로컬 Qt 설치 없이 브라우저에서 바로 실행됩니다(프로젝트 통합에는 Qt 5.15+ 또는 6.2+ 필요).
- 01검색
컨트롤 이름으로 페이지 빠르게 찾기
- 02테마 전환
라이트, 다크, 고대비 및 애니메이션 모드 미리 보기
- 03예제 코드
C++와 Python 코드 전환 보기
03 / CHECKBOX
속성 미리 보기
지원되는 컴포넌트 페이지에서 실제 Qt 위젯의 속성을 조절해 보고 생성된 C++ 또는 PySide6 코드를 복사하세요.
04 / GUI SKILL
AI와 함께 데스크톱 GUI 구축
- 프로젝트 구조깔끔한 C++ 또는 PySide6 앱 구조 생성
- UI 및 테마 구성적합한 Fluent 컨트롤, 테마, 타이포그래피 적용
- 실시간 미리 보기Live Scene에서 편집 내용을 먼저 보고 컴파일된 C++ 예제로 검증
- UI 점검라이트/다크 테마, 좁은 창 레이아웃, 접근성 자동 점검
작업 그룹, 실행 타임라인, 입력기 및 라이트 / 다크 테마.
FluentQt로 독립 구현한 예제이며 공식 DeepSeek 앱이 아닙니다.
원본 프로젝트05 / QUICK START
빠른 시작
오른쪽 CMake 스니펫을 프로젝트에 추가하세요. add_subdirectory 및 find_package도 지원합니다.
- 기존 Qt Widgets 프로젝트와 이벤트 루프 유지
- 코어 라이브러리는 Qt Widgets에만 의존
- Qt 5.15+ 및 Qt 6.2+에서 동일한 API
06 / SPATIAL · 선택형 3D 확장
Spatial 3D 원근 뷰
기존 QWidget 레이아웃을 SpatialView에 배치해 3D 원근, 회전, 깊이감을 더하세요. 일반 2D 앱에서는 활성화할 필요가 없습니다.
- 위젯을 다시 작성할 필요 없음
기존 레이아웃, 시그널/슬롯, 모델을 그대로 두고 SpatialItem으로 3D 위치와 기울기만 제어합니다.
- 하드웨어 가속 및 필요 시 갱신
데스크톱에서는 OpenGL, 브라우저에서는 WebGL을 사용하며 정적인 화면은 캐시된 텍스처를 재사용합니다.
- 선택적 사용 · 2D 경로 유지
세션 시작이나 뷰 생성에 실패하면 앱이 일반 QWidget 레이아웃으로 자연스럽게 동작합니다.
Gallery: Settings → 3D Gallery를 켠 뒤 Plugins → Spatial을 여세요.
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
}
08 / POSITIONING
스타일시트가 아닌 전용 설계 컨트롤
모든 컨트롤은 고유한 C++ / Python API, 상호작용 상태, 레이아웃 동작을 제공합니다.
-
01
표준 Qt Widgets 패턴
기존 시그널/슬롯, 레이아웃, 이벤트 루프와 그대로 함께 작동합니다.
-
02
Qt 5와 Qt 6의 단일 API
버전별 분기 없이 하나의 애플리케이션 코드로 작성하세요.
-
03
깔끔한 CMake 통합
<FluentQt/FluentQt.h>를 포함하고 FluentQt::FluentQt를 링크하면 됩니다.
09 / DOWNLOAD
Gallery 다운로드
오프라인에서 컨트롤을 탐색할 수 있는 독립 실행형 데스크톱 빌드입니다. 프로젝트 통합은 CMake 또는 pip를 사용하세요.
python -m pip install FluentQt
10 / SPONSOR · 개발 후원
토큰 한 컵 보태실래요?
오픈소스는 애정과 카페인, 그리고 어마어마한 LLM 컨텍스트로 굴러갑니다. C++ 코드는 메인테이너의 집중력을 태우고, AI 에이전트는 토큰을 태웁니다. Fluent-Qt 덕분에 스타일시트 야근을 조금이라도 줄이셨다면 작은 응원을 보내 주세요.
온라인 후원 · USD (US$5 이상)
QR 코드를 불러오는 중…
QR 코드를 불러오지 못했습니다. 새로고침하거나 다른 티어를 선택해 주세요.
QR 코드를 불러오는 중…
QR 코드를 불러오지 못했습니다. 새로고침하거나 다른 티어를 선택해 주세요.
QR 코드를 불러오는 중…
QR 코드를 불러오지 못했습니다. 새로고침하거나 다른 티어를 선택해 주세요.
모바일에서는 화면을 캡처한 뒤 결제 앱 앨범 스캐너에서 불러와 주세요.
100% 자발적인 후원이며 커피와 토큰 비용에 쓰입니다. 유료 SLA나 우선 지원은 제공되지 않습니다. 후원 안내
예제를 불러오는 중…