New in 2.15: swap Lumina's fonts from your own CSS, and preview any of them live.

On this page

Releases¶

16 min read

v2.21.2 (2026-11-10)¶

Bug Fixes¶

hooks: Sitemap noindex, sidebar depth and icons, boolean options (#237, 13384c5)
js: Survive blocked storage and fix TOC, copy, permalink and search edge cases (#238, 77981a8)
search: Mark same-page results and keep landing highlights in the body (#240, 6e6efc0)

Maintenance

Continuous Integration¶

release: Publish and deploy the tagged commit; build sdist without pnpm (#239, 5ac3f62)

v2.21.1 (2026-11-10)¶

Bug Fixes¶

templates: Escape SEO tags, resolve nav links, translate leftover text (#236, 8428a4b)

v2.21.0 (2026-11-07)¶

Features¶

search: Highlight search terms on the opened page (#235, 785e824)

v2.20.0 (2026-11-07)¶

Features¶

Lumina code style preset and reading polish (#234, 8d1db77)

v2.19.6 (2026-11-07)¶

Bug Fixes¶

Style index pages and native search and select controls (#233, 6926e27)

v2.19.5 (2026-11-07)¶

Bug Fixes¶

version-switcher: Drop non-http(s) version URLs (#230, 2847629)

Maintenance

Build System¶

deps: Bump the uv-minor group with 10 updates (#227, de5f924)
deps-dev: Bump sphinx-llm from 0.4.1 to 1.1.0 in the uv-major group (#228, ad6bf1e)

Continuous Integration¶

Run extension tests on Python 3.14 and 3.15 (#232, 3c4ebc9)

v2.19.4 (2026-11-07)¶

Bug Fixes¶

search: Expose keyboard selection to screen readers (#231, 06a5661)

v2.19.3 (2026-11-07)¶

Bug Fixes¶

Apply dark Pygments palette for dark_mode_default (#229, 5a79730)

Maintenance

Build System¶

deps: Bump pnpm/action-setup from 6.1.0 to 6.1.1 in the github-actions-minor group across 1 directory (#218, 6b94dc6)
deps-dev: Bump the npm-minor group across 1 directory with 4 updates (#219, 9913256)

v2.19.2 (2026-11-07)¶

Bug Fixes¶

search: Resolve fallback search link under dirhtml builds (#220, 46d9dfc)

Maintenance

Build System¶

Support Python 3.15 (#224, 7ab986e)

Chores¶

deps: Bump sphinx to 9.2.0 (#221, 8bc5ef0)

Continuous Integration¶

Fix browser tests on Ubuntu 26.04 and run engines in parallel (#222, 70e32a6)
Skip browser tests on pushes to main (#226, fd86bdf)
Use dependabot uv ecosystem for python deps (#225, 646a653)

Testing¶

Filter upstream deprecation warnings (#223, ccc2d81)

v2.19.1 (2026-11-04)¶

Bug Fixes¶

version-switcher: Restyle the picker and list PR builds (#217, 547ffdc)

v2.19.0 (2026-11-04)¶

Features¶

Add numbered steps for heading sequences (#216, af63625)

v2.18.0 (2026-11-04)¶

Features¶

Integrate with Read the Docs addons (#215, 7db0867)

v2.17.2 (2026-11-04)¶

Bug Fixes¶

Keep content aligned and hide title-only TOC (#214, 4236c24)

v2.17.1 (2026-10-30)¶

Bug Fixes¶

landing: Smooth the fluid hero and cut its GPU use (#213, 7f332e0)

v2.17.0 (2026-10-30)¶

Features¶

Add right-to-left layout support and Arabic translation (#211, 9bfb660)

v2.16.0 (2026-10-30)¶

Features¶

landing: Refresh landing heroes and fix reading details (#212, c721e4d)

v2.15.0 (2026-10-30)¶

Features¶

Add font tokens for custom fonts (#210, 9506146)

Maintenance

Build System¶

deps-dev: Bump lucide-static from 1.61.0 to 1.62.0 in the npm-minor group (#209, 97c2466)

v2.14.2 (2026-10-29)¶

Bug Fixes¶

search: Add role=main to landing pages for Sphinx search summaries (#208, 9406319)

v2.14.1 (2026-10-29)¶

Bug Fixes¶

tables: Keep captions and stub columns intact in stacked mobile tables (#207, 67d882c)

v2.14.0 (2026-10-28)¶

Features¶

Hide breadcrumbs on the root page and per page via front matter (#206, daf744d)

v2.13.1 (2026-10-28)¶

Bug Fixes¶

ci: Remove PR previews when pull requests close (#205, 3264243)

Maintenance

Build System¶

deps-dev: Bump the npm-minor group with 4 updates (#202, d2555e3)

v2.13.0 (2026-10-28)¶

Features¶

search: Make Pagefind opt-in through a Python extra (#201, 65c7803)

Additional Release Information¶

search: Search_backend now defaults to “auto”: Pagefind is used only when the sphinx-lumina-theme[pagefind] extra is installed, otherwise Sphinx’s built-in search. Install the extra to keep Pagefind.

v2.12.3 (2026-10-28)¶

Bug Fixes¶

landing: Clear the fixed header when a landing page has no hero (#199, d44e4f4)

Maintenance

Continuous Integration¶

release: Comment on released pull requests and issues (#204, 2c50674)

v2.12.2 (2026-10-28)¶

Bug Fixes¶

github: Render bug report steps as Markdown (#203, 872866d)

Maintenance

Build System¶

deps-dev: Pin test mermaid to sphinxcontrib-mermaid’s default version (#200, 0e6a74d)

v2.12.1 (2026-10-28)¶

Bug Fixes¶

headings: Space the permalink icon from heading text (#198, 32164dc)

Maintenance

Build System¶

deps: Bump fast-uri from 3.1.8 to 3.1.9 (#197, 5e9849c)
deps: Bump markdown-it from 14.3.2 to 14.3.3 (#190, ad49405)
deps: Bump pypa/gh-action-pypi-publish from 1.14.2 to 1.14.3 in the github-actions-minor group (#196, 6a96be5)
deps: Bump the github-actions-minor group with 3 updates (#186, d481f03)
deps: Bump the npm-minor group with 2 updates (#187, aa95a3f)
deps: Bump the uv group across 1 directory with 2 updates (#191, e4290d7)

v2.12.0 (2026-10-16)¶

Features¶

i18n: Translate theme UI strings with Sphinx’s language setting (#185, 073920d)

v2.11.0 (2026-10-13)¶

Features¶

search: Find API symbols and keep API reference navigation readable (#184, bc197ed)

v2.10.1 (2026-10-12)¶

Bug Fixes¶

search: Style Sphinx’s search page (#183, 3943977)

v2.10.0 (2026-10-12)¶

Features¶

nav: Expand only the current path in the sidebar by default (#182, b1a1019)

v2.9.11 (2026-10-12)¶

Bug Fixes¶

search: Make Sphinx’s search page list results (#180, 96d32b3)

v2.9.10 (2026-10-12)¶

Bug Fixes¶

nav: Wrap long names in the sidebar and page TOC (#181, 71c1860)

v2.9.9 (2026-10-11)¶

Bug Fixes¶

search: Keep the keyboard selection when a search repeats (#179, e0c5678)

v2.9.8 (2026-10-11)¶

Bug Fixes¶

tables: Keep code blocks inside table cells from widening the table (#178, 675cefd)

v2.9.7 (2026-10-11)¶

Bug Fixes¶

css: Style docutils elements that basic.css used to cover (#176, a84c862)

v2.9.6 (2026-10-11)¶

Bug Fixes¶

code: Make the wrap toggle opt-in and fill the corner without copybutton (#177, 5a71499)

v2.9.5 (2026-10-11)¶

Bug Fixes¶

api: Style C, C++, rST, and other Sphinx domains like Python (#175, aa8c4f5)

v2.9.4 (2026-10-10)¶

Bug Fixes¶

toc: Prevent active snake highlight flicker during fast scrolling (#173, 2ad1743)

Maintenance

Build System¶

deps: Bump fast-uri from 3.1.5 to 3.1.8 (#170, 1e74619)
deps: Bump js-yaml from 4.3.1 to 4.3.2 (#168, 4127190)
deps: Bump linkify-it from 5.0.0 to 5.0.2 (#171, 9efb7fa)
deps: Bump markdown-it from 14.1.1 to 14.3.2 (#169, ec55bf5)
deps: Bump source-map-js from 1.2.1 to 1.2.2 (#167, f7083ea)
deps: Bump uv from 0.12.17 to 0.12.18 in the uv group across 1 directory (#174, 8d53ad9)
deps-dev: Bump mermaid from 11.12.1 to 11.16.1 (#172, 78256b6)

v2.9.3 (2026-10-10)¶

Bug Fixes¶

Prevent mobile announcement jump and align sidebar rows (#164, 1f72bde)

Maintenance

Build System¶

deps: Bump the uv group across 1 directory with 2 updates (#166, 72e61a4)

v2.9.2 (2026-10-10)¶

Performance Improvements¶

Reduce font downloads and remove hero entrance delays (#161, 42e9028)

Maintenance

Build System¶

deps: Bump the npm-minor group with 3 updates (#165, 7fd066b)

v2.9.1 (2026-09-28)¶

Bug Fixes¶

Prevent announcement overflow and mobile breadcrumb overlap (#163, f5c4e8d)

Maintenance

Build System¶

deps: Bump the github-actions-major group across 1 directory with 2 updates (#153, 65f1cca)
deps: Bump the github-actions-minor group across 1 directory with 2 updates (#152, 11a154f)
deps: Bump the npm-minor group across 1 directory with 6 updates (#154, b502b56)

Documentation¶

Add accent color preview (#158, 2aa3df5)
Announce Lumina 2.0 features (#160, 19528c8)
Improve discovery metadata and declare Python 3.14 (#159, 3b9098c)

Testing¶

Stabilize browser checks (#162, 88db9ad)

v2.9.0 (2026-09-25)¶

Features¶

search: Add section scopes and heading results (#157, 80c35f7)

v2.8.1 (2026-09-25)¶

Bug Fixes¶

tests: Stabilize TOC and copy feedback browser checks (#156, 19fd41e)

v2.8.0 (2026-09-25)¶

Features¶

tables: Refine lists and add opt-in table controls (#155, 0f9e029)

v2.7.0 (2026-09-24)¶

Features¶

toc: Add curved heading hierarchy guide (#151, 35db757)

v2.6.0 (2026-09-24)¶

Features¶

mermaid: Refine diagram design and natural sizing (#150, 3b47b46)

v2.5.0 (2026-09-24)¶

Features¶

api: Streamline and collapse API reference layouts (#149, 17dc98f)

v2.4.0 (2026-09-23)¶

Features¶

http-api: Improve interactive REST API testing (#148, ef55c80)

v2.3.0 (2026-09-23)¶

Features¶

docs: Enable prose hyphenation (#147, 9282e15)

v2.2.0 (2026-09-21)¶

Features¶

layout: Expand wide-screen content (#145, 6f4ea25)

Maintenance

Documentation¶

Consolidate repository instructions (#146, 770e3e5)

v2.1.2 (2026-09-21)¶

Bug Fixes¶

Declare sphinx-design runtime dependency (#143, 332a5fe)

v2.1.1 (2026-09-21)¶

Bug Fixes¶

lightbox: Make close button native (#144, facca12)

v2.1.0 (2026-09-20)¶

Features¶

docs: Redesign the single-screen landing page (#142, ede8473)

Refactoring¶

Remove audited over-engineering (#137, 4f2f913)

v2.0.1 (2026-09-20)¶

Bug Fixes¶

responsive: Improve mobile table reading (#141, fbee9eb)

v2.0.0 (2026-09-20)¶

Features¶

theme: Ship the Lumina 2 editorial redesign (#140, 1d6cd54)

Maintenance

Continuous Integration¶

Update checkout pin comments (#138, 39bc1b6)

Documentation¶

Document uv workflow (#139, 6ffff55)

v1.44.1 (2026-09-20)¶

Bug Fixes¶

ci: Update release action pins (f011b91)
release: Avoid building in semantic release container (f02b46e)
release: Set up build tools before semantic release (4642d5b)

Maintenance

Continuous Integration¶

Harden GitHub Actions workflows (#135, 9f0f916)

Documentation¶

Polish user-facing documentation (#134, f6593f0)

v1.44.0 (2026-09-19)¶

Features¶

docs: Add Google site verification file (#133, 40ab849)

Maintenance

Build System¶

deps: Bump starlette from 1.0.1 to 1.3.1 in the uv group across 1 directory (#118, fe23a49)
deps: Bump the github-actions-major group across 1 directory with 2 updates (#127, 9ead58c)
deps: Bump the github-actions-minor group across 1 directory with 3 updates (#129, 865f6c4)
deps: Bump the npm-minor group across 1 directory with 5 updates (#116, db3155d)
deps: Bump the npm-minor group across 1 directory with 6 updates (#131, 2b70ac4)
deps: Bump the uv group across 1 directory with 2 updates (#132, e1eff07)
deps: Bump the uv group across 1 directory with 3 updates (#113, 9a82b30)
deps-dev: Bump esbuild from 0.28.0 to 0.28.1 (#117, d58a19b)
deps-dev: Bump the npm-major group across 1 directory with 3 updates (#125, 7c9dd39)

v1.43.0 (2026-06-11)¶

Features¶

Fix nested admonitions and improve visual polish (#115, 3ba60d5)

v1.42.0 (2026-06-11)¶

Features¶

Fix header offset variable usage and improve accessibility (#114, debd271)

Maintenance

Build System¶

deps: Bump mistune from 3.2.0 to 3.2.1 in the uv group across 1 directory (#104, 643a791)
deps: Bump pnpm/action-setup from 6.0.4 to 6.0.5 in the github-actions-minor group (#105, 87d027d)
deps: Bump the github-actions-minor group across 1 directory with 2 updates (#112, d4cb2d4)

v1.41.0 (2026-05-03)¶

Features¶

seo: Add SEO discoverability primitives to the theme (#103, 1ab5808)

Refactoring¶

Simplify mobile drawer dismissal (drop close X, add Escape) (#101, 875310a)
Unify shadows behind elevation tokens and share overlay backdrop (#102, fa20f03)

v1.40.0 (2026-05-02)¶

Features¶

Click-to-zoom lightbox for images (#98, 7fe05d6)

v1.39.0 (2026-05-01)¶

Features¶

Add per-block code line-wrap toggle (#97, 273e884)

Maintenance

Build System¶

deps: Bump pnpm/action-setup from 6.0.3 to 6.0.4 in the github-actions-minor group (#99, bd14ee2)
deps: Bump the npm-minor group with 5 updates (#100, 85186b8)

v1.38.0 (2026-05-01)¶

Features¶

Add opt-in reading-time estimate badge (#96, 39acaa1)

Refactoring¶

Define Lumina palette via Tailwind v4 @theme directive (#95, 9ceb12e)

Maintenance

Documentation¶

Add CSS variables reference page (#94, f6ec452)

v1.37.0 (2026-05-01)¶

Features¶

Fluid responsive scaling for article headings (#93, 3ac79bf)
search: Add load timeout and query memoization (#92, c16e251)

Performance Improvements¶

scrollspy: Coalesce position recompute via requestAnimationFrame (#91, 905477d)

v1.36.0 (2026-05-01)¶

Bug Fixes¶

sidebar: Trap focus and shrink drawer on small viewports (#88, 3206518)

Features¶

Add print stylesheet for legible printed output (#89, 6a932aa)

Refactoring¶

Extract shared clipboard helper, drop execCommand fallback (#90, 1e07ee1)

v1.35.1 (2026-05-01)¶

Bug Fixes¶

Skip link uses configured accent color (#87, da1e37a)

Maintenance

Build System¶

deps: Bump actions/setup-node from 6.3.0 to 6.4.0 in the github-actions-minor group (#83, 308bcf0)
deps: Bump pnpm/action-setup from 5.0.0 to 6.0.3 (#84, 52df117)
deps: Bump the npm-minor group with 4 updates (#85, d67c314)

Chores¶

Add issue and pull request templates (#86, 3e487e0)

v1.35.0 (2026-04-16)¶

Features¶

Optimize scrollspy and improve accessibility (#79, 31c7cb4)

v1.34.0 (2026-04-16)¶

Features¶

Polish API field list labels, parameter items, and status codes (#78, 7871617)

Maintenance

Build System¶

deps: Bump dompurify from 3.3.3 to 3.4.0 (#73, 86c94c6)

v1.33.3 (2026-04-16)¶

Bug Fixes¶

Highlight top-level nav items when they are the current page (#77, 9e6390d)

v1.33.2 (2026-04-16)¶

Bug Fixes¶

Prevent typography CSS from overriding API documentation styles (#76, 9829667)

v1.33.1 (2026-04-15)¶

Bug Fixes¶

Add tooltips to icon-only header buttons (#72, c8ea143)

v1.33.0 (2026-04-15)¶

Features¶

Polish lists, tables & typography elements (#71, 9535d4f)

v1.32.0 (2026-04-15)¶

Features¶

Add code_style theme option with 5 curated Pygments presets (#70, b458959)

v1.31.3 (2026-04-15)¶

Bug Fixes¶

Polish doc sections switcher (#68, e11ad3d)

v1.31.2 (2026-04-15)¶

Bug Fixes¶

Redesign sidebar active state and move chevrons to right (#69, 7eea5d3)

v1.31.1 (2026-04-15)¶

Bug Fixes¶

Render Lucide logo icon crisply and derive favicon from it (#67, f5de441)

v1.31.0 (2026-04-15)¶

Features¶

Collapsible sidebar navigation with extra depth level (#66, a66577e)

v1.30.0 (2026-04-15)¶

Features¶

Add doc sections switcher (#63, 90e5186)

v1.29.0 (2026-04-15)¶

Features¶

Add always-on wide layout mode (#65, cd6987e)

v1.28.1 (2026-04-15)¶

Bug Fixes¶

Tighten tab component spacing (#64, 58c5429)

Maintenance

Build System¶

deps-dev: Bump pytest from 9.0.2 to 9.0.3 in the uv group across 1 directory (#56, d5b1bb7)

v1.28.0 (2026-04-14)¶

Features¶

Add Lucide icon system for cards, sidebar, and logo (#61, d52cbb6)

v1.27.0 (2026-04-14)¶

Features¶

Redesign TOC with sliding indicator and typographic hierarchy (#62, 5b4fa4f)

v1.26.1 (2026-04-14)¶

Bug Fixes¶

Improve sidebar navigation visual hierarchy and typography (#60, bfc78dc)

v1.26.0 (2026-04-14)¶

Features¶

Add wide layout mode with reader toggle (#58, 90d784f)

v1.25.2 (2026-04-14)¶

Bug Fixes¶

Remove page-load transition animation (#57, 853be35)

Maintenance

Build System¶

deps: Bump actions/github-script from 8.0.0 to 9.0.0 (#55, 6f6b1aa)
deps: Bump pypa/gh-action-pypi-publish from 1.13.0 to 1.14.0 in the github-actions-minor group (#54, c4f53c5)

v1.25.1 (2026-04-07)¶

Bug Fixes¶

Smooth fluid simulation mouse interaction (#53, 8364262)

Maintenance

Chores¶

Replace deprecated master_doc with root_doc in theme templates (#52, deb6985)

v1.25.0 (2026-04-06)¶

Features¶

Add auto-generated JavaScript API documentation (#51, 3214fee)

Maintenance

Chores¶

Add aria-hidden attribute to decorative SVG icons (#49, 6e3af4e)

Continuous Integration¶

Refactor GitHub Actions workflows to use reusable actions (#50, 3efa0a9)

Documentation¶

Getting Started documentation link in README (#48, 795763c)

v1.24.0 (2026-04-04)¶

Features¶

Improve performance - defer scripts, optimize fluid sim, preload font (#47, 619dd30)

v1.23.0 (2026-04-04)¶

Features¶

Add version switcher dropdown (#41, d4f09c1)

Maintenance

Chores¶

Add PyPI classifiers, project URLs, author, and keywords (#44, 9b4805c)

Documentation¶

Add pip install command to README (#45, 5eadb1c)
Update README demo GIF (#46, 6c3ae46)

v1.22.1 (2026-04-04)¶

Bug Fixes¶

Try It Out panel — Safari crash, collapsed content leak, polish (#43, 810df2d)

v1.22.0 (2026-04-04)¶

Features¶

Add dismissible announcement banner (#38, 62fbccd)

v1.21.1 (2026-04-04)¶

Bug Fixes¶

Fix README for PyPI (#42, 95e6383)

v1.21.0 (2026-04-04)¶

Features¶

Add separate light/dark mode logos (#40, bd5a86a)

v1.20.0 (2026-04-04)¶

Features¶

Add back-to-top button (#39, 312335e)

v1.19.0 (2026-04-04)¶

Features¶

Add icons to hero feature tags (#37, 6eab593)

v1.18.1 (2026-04-04)¶

Bug Fixes¶

Accent color no longer bleeds emerald into derived CSS vars (#35, 73eeacd)
Use standard Apache 2.0 license and clean up sdist (#36, f538619)

v1.18.0 (2026-04-04)¶

Features¶

Bump dev Python to 3.14 and minimum to 3.12 (#34, 17414b6)

Maintenance

Continuous Integration¶

Publish releases to PyPI via trusted publishers (#33, ae97887)

v1.17.0 (2026-04-04)¶

Features¶

Improve Pagefind search quality and result UX (#31, 47826f6)

Maintenance

Continuous Integration¶

Auto-deploy docs on push to main when docs/ changes (#32, ecb6054)

Documentation¶

Document the landing page template (#30, b9a0c4a)

v1.16.1 (2026-04-04)¶

Bug Fixes¶

Sanitize search excerpts to prevent XSS via x-html (#29, aea9974)

v1.16.0 (2026-04-04)¶

Features¶

Interactive HTTP API docs with Try it out and curl copy (#28, 9bb8f22)

v1.15.0 (2026-04-04)¶

Features¶

Switch to Apache 2.0 license and add configurable attribution (#27, bc3a0ab)

v1.14.0 (2026-04-04)¶

Features¶

Style code block captions as file header bars (#26, f95c495)

Maintenance

Documentation¶

Remove Getting Started and Customization links from README nav (#25, f76b586)

v1.13.0 (2026-04-04)¶

Features¶

Add sphinx-last-updated-by-git support (#23, f8c25a3)

v1.12.0 (2026-04-04)¶

Features¶

Add animated demo GIF recording for README (#24, 21222ef)

v1.11.0 (2026-04-04)¶

Features¶

Reorganize documentation into hub-and-spoke architecture (#22, 81ce49e)

v1.10.0 (2026-04-04)¶

Features¶

Add llms.txt integration with sphinx-llm (#21, e55d1d5)

v1.9.0 (2026-04-04)¶

Features¶

Add sphinxcontrib-openapi showcase with curl copy (#20, aac58f1)

v1.8.13 (2026-04-04)¶

Bug Fixes¶

Polish tabs to align with design system (#19, 475b3da)

v1.8.12 (2026-04-04)¶

Bug Fixes¶

Align sphinx-design badges and buttons with design system (#18, c722f8b)

v1.8.11 (2026-04-04)¶

Bug Fixes¶

Polish dark mode icons, clipboard fallback, and minor UI details (#17, e766441)

v1.8.10 (2026-04-03)¶

Bug Fixes¶

Improve README and version replacement script (#16, 5113486)

Maintenance

Documentation¶

Add banner screenshot to README (#15, 855f271)

v1.8.9 (2026-04-03)¶

Bug Fixes¶

Align tabs and mermaid with design system (#14, adbabb0)

v1.8.8 (2026-04-03)¶

Bug Fixes¶

Remove non-functional mobile menu from landing pages (#13, bd6674d)

v1.8.7 (2026-04-03)¶

Bug Fixes¶

Outdated content and inaccuracies across documentation (#12, d996ca9)

Maintenance

Build System¶

deps-dev: Bump esbuild from 0.27.5 to 0.28.0 (#3, bf7e444)

Chores¶

deps: Bump actions/github-script from 7 to 8 (#2, eaa7d55)

v1.8.6 (2026-04-03)¶

Bug Fixes¶

Resolve pagefind import URL against document instead of script (#10, 36aeff7)

v1.8.5 (2026-04-03)¶

Bug Fixes¶

Run semantic-release natively to use deploy key (#8, 4ca0fe6)
Switch GitHub Pages to branch-based deployment (#6, 7955fdc)

Maintenance

Chores¶

Deployment preview in PRs (#7, 6efd807)
Group dependabot updates by ecosystem (#4, a33986c)
Update site url (#5, ecc3434)

v1.8.4 (2026-04-03)¶

Initial Release