Ein Theme gestaltet die Plattform über zwei stabile Schnittstellen:
  1. Design-Tokens – CSS-Variablen für Farben, Schriften und Rundungen. Sie decken die meisten Wünsche ab und überstehen jedes Update.
  2. data-ui-Haken – Attribute an Schlüsselstellen (Kopfleiste, Knöpfe, Karten …) für Gestaltung, die über Tokens hinausgeht.
Nur diese beiden gelten als Vertrag. CSS-Klassen und HTML-Struktur der Anwendung können sich mit jedem Release ändern; Regeln, die sich darauf stützen, brechen früher oder später. Am schnellsten beginnen Sie mit einer Kopie: Im Plattform-Admin unter Darstellung liefert Kopie herunterladen ein mitgeliefertes Theme mit eigenem Schlüssel als ZIP-Datei (siehe Kopie als Startpunkt); alternativ das kommentierte Beispiel-Theme. Ändern, packen, wieder hochladen – die neue Fassung ersetzt die vorige, die sich mit einem Klick wiederherstellen lässt.

Wie theme.css wirkt

Die Plattform bindet theme.css nach ihrem eigenen CSS ein. Das CSS der Anwendung liegt vollständig in CSS-Cascade-Layern, theme.css dagegen in keinem Layer – deshalb gewinnt theme.css immer, unabhängig von der Spezifität der Regeln der Anwendung. !important ist nie nötig. Spezifität spielt nur innerhalb von theme.css eine Rolle. Im HTML stehen dafür:
Der Pfadteil nach dem Schlüssel ist die Version (aus dem Inhalt aller Dateien); relative Adressen in theme.css (url('fonts/…')) erben sie. data-theme ist die Wahl des Mitglieds; ohne eigene Wahl der defaultMode des Themes.

Design-Tokens

Ein Theme setzt die Tokens auf :root. Werte für hell und dunkel stehen mit light-dark(hell, dunkel) in einer Zeile. Alle übrigen Farben – Texte, Ränder, graue Flächen, Statusfarben wie Rot, Grün und Gelb – stammen aus der eingebauten Farbpalette (Tailwind CSS: --color-slate-50 … --color-slate-950, --color-red-… usw.). Im dunklen Modus spiegelt die Plattform diese Palette automatisch: Weiß wird zur Kartenfarbe, die Grautöne kehren sich um, helle Farbtöne (50–300) tauschen mit den dunklen (700–950). Die Standardwerte der Tokens verweisen auf die Palette und schalten deshalb von selbst mit.
Diese Spiegelung können Sie nutzen: --color-primary: var(--color-teal-700); ergibt hell ein dunkles Petrol und dunkel automatisch ein helles Türkis. Gespiegelt werden die Farbfamilien slate, red, orange, amber, yellow, green, emerald, teal, sky, blue, indigo, violet, pink und rose, jeweils nur die Stufen 50–300 und 700–950. Die Stufen 400–600 bleiben in beiden Modi gleich.

Hell, dunkel und Systemeinstellung

Mitglieder wählen in der Kopfleiste hell, dunkel oder „wie das System“. Wer nichts gewählt hat, bekommt den defaultMode aus theme.json. Im dunklen Modus (ausdrücklich gewählt oder vom System) setzt die Plattform color-scheme: dark; darauf reagiert light-dark(). Gedruckt wird immer hell. Ist ein Theme immer dunkel (dunkle Flächen auch im hellen Modus, ohne light-dark()), setzt es selbst color-scheme: dark in @media not print { :root { … } }. Sonst zeigt der Browser Datumswähler, Bildlaufleisten und automatisch ausgefüllte Felder hell auf der dunklen Seite. Aufgeklappte Auswahllisten und den Knopf „Datei auswählen“ färbt die Plattform selbst mit --color-surface und --color-ink. Farben je Modus – eine Zeile, beide Werte:
light-dark() funktioniert für alle Farbangaben, auch innerhalb von linear-gradient(…), box-shadow oder border, aber nur für Farben. Alles andere je Modus (z. B. ein anderes Hintergrundbild) und Paletten-Farben (--color-slate-…, --color-white) brauchen beide Selektoren – sonst greift die Einstellung „wie das System“ nicht:
Paletten-Variablen (--color-slate-…, --color-white, --color-blue-… usw.) nie ohne Modus-Selektor direkt auf :root setzen. Weil theme.css immer gewinnt, würde der Wert die automatische Spiegelung des dunklen Modus überschreiben und in beiden Modi gelten – im dunklen Modus wird dann z. B. Text unlesbar.

Schriften

Ohne Schriftdateien: Schriften, die auf praktisch jedem Gerät vorhanden sind, kosten keine Ladezeit und keine Lizenzprüfung. Das Beispiel-Theme setzt Überschriften so in einer Serifenschrift:
Eigene Schrift selbst hosten:
  1. Die Schrift als .woff2 ins Theme legen, z. B. fonts/inter-latin-400.woff2 und fonts/inter-latin-700.woff2. Nur die benötigten Schnitte und Zeichensätze (meist „latin“) einbinden – jede Datei kostet Ladezeit.
  2. Die Lizenz prüfen und als Datei danebenlegen. Schriften unter der SIL Open Font License (OFL, z. B. viele Schriften von Google Fonts) dürfen selbst gehostet werden; die Datei OFL.txt gehört dazu. Kommerzielle Schriften brauchen eine Lizenz für die Verwendung im Web („Webfont“).
  3. In theme.css einbinden – die Adresse ist relativ zur CSS-Datei:
  4. Den wichtigsten Schnitt (meist den normalen) in theme.json unter fonts mit preload eintragen; die Plattform lädt ihn dann früh (<link rel="preload">) und der Text springt beim Laden nicht um:
Emoji in Beiträgen, Kommentaren, Nachrichten und Eingabefeldern zeigt die Plattform etwas größer als den Text – mit der Emoji-Schrift des Geräts, unabhängig von der Theme-Schrift. Setzt Ihr Theme selbst eine font-family auf solchen Text (z. B. .prose blockquote), schreiben Sie font-family: var(--font-emoji), var(--font-display);, sonst bleiben Emoji dort in normaler Größe.
Schriften nicht von Google Fonts, Adobe Fonts oder einem anderen fremden Server einbinden. Die Content-Security-Policy der Plattform lässt nur Dateien vom eigenen Server zu, der Browser blockiert fremde Schriften. Selbst gehostete Schriften übertragen außerdem keine Besucherdaten an Dritte.

Logo, Favicon und App-Icons

  • Logo (logo, optional logoDark): SVG, PNG oder WebP. Es wird in der Kopfleiste auf 2 rem (32 px) Höhe skaliert, die Breite ergibt sich aus dem Seitenverhältnis. Breite Logos mit Schriftzug funktionieren gut; dann "showName": false, damit der Plattformname nicht doppelt erscheint. Ein quadratisches Bildzeichen passt zu "showName": true.
  • Dunkler Modus: Ein Logo mit dunkler Schrift verschwindet auf dunklem Grund. Mit logoDark zeigt die Plattform im dunklen Modus eine zweite Fassung.
  • Favicon (favicon): SVG oder PNG, quadratisch.
  • App-Icons (icons): PNG in 192 × 192 und 512 × 512 Pixeln für die installierte App (PWA) und den Startbildschirm von iPhones. Motiv mit etwas Rand gestalten, Android schneidet Icons rund oder abgerundet zu.
  • themeColor / backgroundColor: Farbe der Browserleiste auf Mobilgeräten und des Startbildschirms der installierten App – sinnvollerweise die Hauptfarbe bzw. die Seitenfarbe des Standardmodus.
SVG-Dateien werden als Bild eingebunden; Skripte darin laufen nicht. Beim Hochladen prüft die Plattform jede SVG-Datei zusätzlich (kein <script>, keine Ereignis-Attribute wie onload, kein <foreignObject>, keine Verweise auf fremde Adressen, kein DOCTYPE) und liefert sie mit einer Sicherheitsrichtlinie aus, die auch beim direkten Aufruf jedes Skript unterbindet. Grafikprogramme speichern gelegentlich Metadaten oder Verweise mit; „Als optimiertes SVG speichern“ bzw. ein Werkzeug wie SVGO entfernt sie. SVG geht nur über ein Theme – im Plattform-Admin lassen sich als eigenes Logo nur PNG, WebP und JPEG hochladen (siehe Darstellung). Ein hochgeladenes Logo hat Vorrang vor dem Logo des Themes.

data-ui-Haken

Für Gestaltung über die Tokens hinaus tragen Schlüsselstellen ein data-ui-Attribut. Selektoren der Form [data-ui='header'] sind stabil. Gestaltung über Haken gehört in @media screen { … }, damit Zertifikate, Nachweise und andere Druckseiten sauber und hell drucken.

Rezepte

Alle Rezepte stehen auch auskommentiert im Beispiel-Theme.

Primärfarbe ändern

Immer --color-on-primary mitprüfen: Text auf der Hauptfarbe braucht in beiden Modi mindestens 4,5 : 1 Kontrast (siehe Kontrast). Helle Hauptfarben (Gelb, Türkis, Hellgrün) brauchen dunklen Text.

Rundungen und Pillen-Knöpfe

Eckig: alle Werte auf 0.

Eigene Überschriften-Schrift

Die Schrift selbst hosten wie unter Schriften beschrieben.

Gläserne Kopfleiste

Farbverlauf im Seitentitel

Beide Verlaufsfarben müssen für sich genug Kontrast zum Hintergrund haben.

Dunkler Standard

In theme.json startet das Theme dunkel; Mitglieder können trotzdem auf hell umschalten:
Wer den dunklen Modus zusätzlich umfärben will (z. B. bläulicher statt grau), setzt die Paletten-Farben mit beiden Selektoren wie unter Hell, dunkel und Systemeinstellung gezeigt. Das mitgelieferte Theme mitternacht ist ein vollständiges Beispiel.

Hintergrundbild im Kopfbereich öffentlicher Seiten

Bilder nur aus dem Theme-Verzeichnis (url('hero.webp')) oder als data:-Adresse. Die dunkle Überlagerung hält den Text lesbar; auf dem Bild selbst ist der Kontrast sonst nicht vorhersehbar. Owner und Admins einer Community können in ihren Einstellungen (Allgemein → Logo und Farbe) ein eigenes Logo hochladen (PNG, WebP oder JPEG bis 2 MB) und die Primärfarbe übersteuern – getrennt für hell und dunkel. Alles andere (Flächen, Text, Links, Fokus, Schriften, Rundungen, Haken-Gestaltung) bleibt beim Theme. Die Farbe gilt nur auf den Seiten dieser Community, Startseite, Verzeichnis, Konto und Plattform-Admin behalten die Farbe des Themes. So spielt das mit Ihrem Theme zusammen:
  • Die Plattform liefert für die Community eine eigene kleine CSS-Datei aus, die nach theme.css geladen wird und nur --color-primary, --color-primary-hover und --color-on-primary setzt – mit dem Selektor :root[data-community][data-theme]. Damit gewinnt die Community-Farbe gegen die Primärfarbe des Themes.
  • Verwenden Sie in eigenen Regeln var(--color-primary) statt eines festen Farbwerts (wie in den Rezepten oben). Dann folgen auch Ihre Haken-Gestaltungen – Schatten, Ränder, Verläufe – der Farbe der Community.
  • Setzen Sie die Primär-Tokens nicht mit noch spezifischeren Selektoren; sonst kann eine Community ihre Farbe nicht mehr durchsetzen.
  • Die Plattform prüft die Community-Farbe beim Speichern gegen die Flächen- und Seitenfarbe des aktiven Themes (Beschriftung 4,5 : 1, Primärfarbe auf Fläche und Seite 3 : 1). Hover-Farbe und Beschriftung (Schwarz oder Weiß) leitet sie selbst ab. Grundlage sind die Farben aus dem Theme-Editor; bei Themes, die nicht mit dem Editor erstellt wurden, prüft sie gegen die Standardfarben.
  • Das Community-Logo erscheint in der Kopfleiste neben dem Plattform-Logo ([data-ui='community-logo']), auf Landingpage und „Über uns“ und auf den Karten des Verzeichnisses. Für Vorschaubilder in sozialen Netzwerken (og:image) setzt die Plattform das Logo auf die helle Seitenfarbe Ihres Themes.
Wechseln Sie später das Theme, bleiben gespeicherte Community-Farben bestehen. Prüfen Sie dann stichprobenartig einige Communities mit eigener Farbe; deren Owner sehen in den Einstellungen sofort, ob der Kontrast zum neuen Theme noch reicht.

Kontrast und Barrierefreiheit

Richtwert ist WCAG 2.2, Stufe AA: Worauf Sie achten sollten:
  • Paare in beiden Modi prüfen: --color-on-primary auf --color-primary, --color-link auf --color-page und --color-surface, --color-ink auf --color-page – jeweils hell und dunkel.
  • Fokus sichtbar halten: --color-focus nie transparent oder in Hintergrundfarbe. Tastaturnutzer erkennen nur am Rahmen, wo sie sind.
  • Transparenz und Verläufe: Gläserne Flächen und Farbverläufe verändern den Kontrast je nach Untergrund. An der ungünstigsten Stelle messen.
  • Nicht nur über Farbe: Eigene Gestaltung sollte Zustände nicht allein über Farbe unterscheiden und vorhandene Merkmale wie Unterstreichungen, Ränder oder Symbole nicht entfernen.
  • Bewegung: Animationen nur in @media (prefers-reduced-motion: no-preference) { … }.
  • Messen: Die Entwicklerwerkzeuge von Chrome, Edge und Firefox zeigen beim Untersuchen eines Elements das Kontrastverhältnis an; für Farbpaare eignen sich Kontrastrechner nach WCAG.
Das Beispiel-Theme hält AA ein: Petrol #0f766e mit weißer Schrift 5,5 : 1, Petrol auf dem Seitenhintergrund #f6f5f2 5,0 : 1; im dunklen Modus Türkis #2dd4bf mit Schrift #042f2e 7,8 : 1.

Sicherheitsregeln (CSP)

Die Content-Security-Policy der Plattform gilt auch für Themes. Was sie verletzt, blockiert der Browser – meist ohne sichtbare Fehlermeldung, nur in der Konsole:
  • Stylesheets, Schriften und Bilder nur vom eigenen Server: aus dem Theme-Verzeichnis (relativ, z. B. url('fonts/inter.woff2')) oder als data:-Adresse für Bilder und Schriften. Keine Google Fonts, keine CDNs, kein @import. Das prüft schon der Upload und nennt Datei und Zeile.
  • Kein JavaScript – weder als Datei noch in SVG-Grafiken (SVG-Logos werden als Bild eingebunden, Skripte darin laufen nicht).
  • Alles CSS in theme.css; das Theme kann keine style-Attribute in Seiten einfügen.