# Docsy 0.10.0 release report

LLMS index: [llms.txt](/llms.txt)

---

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

> [!IMPORTANT] Reminder
>
> For the official support limits for Docsy and its peer packages, see
> [Official support limits](/project/about/changelog/#official-support).

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/content/lookandfeel/#lightdark-mode-menu
[User Guide]: http://localhost:1313/docs/

> [!NOTE] 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 need 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/content/shortcodes/#alert
> [`card`]: /docs/content/shortcodes/#shortcode-card-programming-code
> [`pageinfo`]: /docs/content/shortcodes/#pageinfo
> [tabbed-pane]: /docs/content/shortcodes/#tabbed-panes

## 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).

> [!NOTE] Vote
>
> 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.

[0.10.0]: https://github.com/google/docsy/releases/tag/v0.10.0