This repository has been archived on 2026-09-17. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
nixos-config/docs/intent/web-ui-system-darkmode.md

1.9 KiB

Intent: Systemgesteuerter Darkmode für die Weboberfläche

Ziel

Die gesamte Weboberfläche soll automatisch die Darkmode-Präferenz des Betriebssystems beziehungsweise Browsers übernehmen.

Umfang

  • Darkmode für sämtliche Bereiche und Komponenten der Weboberfläche umsetzen.
  • Bei bevorzugtem hellem Systemfarbschema die bestehende helle Darstellung verwenden.
  • Bei bevorzugtem dunklem Systemfarbschema eine konsistente dunkle Darstellung verwenden.
  • Änderungen der Systempräferenz während einer laufenden Nutzung ohne Neuladen der Seite unmittelbar übernehmen.
  • Die Darstellung für Text, Flächen, Bedienelemente, Hinweise und interaktive Zustände im jeweiligen Farbschema lesbar und konsistent gestalten.

Explizit ausgeschlossen

  • Manueller Umschalter innerhalb der Anwendung.
  • Speicherung einer Farbschema-Auswahl pro Nutzer, Browser oder Sitzung.
  • Von der Systempräferenz abweichende individuelle Theme-Einstellungen.

Annahmen

  • Die Weboberfläche verfügt bereits über eine helle Standarddarstellung.
  • Der Browser stellt die Systemfarbschema-Präferenz bereit.
  • Bestehende Marken-, Layout- und Funktionsvorgaben bleiben unverändert, soweit sie nicht zur Unterstützung des dunklen Farbschemas angepasst werden müssen.

Offene Risiken

  • Einzelne Komponenten, externe Inhalte oder fest codierte Farben könnten im Darkmode unlesbar oder inkonsistent sein.
  • Ältere Browser unterstützen die Erkennung oder Laufzeitänderung der Systempräferenz möglicherweise nur eingeschränkt.

Erfolgskriterien

  • Die gesamte Weboberfläche erscheint bei dunkler Systempräferenz im Darkmode und bei heller Präferenz im Lightmode.
  • Ein Wechsel der Systempräferenz aktualisiert die offene Weboberfläche sofort und ohne Neuladen.
  • Es gibt keinen manuellen Theme-Umschalter und keine persistierte Theme-Auswahl.
  • Inhalte, Bedienelemente und Zustände sind in beiden Farbschemata gut lesbar und nutzbar.