PyPI · #2813 most downloaded on PyPI

furo

2025.12.192.7M downloads/mopradyunsg/furo ↗New releases in your daily digest, changelog included.

A clean customisable Sphinx documentation theme.

Last release 9 months ago
19 Dec 2025
Release timing varies
gaps range from 9 days to 12 months
Nearly every release is documented
notes for 34 of 34 stable releases
5 versions withdrawn
withdrawn after publishing
6 years old
79 releases · first in 2020

Release timeline

79 releases since 2020

2020202120222023202420252026

20202026

One column per quarter.

Releases

2020.11.27b1927 Nov 2020pre-release
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

Add link to mobile header by @hugovk in https://github.com/pradyunsg/furo/pull/22

Update and run pre-commit on CI by @hugovk in https://github.com/pradyunsg/furo/pull/21

Fix stability of resources hashes by @dvarrazzo in https://github.com/pradyunsg/furo/pull/42

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

@dvarrazzo made their first contribution in https://github.com/pradyunsg/furo/pull/42

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.11.27.beta19
Open source →
Additional notes
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.
Open source →

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Add link to mobile header by @hugovk in https://github.com/pradyunsg/furo/pull/22
Update and run pre-commit on CI by @hugovk in https://github.com/pradyunsg/furo/pull/21

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.11.19.beta18

Open source →

Additional notes

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

Open source →

2020.11.15b1714 Nov 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Add link to mobile header by @hugovk in https://github.com/pradyunsg/furo/pull/22
Update and run pre-commit on CI by @hugovk in https://github.com/pradyunsg/furo/pull/21

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.11.15.beta17

Open source →

Additional notes

Add properly documented mechanisms for customising the sidebar.
Add dedicated styling for ethical ads.
Tweak how JS scripts are loaded.

Open source →

2020.11.14b1613 Nov 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Add link to mobile header by @hugovk in https://github.com/pradyunsg/furo/pull/22
Update and run pre-commit on CI by @hugovk in https://github.com/pradyunsg/furo/pull/21

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.11.14.beta16

Open source →

Additional notes

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 Read the Docs.

Open source →

2020.11.10b159 Nov 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Add link to mobile header by @hugovk in https://github.com/pradyunsg/furo/pull/22
Update and run pre-commit on CI by @hugovk in https://github.com/pradyunsg/furo/pull/21

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.11.10.beta15

Open source →

Additional notes

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

Open source →

2020.11.1b141 Nov 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Add link to mobile header by @hugovk in https://github.com/pradyunsg/furo/pull/22
Update and run pre-commit on CI by @hugovk in https://github.com/pradyunsg/furo/pull/21

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.11.01.beta14

Open source →

Additional notes

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.

Open source →

2020.10.15b1314 Oct 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.10.15.beta13

Open source →

Additional notes

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.

Open source →

2020.10.13b1212 Oct 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.10.13.beta12

Open source →

Additional notes

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

Open source →

2020.10.13b1112 Oct 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.10.13.beta11

Open source →

Additional notes

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

Open source →

2020.10.13b1012 Oct 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.10.13.beta10

Open source →

Additional notes

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 Read the Docs-specific CSS.
Fix bad transparency handling for sidebar hover on Safari.
Fix shrinking of sidebar brand image on Safari.
Tweak spacing in admonitions.

Open source →

2020.10.5b94 Oct 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.10.05.beta9

Open source →

Additional notes

Add per-build hashes to asset URLs, to simplify cache invalidation.
Tweak spacing in API documentation.

Open source →

2020.9.28b828 Sept 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.09.28.beta8

Open source →

Additional notes

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.

Open source →

2020.9.15b715 Sept 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.09.15.beta7

Open source →

Additional notes

Automate version management
Use correct width for elements on small screens (100% instead of 100vw)

Open source →

2020.9.15b615 Sept 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.09.15.beta6

Open source →

Additional notes

Tweak header on small screens.
Tweak spacing for small screens.
Place "sidebar" directive's contents inline, on small screens.

Open source →

2020.9.8b48 Sept 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.09.08.beta4

Open source →

Additional notes

More fixes for Python 3.7 support.

Open source →

2020.9.8b38 Sept 2020pre-release

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.09.08.beta3

Open source →

Additional notes

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.

Open source →

2020.9.8b27 Sept 2020pre-release

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.09.08.beta2

Full Changelog: https://github.com/pradyunsg/furo/commits/2020.09.08.beta2

Open source →

Additional notes

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 https://pradyunsg.me/furo/.

Open source →

2020.8.14b514 Sept 2020pre-releasewithdrawn: Incorrect release number

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

What's Changed

Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6

New Contributors

@sethmlarson made their first contribution in https://github.com/pradyunsg/furo/pull/6

Full Changelog: https://github.com/pradyunsg/furo/compare/2020.09.01.beta1...2020.08.14.beta5

Open source →

Additional notes

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 Read the Docs.
Make math elements scrollable, when wider than the page.
Tweak images to be responsive.
Tweak spacing of paragraphs.
Tweak location of Read the Docs' injected version helper.

Open source →