Metadata-Version: 2.4
Name: FluentQt-Gallery
Version: 1.8.0
Summary: Installable Gallery for the FluentQt PySide6 bindings
Author: calvinhxx
License-Expression: MIT
Keywords: Qt,PySide6,Fluent Design,WinUI,Gallery
Requires-Python: >=3.11,<3.14
Requires-Dist: FluentQt (==1.8.0)
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://calvinhxx.github.io/Fluent-Qt/
Project-URL: Documentation, https://github.com/calvinhxx/Fluent-Qt#readme
Project-URL: Repository, https://github.com/calvinhxx/Fluent-Qt
Project-URL: Issues, https://github.com/calvinhxx/Fluent-Qt/issues
Project-URL: Changelog, https://github.com/calvinhxx/Fluent-Qt/releases
Project-URL: Library, https://pypi.org/project/FluentQt/
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: User Interfaces
License-File: LICENSE
License-File: THIRD_PARTY_NOTICES.md
License-File: TRADEMARKS.md

# Install FluentQt Gallery from PyPI

> **Status:** Current package guide

<!-- docs-nav:top:start -->
[Documentation](../../../docs/README.md) › [Python bindings](../README.md) › Get started and examples

[← Python Gallery package](README.md) · [Contents](../../../docs/SUMMARY.md) · [Python bindings index](../README.md)
<!-- docs-nav:top:end -->

`FluentQt-Gallery` is the installable Python Gallery for the
[`FluentQt`](https://pypi.org/project/FluentQt/) PySide6 compatibility package.
It demonstrates the native Fluent-Qt C++ widgets through their public Python
API and is distributed separately from the reusable UI library.

## Install and run

```bash
python -m pip install FluentQt-Gallery
python -m fluentqt_gallery
```

Installing the Gallery also installs the exact matching `FluentQt` version.
No separate `.exe`, `.dmg`, or `.deb` is required for the Python application.

## What it includes

- The same component categories and ordered routes as the native C++ Gallery.
- Live Python examples for input, collections, date and time, overlays,
  navigation, scrolling, status, text fields, and windowing.
- Fluent Light and Dark themes, accent customization, responsive navigation,
  search, isolated settings, and native window integration.
- Packaged artwork and source snippets without adding Gallery assets to the
  core `FluentQt` wheel.

## Headless verification

The installed Gallery can also validate its catalog without opening a desktop
window:

```bash
QT_QPA_PLATFORM=offscreen \
  python -m fluentqt_gallery --verify-catalog --walk-routes
```

Native backdrop, title-bar, drag, and compositor effects still require a real
Windows, macOS, or Linux desktop session.

## Compatibility

The Gallery is a pure-Python wheel and follows the platform, architecture,
Python, and Qt runtime support of the exact `FluentQt` version it installs.
The current downloadable combinations are defined by the core package's
[`wheel-matrix.json`](../wheel-matrix.json); this page does not maintain a
second version or platform matrix.

## Project links

- [FluentQt package](https://pypi.org/project/FluentQt/)
- [Documentation](https://github.com/calvinhxx/Fluent-Qt#readme)
- [Source](https://github.com/calvinhxx/Fluent-Qt)
- [Issue tracker](https://github.com/calvinhxx/Fluent-Qt/issues)
- [Release notes](https://github.com/calvinhxx/Fluent-Qt/releases)
- [Project website](https://calvinhxx.github.io/Fluent-Qt/)

FluentQt Gallery is released under the MIT License.

<!-- docs-nav:bottom:start -->
---
[← Python Gallery package](README.md) · [Contents](../../../docs/SUMMARY.md) · [Python bindings index](../README.md)
<!-- docs-nav:bottom:end -->
