2021.09.22 – Cavalier Canary

  • Restyle API documentation signatures, to have a background and use monospace fonts.

  • Reduce spacing for items in API documentation.

  • Improve the presentation of links in site-wide announcement.

  • Only add a border on code inside paragraphs.

  • Use noscript for presenting “search needs JS” message.

2021.09.08 – Balmy Blue

  • Prevent screen-reader-only content from showing up in Sphinx search results.

  • Improve support for various footer configurations.

2021.08.31 – Aspiring Avocado

  • First stable release! 🎉

  • Document stability policy.

  • Tweak API styling selectors.

  • Drop reference to no-longer-used pygments_dark.css.

  • Eagerly set the light/dark mode theme, when loading a page.


  • Add support for sphinx-design.

  • Document sidebar title customization.

  • Don’t show “Contents” on pages without h1 headings.

  • Add border to inline code, to improve contrast.

  • Reduce contrast on dark-mode text.


  • Fix esoteric failure due to inability to write pygments.css.

  • Improve overscroll behaviour.


  • Adapt for newer sphinx-copybutton design

  • Improved screen reader experience

  • Bring back asset digests, to avoid caching-related issues


  • Add spacing around light theme / dark theme / auto theme toggle.


  • Site visitors can now force light theme / dark theme, independently of browser settings. 🎉

  • Rework handling of dark theme code block highlighting.

  • “Hide Search Matches” shows up in the sidebar, when the user has search matches highlighted.

  • Search term highlights are only shown in the page content.

  • Fix styling for default aligned tables.

  • Enable smooth scrolling.

  • meta: Upgrade NodeJS packages and start using Babel.

  • meta: Rework organisation of various user-facing CSS variables.


  • Fix image alignment in Sphinx 4.


  • Require Sphinx 4.

  • Rework CSS/JS asset inclusion, to work better with Sphinx 4.

  • Document how to add a custom admonition style.


  • Fix dark mode highlighting in Sphinx 4.


  • Allow use with Sphinx 4.

  • Fix right alignment of viewcode links, when used with certain API signatures.


  • Account for even more variants of sidebar-caption HTML.


  • Another styling update sidebar-caption related changes in Sphinx.


  • Add a basic domainindex page, without dedicated styling.

  • Add recommendation for sphinx-opengraph.

  • Account for newer Sphinx versions changing classes for captions.

  • Account for the broken docutils release.

  • Right align viewcode links (like [source]) allowing wrapping of API signatures gradefully.


  • Get pygments_dark_style working.

  • Use the correct layout for domain index placeholder.


  • Fix a typo in the README.

  • Add an escape hatch for specific table of contents.


  • Update Python-Requires to >=3.6.

  • Account for nested admonitions.

  • Center align items like other themes.

  • Don’t stylize the compound kbd tags.

  • Fix a broken internal link in documentation.

  • Fix a mistyped vertical-align style.

  • Vertically align embedded-in-text images.

  • Declare in HTML that the theme’s pages support multiple color schemes.


  • Fix a bug in how stylesheets are handled.

  • Clarify how to install directly from GitHub.

  • Document how to install from git.


  • Center figures and legends with margin: auto.

  • Improve compatibility with json builder, by not passing functions into the Jinja templates.

  • Add a friendly comment to domainindex.html, about it not being implemented.

  • Add styling for GUI labels.


  • Fix wrong height on wide screens, for pages with a tall sidebar but not-tall content.

  • Add type annotations to the codebase! 🎉

  • Fix an instance of missing brackets in documentation.


  • Document how to inject custom code in Sphinx documentation

  • Document that pygments_dark_style is Furo-specific

  • Make sphinx-panels respond to dark mode with Furo

  • Stop defering Javascript, which was causing search to break in some cases.


  • Disable environment caching if pygments_dark_style is changed.

  • Revert to earlier background color for inline literals, and allow configuring it via a CSS variables.


  • Fix code-block overflow issue, introduced by the fix for sphinx-copybutton compatibility.

  • Tweak horizontal rules, to always be 1px tall.

  • Tweak background color for inline literals, to match code blocks.


  • MAJOR: Move theme files into a “furo” folder.

    • This affects any users deriving from furo’s templates.

  • Add (custom) support for pygments_dark_style.

  • Add support for genindex pages.

    • Note that html_split_index is not supported at this time.

  • Add support for highlighting API elements, when accessed via “#hash” in URL.

  • Add language_data.js to search page, fixing Stemmer related failures in Sphinx 3.4.

  • Document how to add a site-wide announcement.

  • Fix sphinx-copybutton placement on scrollable code blocks.

  • Generate an error page, for documents using layout.html from Sphinx’s basic theme.

  • Translate placeholder in sidebar’s search.

  • Tweak how additional h1 headings are handled in ToC sidebar.

  • Update dependency constraints, limiting compatibility to Sphinx 3.x versions.


  • Rebuild theme assets, for main release.


  • Clarify expectations around sidebar customisation.

  • Declare plugin information to pacify Sphinx’s “are you parallel” check.

  • Disable sidebar-follows-you-as-you-scroll Javascript.

  • Fix scrollbar styles affecting document body.

  • Tweak colors for problematic content.

  • Tweak how words wrap in sidebar title.

  • Tweak spacing in API documentation.

  • Tweak wrapping of text in API function/class signatures.


  • Add styling for rubrics.

  • Add styling for scrollbars, to make them match the theme.

  • Fix bottom-of-page JS conditional.

  • Fix stability of resources hashes. (thanks @dvarrazzo)

  • Fix styling for multi-term definition lists items.

  • Re-add our development documentation kitchen-sink.

  • Tweak how ToC sidebar handles scrollbars.

  • Tweak styling for basic definition lists.


  • Fix search page. It had become non-operational, due to changes to JS in the previous release.


  • Add properly documented mechanisms for customising the sidebar.

  • Add dedicated styling for ethical ads.

  • Tweak how JS scripts are loaded.


  • Add a separate file for CSS that affects other Sphinx extensions.

  • Add content to all the existing pages in documentation.

  • Clarify that Furo is biased toward smaller documentation sets.

  • Clarify that logo files need to be in html_static_path

  • Improve various explanations in documentation.

  • Tweak borders inside tables.

  • Tweak bottom spacing on right sidebar.

  • Tweak CSS and JS blocks in base.html template.

  • Tweak how captions for toctrees look.

  • Tweak spacing on sidebar ad on ReadTheDocs.


  • Add a recommendations page, for plugins

  • Add support for different logos in light and dark mode

  • Change location of TOC drawer icon on mobile

  • Drop support for html_sidebars based customisation.

  • Improve how the RTD ads work

  • Improve TOC sidebar auto-scroll functional

  • Significantly improve footer capabilities


  • Add classifiers to the theme.

  • Add friendly messages for users of html_sidebars.

  • Add link to homepage, in mobile header.

  • Add support for ethical ads in the sidebar.

  • Change css_variables to light_css_variables.

  • Change font stack to match to GitHub.

  • Change the color used for <hr> tags.

  • Change unsplash URLs to use cute+animal as cues

  • Document navigation_with_keys.

  • Drop logic that jumps toc-scroll to bottom-of-page.

  • Improve customisation documentation.

  • Remove text underline from headerlink.

  • Strip tags in title.


  • Add a direct dependency on Sphinx.

  • Add styling for “highlighted text” in dark mode.

  • Add support for sphinx-inline-tabs.

  • Change the default development branch name to main.

  • Drop customisations for sphinx-panel’s tabs.

  • Rework the entire handling of background and foreground colours.

  • Tweak API documentation, when presented in dark mode.

  • Tweak Bootstrap 4 .container styling (comes from sphinx-panel).

  • Tweak borders on tables.

  • Tweak dark mode colors.

  • Tweak light mode colors.


  • Fix image link in README, to show up correctly on PyPI.


  • Tweak colors for dark mode.

  • Tweak presentation of <kbd>, to look better in dark mode.


  • Add dark mode support, based on prefers-color-scheme! 🎉

  • Add more information in the documentation (reference and customisation).

  • Add sourcemaps in the generated distribution.

  • Add support for glossary lists.

  • Drop the custom ReadTheDocs-specific CSS.

  • Fix bad transparency handling for sidebar hover on Safari.

  • Fix shrinking of sidebar brand image on Safari.

  • Tweak spacing in admonitions.


  • Add per-build hashes to asset URLs, to simplify cache invalidation.

  • Tweak spacing in API documentation.


  • Require Sphinx 3.

  • Add styling for API documentation.

  • Add styling for abbreviations.

  • Add clear CSS property for left/right aligned content.

  • Add styling to tweak the look of tabs.

  • Drop the complexities introduced for custom homepages.

  • Tweak color of problematic content.

  • Tweak font-size handling for code-blocks.

  • Tweak font-size handling for admonitions.

  • Tweak spacing around code-blocks.

  • Tweak how pages look with announcement and shorter-than-viewport content.

  • Tweak styling for lists.

  • Fix overlays to correctly show on top of content.

  • Restructure sidebar scrolling, to correctly fill viewport.

  • Change JS from the basic theme to use blocking network requests.

  • Change inline table of contents to look like an error, nudging toward to not using it.


  • Automate version management

  • Use correct width for elements on small screens (100% instead of 100vw)


  • Tweak header on small screens.

  • Tweak spacing for small screens.

  • Place “sidebar” directive’s contents inline, on small screens.



This release was not correctly versioned and is not installed preferentially over beta4.

  • Add CSS variables for header foreground and background.

  • Add styling for captions.

  • Add styling for correctly handling permalinks.

  • Correctly stylize only definition lists with the rules intended for them.

  • Fix next/prev links flowing into one-another by limiting width to 50%.

  • Fix positioning of collapsed contents sidebar icon.

  • Fix shrinking arrows in next/prev links.

  • Include basic theme’s JS files unconditionally. This should help with compatibility with various Sphinx extensions and ReadTheDocs.

  • Make math elements scrollable, when wider than the page.

  • Tweak images to be responsive.

  • Tweak spacing of paragraphs.

  • Tweak location of ReadTheDocs’ injected version helper.


  • More fixes for Python 3.7 support.


  • Add support for sphinx.ext.todo.

  • Add support for hiding name in sidebar.

  • Add reference to deployed documentation in README.

  • Tweak font size for admonitions.

  • Tweak spacing for contents sidebar.

  • Tweak styling of inline code.

  • Fix support for Python < 3.8.


  • Add support for logos in the sidebar.

  • Fix path used for search page.

  • Tweak height for short pages on mobile (100vh resulted in a scroll).

  • Tweak definition lists.

  • Tweak line height in contents, to accommodate for code literals.

  • Use em as the unit for layout sizes.

  • Start writing theme’s documentation.

  • Deploy documentation on


Initial release.