r/QtFramework • u/opticsWolf • 15h ago
Tired of fighting QDockWidget, so I built a docking and theming library for PySide6
Hi all,
For the past few months I’ve been working on Lace, a docking and layout library for PySide6. While building my own desktop engineering tools, I wanted a smooth, VS Code-like layout and cohesive theming experience in Python without the usual Qt layout headaches. It began as just the docking part and grew from there.
What My Project Does
Lace is a pure-Python docking and theming library for PySide6:
Tabbed dock areas: Drag around, split, float into their own windows, and drag back with a live drop preview showing where the panel will land before you let go.
Auto-hide sidebars: Pin panels to an edge to slide them out on demand, with optional badge counters (roughly like VS Code's sidebars).
Layout persistence: Save and restore layouts as JSON, including named presets you can switch between.
Deep theming engine: It doesn't just color the docks. It themes the entire
QPaletteplus a custom style for standard widgets, menus, and dialogs so your own widgets match out of the box. It comes with 37 themes, and you can generate your own from just two colors.
Target Audience
People building larger multi-pane desktop apps in Python (simulation tools, editors, CAD-like or dashboard apps) who want more control over layout and a consistent look than stock Qt gives them.
Comparison
The main alternative is Qt Advanced Docking System (PySide6-QtAds). It’s older, more widely used and well tested across platforms, and if you only need docking it’s a solid choice. The differences:
Lace is pure Python, so it’s easy to read, debug and subclass, and there’s no compiled binding to keep in step with your Qt version.
Lace themes the whole application; Qt-ADS covers the docking panes only.
Details:
License: Apache-2.0 (Python 3.11+)
Install:
pip install lace-dockWebsite & Screenshots: opticswolf.github.io/Lace
Source Code: github.com/opticswolf/Lace
It’s at 0.10, so the API may still change before 1.0. I use it in my own optical simulation tools, so it gets real daily use. I’d really appreciate feedback from anyone building bigger Qt apps: what’s missing, what feels awkward, or what breaks on your platform (I’ve mostly tested on Windows).
Thanks for reading!
