Update ReadTheDocs theme to match Nest light and dark themes

[kasya]

Overview

The ReadTheDocs documentation site currently uses the default theme, which doesn't align with the Nest project's existing light and dark theme designs. Updating the theme to match both light and dark modes will improve visual consistency and user experience across all Nest touchpoints.

Goal

Customize the ReadTheDocs theme configuration to support both light and dark modes that match the existing Nest design system:

• Match the Nest light and dark theme colors and typography as much as possible
• Ensure seamless switching between light and dark modes on the frontend UI
• Maintain consistent branding across all documentation

Details to Consider

• Review current Nest light and dark theme definitions (colors, fonts, component styles)
• Audit ReadTheDocs theme customization options (CSS, theme variables, Sphinx config)
• Test readability and accessibility in both light and dark modes
• Ensure theme switching functionality works smoothly
• Update documentation navigation styling if needed

Acceptance Criteria

• ReadTheDocs light theme visually matches Nest light theme
• ReadTheDocs dark theme visually matches Nest dark theme
• Theme switching between light and dark modes works correctly
• All documentation pages render correctly in both themes
• Accessibility standards (WCAG) are maintained for both themes

[santo-27]

heyyy, i would like to work on this. can you please assign this to me !

[0xgaurav]

Hi @kasya, I'd like to take this issue. I can handle the ReadTheDocs/Sphinx theme customization, align the light/dark styles with Nest's existing design tokens, and test the documentation pages and WCAG contrast in both modes. I’m confident I can complete this end-to-end.

[taditharun]

Hi @kasya , @arkid15r , I'd like to work on this issue. Could you please assign it to me if it's still available? Thank you!

[alromisaaR]

Hi @kasya ! I'd like to take on this issue as part of CAT Reloaded 2026. Could you please assign it to me? Thanks!

[ZeydMhmd]

Hi @kasya ,I’d like to work on this issue as a contestant in CAT Reloaded. Could you please assign it to me? Thanks!