---
title: Docsy 0.10.0 release report
linkTitle: Release 0.10.0
author: >
  [Patrice Chalin](https://github.com/chalin) ([CNCF](https://www.cncf.io/)),
  for the [Docsy Steering Committee](/blog/2022/hello/#introducing-the-psc)
date: 2024-05-01
# prettier-ignore
cSpell:ignore: CNCF Chalin subdir deprecat upvoted pageinfo lookandfeel lightdark
---

The big news with Docsy [0.10.0] is color themes and dark mode!

## Hugo: breaking changes and deprecation notices

In this release, Docsy's Hugo dependency is upgraded to **0.125.4** from
0.122.0. An important thing to note here is that Hugo [0.123.0] was a
significant upgrade that included some **breaking changes**. Before upgrading to
this Docsy version, review Hugo's deprecation notices and breaking changes since
0.122.0.

[0.123.0]: https://github.com/gohugoio/hugo/releases/tag/v0.123.0

{{% alert title="Hugo version support reminder" color="primary" %}}

Each Docsy version officially **only** supports the Hugo version specified in
the project's [package.json] entry for [hugo-extended]. Any other compatibility
is on a best effort basis.

[hugo-extended]: https://github.com/jakejarvis/hugo-extended
[package.json]: https://github.com/google/docsy/blob/main/package.json

{{% /alert %}}

A number of updates to this release were to address Hugo's deprecation notices.
For the complete list, search for [0.10.0] release changes with "deprecat" in
the title.

## Color themes and dark-mode support

The main feature of this release is the [Upgrade to Bootstrap 5.3
(#1528)][#1528] from 5.2. This minor Bootstrap release introduces support [color
modes], also called color themes.

As a validation of this upgrade, Docsy has been enhanced to support [dark mode],
the _most upvoted_ Docsy enhancement request ([#331]) prior to this release.

To learn how to enable a **light/dark mode dropdown menu** for your project, see
[Light/dark mode menu]. We have enabled this menu for the Docsy [User Guide], so
if you're reading this post online, give dark mode a try!

[#331]: https://github.com/google/docsy/issues/331
[#1528]: https://github.com/google/docsy/issues/1528
[color modes]: https://getbootstrap.com/docs/5.3/customize/color-modes/
[dark mode]: https://getbootstrap.com/docs/5.3/customize/color-modes/#dark-mode
[Light/dark mode menu]: /docs/adding-content/lookandfeel/#lightdark-mode-menu
[User Guide]: http://localhost:1313/docs/

{{% alert title="Important style changes" %}}

The styling of the following shortcodes and page elements have been adjusted to
ensure that they are compatible with light and dark modes.

You'll needs to **revisit your styles if you customized the SCSS** associated
with these shortcodes and elements.

- [`alert`] ([#1908])
- [`card`] ([#1922])
- [`pageinfo`] ([#1915])
- [Tabbed-pane] shortcodes ([#1920])

The [search box styling][#1896] as well as the [doc-page left-nav][#1908] have
had their styles adjusted as well.

[#1896]: https://github.com/google/docsy/pull/1896
[#1908]: https://github.com/google/docsy/pull/1908
[#1915]: https://github.com/google/docsy/pull/1915
[#1920]: https://github.com/google/docsy/pull/1920
[#1922]: https://github.com/google/docsy/pull/1922
[`alert`]: /docs/adding-content/shortcodes/#alert
[`card`]: /docs/adding-content/shortcodes/#shortcode-card-programming-code
[`pageinfo`]: /docs/adding-content/shortcodes/#pageinfo
[tabbed-pane]: /docs/adding-content/shortcodes/#tabbed-panes

{{% /alert %}}

## Release details

For the complete list of changes in this release, including updates to
FontAwesome, Mermaid, Algolia, and KaTex, see the [0.10.0] release entry and
issue
[Release 0.10.0 preparation (#1759)](https://github.com/google/docsy/issues/1759).

## What's next?

Which Docsy improvements are on the horizon? For work items _tentatively_
planned for the next release, see
[Release 0.11.0 preparation (#1944)](https://github.com/google/docsy/issues/1944).

{{% alert title="Vote" color="primary" %}}

If you'd like a feature or fix to be considered for inclusion in an upcoming
release, remember to upvote (with a thumbs up) the associated issue or PR.

{{% /alert %}}

[CL@0.10.0]: https://github.com/google/docsy/blob/main/CHANGELOG.md/#0100
[0.10.0]: https://github.com/google/docsy/releases/tag/v0.10.0