Update the theme

Updating the Awesome Theme is straightforward for most users. If you use any customization, you might have to update your customizations manually.

Version 3.0


Create a better visual hierarchy which makes the document easier to scan. Heavily inspired by the Material Design website.


All JavaScript is now using the Stimulus framework.

Version 2.0

Version 2.0 of the Awesome Theme includes these major breaking changes:

Require Sphinx 4 or newer

Sphinx 4 depends on docutils 0.17, which creates more semantic HTML by default. This allows to reduce the amount of custom transformations.

Restructure several templates

The layout use CSS grid. This leads to fewer container elements in the templates.