A tool for authoring Sphinx themes with a simple (opinionated) workflow.
Project Links
Meta
Author: Pradyun Gedam
Requires Python: >=3.10
Classifiers
Development Status
- 2 - Pre-Alpha
Framework
- Sphinx
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
- Python :: 3
Topic
- Documentation
- Software Development :: Documentation
- Software Development :: Libraries :: Python Modules
Sphinx Theme Builder
Streamline the Sphinx theme development workflow, by building upon existing standardised tools.
- simplified packaging experience
- simplified JavaScript tooling setup
- development server, with rebuild-on-save and automagical browser reloading
- consistent repository structure across themes
Installation
This project is available on
PyPI, and can be installed
using pip:
pip install "sphinx-theme-builder[cli]"
This project requires modern versions of CPython (>= 3.10).
Usage
Find more details on how to use this project in the documentation.
Contributing
stb is a volunteer maintained open source project, and we welcome
contributions of all forms. Please take a look at the Development
Documentation for more information.
0.3.2
Dec 19, 2025
0.3.1
Dec 19, 2025
0.3.0
Dec 19, 2025
0.2.0
Dec 19, 2025
0.2.0b2
Mar 27, 2023
0.2.0b1
Jul 15, 2022
0.2.0a15
Jun 26, 2022
0.2.0a14
Mar 19, 2022
0.2.0a13
Jan 04, 2022
0.2.0a12
Dec 04, 2021
0.2.0a11
Nov 16, 2021
0.2.0a10
Nov 12, 2021
0.2.0a9
Nov 12, 2021
0.2.0a8
Nov 12, 2021
0.2.0a7
Nov 11, 2021
0.2.0a6
Nov 10, 2021
0.2.0a5
Nov 09, 2021
0.2.0a4
Nov 09, 2021
0.2.0a3
Nov 05, 2021
0.2.0a2
Nov 02, 2021
0.2.0a1
Nov 02, 2021
0.1.0.dev0
May 04, 2021
Wheel compatibility matrix
Files in release
Extras:
Dependencies:
pyproject-metadata
(>=0.10.0)
packaging
rich
nodeenv
setuptools
tomli
diagnostic
(>=2)