Goals

Short list of the problems that the feature request aims to address.

1. Provide users with an accessible way to switch between light and dark themes.
2. Improve readability and reduce eye strain for developers browsing documentation at night.
3. Maintain UI consistency with other Vercel ecosystem sites (Next.js, Vercel Docs, etc.) that already support theme toggling.

Non-goals

Short list of what the feature request does not aim to address.

1. Full redesign or rebranding of the Turborepo documentation UI.
2. Changes to core documentation content or structure.
3. Custom theme creation by end-users beyond the standard light/dark toggle.

Background

Discuss prior art and provide context around your idea. Why do you think this feature is needed? Are there current alternatives?

Currently, the Turborepo documentation site
uses a fixed theme with no option for light/dark mode switching. Many developer-oriented sites (such as Next.js Docs, TailwindCSS Docs, and Vercel Docs) provide a theme toggler, allowing users to choose their preferred visual mode.

Having a theme toggler improves accessibility, enhances user experience, and ensures consistent UI design across the Vercel product ecosystem.

There is no native workaround available right now for users who prefer dark mode when browsing the documentation.

Proposal

How should this feature be implemented? Are you interested in contributing?
Implement a simple theme toggler button in the top navigation bar or sidebar.
Use next-themes or a similar lightweight library to manage light/dark theme persistence via local storage.
Follow Vercel’s design guidelines for visual consistency.
Add smooth transition effects for better UX when switching themes.
Example (conceptual implementation in React/Next.js)