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

37 lines
1.9 KiB
Markdown

# 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.