[Feature]: Add Theme Toggler to CapacitorJS Homepage

[KhanjarSingh]

Description

The CapacitorJS main website (https://capacitorjs.com) currently does not include a theme toggler for switching between light and dark modes. Most modern developer documentation sites provide a theme switcher to improve accessibility, readability, and user customization.

Platforms

• iOS
• Android
• Web

Request or proposed solution

A theme toggle button (Light / Dark / System Default) should be added to the homepage header or navigation bar.
The theme preference should persist between sessions using localStorage (or a similar mechanism) and respect the system setting via prefers-color-scheme.

Preferred Solution:

• Add a theme toggler component consistent with the existing Capacitor site design.
• Ensure the theme change applies globally and smoothly transitions between modes.
• Store and restore the user’s theme preference automatically.

Alternatives

• Continue using the default light theme (less user-friendly in dark environments).
• Rely on browser extensions or OS-level dark mode inversion (inconsistent results).

Additional Information

Implementing a theme toggler will bring visual consistency with other modern web frameworks and documentation platforms (e.g., Ionic, React, and Vite).
It enhances the developer experience and aligns with accessibility best practices.

[KhanjarSingh]

I’ve created this issue because I’d love to contribute this feature myself.
Please assign this issue to me — I’d be happy to work on adding the theme toggler for the CapacitorJS homepage. 🙌

[eric-horodyski]

Hi @KhanjarSingh, please feel free to contribute this! No assignment necessary 😁.

However, you would do best to implement it in our Capacitor Docs repository instead of here.

That said, I'll go ahead and close this issue and look forward to your PR on the Capacitor Docs repo. Thanks!!

[ionitron-bot]

Thanks for the issue! This issue is being locked to prevent comments that are not relevant to the original issue. If this is still an issue with the latest version of Capacitor, please create a new issue and ensure the template is fully filled out.