Skip to main content

Sphinx Lumina Theme

PyPI version License Docs

A crisp, responsive Sphinx theme with readable typography, dark mode, and instant search. Self-hosted fonts, minimal setup, no external CDN calls.

Lumina installation guide with section navigation, code tabs, and a table of contents

Live demo & documentation · Configuration · Contributing

Features

  • Light and dark modes with a system-aware toggle.
  • Instant search powered by Pagefind, with ⌘K / Ctrl+K access.
  • Responsive navigation with section and version switchers, a collapsible sidebar, and a mobile page outline.
  • Rich content with MyST Markdown, syntax highlighting, and one-click code copying.
  • Interactive API docs with OpenAPI support, request panels, and curl copying.
  • Customizable branding through conf.py: colors, logos, navigation, and social links.

Quick Start

Requires Python 3.12+ and Sphinx 8.0+. Pagefind search also needs Node.js so the build can create its search index.

pip install sphinx-lumina-theme

Using uv? Run uv add sphinx-lumina-theme instead.

Set the theme in your conf.py:

html_theme = "lumina"

Build your docs:

sphinx-build docs docs/_build/html

With uv, prefix the build command with uv run. Open docs/_build/html/index.html to view the result.

New to Sphinx? Start with the installation guide, including project creation and MyST setup.

Upgrading from 1.x? Review the Lumina 2 migration notes if you use custom CSS or templates.

Contributing

See the contributing guide for local setup, asset builds, and tests. Bug reports and pull requests are welcome.

License

Apache-2.0

Metadata

Release files for sphinx-lumina-theme 2.12.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sphinx-lumina-theme 2.12.3
File Size Uploaded Provenance Actions
sphinx_lumina_theme-2.12.3.tar.gz 1.9 MB With provenance Details for sphinx_lumina_theme-2.12.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sphinx-lumina-theme 2.12.3
File Interpreter ABI Platform Actions
sphinx_lumina_theme-2.12.3-py3-none-any.whl Python 3 none any Details for sphinx_lumina_theme-2.12.3-py3-none-any.whl

Total release size: 3.3 MB

Release files / sphinx_lumina_theme-2.12.3.tar.gz

Download URL sphinx_lumina_theme-2.12.3.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
b8c94bc587de16498003f1e67cf8e769f67de26d98aabec9d69438356a01548d
BLAKE2b-256 checksum
How to use checksums
0793b9a87e95e18e97fdc9bfb3b84c4c500838c4f82c4db1bf4340930f6e7f0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Release files / sphinx_lumina_theme-2.12.3-py3-none-any.whl

Download URL sphinx_lumina_theme-2.12.3-py3-none-any.whl
Size 1.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
5fbffef7ac039489d8f60e0e00a774a8fea05dcda93534a23a7c9f5e7cf0fc7e
BLAKE2b-256 checksum
How to use checksums
342c0deb8b3a9e20bfef720c130ec4b16db3fc8df5642a4470c80ec2b34a321c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Security for sphinx-lumina-theme 2.12.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for sphinx_lumina_theme-2.12.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.12.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page