# Proposal: Updating Documentation Theme to Shibuya

**URL:** <https://forums.foundationdb.org/t/proposal-updating-documentation-theme-to-shibuya/5509>\
**Category:** Development\
**Created:** [October 13, 2026, 7:47am UTC](https://forums.foundationdb.org/t/proposal-updating-documentation-theme-to-shibuya/5509 "2026-10-13T07:47:15Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![hwhsu1231](https://sea1.discourse-cdn.com/foundationdb/user_avatar/forums.foundationdb.org/hwhsu1231/32/2119_2.png) [@hwhsu1231](https://forums.foundationdb.org/u/hwhsu1231)\
**Post date:** [October 13, 2026, 7:47am UTC](https://forums.foundationdb.org/t/proposal-updating-documentation-theme-to-shibuya/5509/1 "2026-10-13T07:47:15Z")

</div>

## Proposed Update

Hello FoundationDB Community,

I’d like to share a proposed update to the official documentation theme, migrating to the [Shibuya](https://shibuya.lepture.com/) theme. The pull request for this migration has been submitted:

> <https://github.com/apple/foundationdb/pull/14209>
>
> Replace the \`sphinx-bootstrap-theme\` with the \`shibuya\` theme and update the Sph…inx configuration accordingly:
> 
> \- Set \`html\_theme\` to \`"shibuya"\`
> \- Set \`html\_logo\` to \`"../FDB\_logo.svg"\`
> \- Drop the \`sphinx\_bootstrap\_theme\` import
> \- Drop the \`sphinxcontrib.jquery\` extension
> \- Drop the bootstrap-specific theme options
> \- Add \`discussion\_url\`/\`github\_url\` social links
> \- Add the "Edit this page" link in \`html\_context\`

## Why Shibuya?

To help keep the FoundationDB documentation modern and accessible, I proposed refreshing the documentation theme. Shibuya was selected to address several limitations of the previous setup:

- **Outdated Existing Theme:** The previous Bootstrap theme hasn’t been updated for nearly 4 years, making a refresh long overdue to keep the documentation experience modern and maintainable.
- **Modern Three-Column Layout:** Most modern documentation themes, including Shibuya, adopt a clean three-column layout, which provides much better organization and is significantly more user-friendly for navigating complex guides and references.
- **Dark / Light Mode Support:** Unlike the previous Bootstrap theme which only supported light mode by default, Shibuya natively supports both dark and light modes to suit reader preferences and reduce eye strain.

## Screenshots / Recordings

 ![Dark Mode on Desktop Layout](https://global.discourse-cdn.com/foundationdb/original/2X/c/c93a1a220ac4fea4bb83f0e3d635bc82b7396793.png)

 ![Light Mode on Desktop Layout](https://global.discourse-cdn.com/foundationdb/original/2X/9/9643e3aae418b75cadb55b7135a878b3d8a87869.png)

![Mobile Layout](https://global.discourse-cdn.com/foundationdb/original/2X/e/e6d7b173cf37c73fc609a5c1ae0e51b0d342cb59.gif)