# qlementine

**Repository Path**: anold/qlementine

## Basic Information

- **Project Name**: qlementine
- **Description**: No description available
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-31
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <a href="https://oclero.github.io/qlementine">
    <img style="margin-bottom: 2em;"  src="branding/thumbnail.png">
  </a>
</div>

# Qlementine

[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://mit-license.org)
[![CMake version](https://img.shields.io/badge/CMake-3.21.0+-064F8C?logo=cmake)](https://cmake.org)
[![C++ version](https://img.shields.io/badge/C++-17-00599C?logo=++)](https://www.qt.io)
[![Qt version](https://img.shields.io/badge/Qt-6.8.0+-41CD52?logo=qt)](https://www.qt.io)

[![Linux](https://github.com/oclero/qlementine/actions/workflows/linux.yml/badge.svg)](https://github.com/oclero/qlementine/actions/workflows/linux.yml)
[![Linux](https://github.com/oclero/qlementine/actions/workflows/windows.yml/badge.svg)](https://github.com/oclero/qlementine/actions/workflows/windows.yml)
[![Linux](https://github.com/oclero/qlementine/actions/workflows/macos.yml/badge.svg)](https://github.com/oclero/qlementine/actions/workflows/macos.yml)

Modern QStyle for desktop Qt6 applications.

See [documentation](https://oclero.github.io/qlementine) for more information.

<div align="center">
  <img style="width: 45%; padding: 10px;"  src="branding/screenshots/windows-light.png">
  <img style="width: 45%; padding: 10px;"  src="branding/screenshots/windows-dark.png">
</div>

---

### Table of Contents

- [Requirements](#requirements)
- [Features](#features)
- [Usage](#usage)
- [Creator](#creator)
- [License](#license)

---

## Requirements

- Windows, MacOS or Linux.
- [CMake 3.21.0+](https://cmake.org/download)
- [Qt 6.8.0+](https://www.qt.io/download-qt-installer)

## Features

This library contains:

- A custom `QStyle` named `QlementineStyle`, that implements all the necessary API to give a modern look and feel to your Qt application. It's a **drop-in replacement** for the default `QStyle`.
- Lots of utilities to help you write beautiful `QWidgets` that fits well with the style.
- A collection of new `QWidgets` that are missing in Qt's standard collection, such as `Switch`.

## Usage

See [documentation](docs/usage.md) for details. Basically, you just need to add Qlementine as a dependency with CMake, and call `QApplication::setStyle`.

## Creator

**Olivier Cléro** | [email](mailto:oclero@pm.me) | [website](https://www.olivierclero.com) | [github](https://www.github.com/oclero) | [gitlab](https://www.gitlab.com/oclero)

## License

**Qlementine** is available under the MIT license. See the [LICENSE](LICENSE) file for more info.