Sphinx Breeze Theme

A clean and modern Sphinx theme with polished API docs

Live Demo · Get Started · Kitchen Sink

Why Breeze?

• Clear and readable — Tuned typography and spacing that lets your content breathe
• Polished API docs — First-class autodoc styling that's easy to navigate
• Accessible — WCAG-friendly colors and syntax highlighting out of the box
• Adaptive — Works on any device with light & dark themes
• Built to scale — Multiple layouts, built-in components, and flexible customization

Installation

Requires Python 3.10+ and Sphinx 8.0+.

pip install sphinx-breeze-theme

Quickstart

Add to your conf.py:

html_theme = "breeze"

That's it! For customization options, see the documentation.

Acknowledgements

Breeze draws inspiration from other great projects:

• PyData Sphinx Theme — Three-column layout with toctree tabs in the header
• Material for MkDocs — Overall aesthetic and modern visual direction
• Shibuya — Polish, extension support ideas, and configuration patterns
• VitePress — UI component inspiration
• Furo — Implementation reference for Sphinx code
• Lutra — A three-column theme that inspired this project

This project is tested with BrowserStack. Shoutout to them for supporting OSS projects!

License

This project is licensed under the MPL-2.0 License.