---
title: "Theme gestalten"
description: "Design-Tokens, hell und dunkel, Schriften, Logo, data-ui-Haken, Rezepte und Kontrast"
---

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](/anpassen/themes#kopie-eines-vorhandenen-themes-als-startpunkt)); alternativ das kommentierte [Beispiel-Theme](/downloads/beispiel-theme.zip). Ä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:

```html
<html data-template="meine-marke" data-theme="light | dark | system">
<link rel="stylesheet" href="/themes/_u/meine-marke/3f9c0a1b2d/theme.css">
```

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.

| Token | Wirkung | Standard hell | Standard dunkel |
| --- | --- | --- | --- |
| `--color-primary` | Hauptknöpfe, aktive Navigation, aktive Filter und Tabs, Fortschrittsbalken, eigene Chat-Blasen, „heute“ im Kalender, Avatar-Initialen in der Kopfleiste | `#0f172a` (Schiefer 900) | ≈ `#f1f5f9` |
| `--color-primary-hover` | Hover der Hauptknöpfe | `#334155` | ≈ `#cbd5e1` |
| `--color-on-primary` | Text und Symbole auf der Hauptfarbe | `#ffffff` | ≈ `#0f172a` |
| `--color-link` | Links im Fließtext (Beiträge, Lektionen, Rechtstexte) | `#1d4ed8` | ≈ `#93c5fd` |
| `--color-focus` | Fokus-Rahmen bei Tastaturbedienung, Fokus-Rand von Eingabefeldern | `#0f172a` | ≈ `#f1f5f9` |
| `--color-page` | Seitenhintergrund | `#f8fafc` | ≈ `#020617` |
| `--color-surface` | Karten, Menüs, Dialoge, Eingabefelder, Sekundärknöpfe | `#ffffff` | ≈ `#0f172a` |
| `--color-header` | Kopfleiste | `#ffffff` | ≈ `#0f172a` |
| `--color-ink` | Grundtextfarbe | `#0f172a` | ≈ `#f1f5f9` |
| `--color-bubble` | Fläche der Chat-Blasen anderer Personen; folgt Grundtext und Kartenfarbe, muss meist nicht gesetzt werden | 10 % Grundtext auf Kartenfarbe | ebenso |
| `--color-bubble-edge` | Rand der Chat-Blasen anderer Personen, mindestens 3:1 zur Kartenfarbe | 50 % Grundtext auf Kartenfarbe | ebenso |
| `--font-sans` | Grundschrift | Systemschrift (`ui-sans-serif, system-ui, …`) | wie hell |
| `--font-display` | Überschriften `h1`–`h4` | `var(--font-sans)` | wie hell |
| `--radius-button` | Knöpfe, Navigationseinträge, Filter-Pillen | `0.375rem` | wie hell |
| `--radius-field` | Eingabefelder, Auswahllisten, Textfelder | `0.375rem` | wie hell |
| `--radius-card` | Karten, Listen-Boxen, Aufklappmenüs | `0.5rem` | wie hell |
| `--radius-panel` | große Boxen: Anmeldekarte, Kontoseite, Dialoge, Plan-Karten | `0.75rem` | wie hell |
| `--radius-hero` | Kopf- und Inhaltsflächen öffentlicher Seiten (Landingpage, Über uns, Rechtstexte) | `1rem` | wie hell |

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.

<Tip>
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.
</Tip>

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

```css
:root {
  --color-primary: light-dark(#0f766e, #2dd4bf);
  --color-page: light-dark(#f6f5f2, #020617);
}
```

`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:

```css
@media not print {
  :root[data-theme='dark'] {
    --color-white: #10201f;
    --color-slate-50: #08100f;
  }
  @media (prefers-color-scheme: dark) {
    :root[data-theme='system'] {
      --color-white: #10201f;
      --color-slate-50: #08100f;
    }
  }
}
```

<Warning>
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.
</Warning>

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

```css
:root {
  --font-display: 'Iowan Old Style', 'Palatino Linotype', Palatino, 'URW Palladio L', P052, Georgia, ui-serif, serif;
}
```

**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:

   ```css
   @font-face {
     font-family: 'Inter';
     src: url('fonts/inter-latin-400.woff2') format('woff2');
     font-weight: 400;
     font-style: normal;
     font-display: swap;
   }
   @font-face {
     font-family: 'Inter';
     src: url('fonts/inter-latin-700.woff2') format('woff2');
     font-weight: 700;
     font-style: normal;
     font-display: swap;
   }
   :root {
     --font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;
   }
   ```

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:

   ```json
   "fonts": [{ "family": "Inter", "preload": "fonts/inter-latin-400.woff2" }]
   ```

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.

<Warning>
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.
</Warning>

## 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](/handbuch/plattform-admin/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.

| Haken | Wo | Beispiel |
| --- | --- | --- |
| `header` | Kopfleiste (`<header>`) | `border-top: 3px solid var(--color-primary);` |
| `brand` | Link mit Logo und Plattformname; der Name steckt in `[data-ui='brand-name']` | `[data-ui='brand-name'] { font-family: var(--font-display); }` |
| `logo` | Bild des Logos (bei `logoDark` zwei Bilder) | `height: 2.25rem;` |
| `nav` | Bereichsleiste einer Community (Feed, Kurse, Kalender …) | `gap: 0.5rem;` |
| `nav-link` | Eintrag der Bereichsleiste; aktiv: `[aria-current='page']`, gesperrt: `[aria-disabled='true']` | `text-transform: uppercase;` |
| `nav-more` | Knopf „Mehr“ der Bereichsleiste; erscheint auf breiten Bildschirmen nur, wenn nicht alle Einträge in die Zeile passen | `text-transform: uppercase;` |
| `nav-more-menu` | Menü hinter „Mehr“ mit den Einträgen (`nav-link`), die aus der Zeile weichen | `min-width: 14rem;` |
| `nav-burger` | Menüknopf der Kopfleiste auf schmalen Bildschirmen (unter 1024 px); öffnet die Bereichsleiste als Liste, offen: `[aria-expanded='true']` | `border: 1px solid currentColor;` |
| `menu` | Aufklappmenüs (Benutzermenü, Benachrichtigungen, Auswahllisten) | `box-shadow: 0 12px 32px -12px rgb(0 0 0 / 0.25);` |
| `main` | Hauptbereich (`<main>`) | `padding-block: 2rem;` |
| `page-title` | Seitenüberschrift (`h1`) | `letter-spacing: -0.02em;` |
| `button-primary` | Hauptknopf | `font-weight: 600;` |
| `button-secondary` | Sekundärknopf mit Rand | `border-width: 2px;` |
| `button-ghost` | Knopf ohne Rand und Fläche | `text-decoration: underline;` |
| `button-danger` | Knöpfe zum Löschen oder Beenden | `font-weight: 600;` |
| `card` | Karten und Boxen, Inhaltsflächen von Rechtstexten und Landingpage-Blöcken | `box-shadow: 0 8px 24px -12px rgb(15 23 42 / 0.12);` |
| `auth-card` | Karte von Anmelden, Registrieren, Passwort, Zwei-Faktor, Fehler- und Wartungsseite | `max-width: 28rem;` |
| `hero` | Kopfbereich von Community-Landingpage, Über uns, öffentlichem Beitrag, Hero-Block von Landingpages, Begrüßung der Startseite | `background-image: url('hero.webp');` |
| `infobox` | formatierter Text im Kopf der Community-Landingpage und der Startseite (Absätze, Zwischenüberschriften, Listen, Zitat, Links, in Communities Bilder). Die Farben kommen aus den Tokens `--color-ink`, `--color-link` und der Graupalette – färbst du den Kopf dunkel, setze diese Tokens dort mit | `[data-ui='infobox'] h2 { letter-spacing: 0.02em; }` |
| `dialog` | modale Dialoge | `border-radius: 1.5rem;` |
| `footer` | Fußbereich | `font-size: 0.75rem;` |
| `social-links` | Links zu den Kanälen der Community bzw. Plattform: Symbolzeile unter dem Hero und auf der Startseite, Liste auf „Über uns“ und im Landingpage-Baustein, kleine Symbole im Footer, Karte „Folge uns“ im Feed. Variante in `data-variant` (`icons`, `list`, `footer`), jeder Link mit `data-link-type` (z. B. `youtube`) | `[data-ui='social-links'] a { color: var(--color-primary); }` |
| `community-brand` | Link zur Community in der Kopfleiste (neben `brand`, nur auf Seiten einer Community) mit Logo `[data-ui='community-logo']` | `[data-ui='community-logo'] { height: 2.25rem; }` |
| `community-logo` | Logo einer Community (Kopfleiste, Landingpage, Über uns) | `border-radius: 0.5rem;` |
| `community-card-logo` | Logo bzw. Initiale auf den Karten des Verzeichnisses `/communities` und der Startseite | `border-radius: 9999px;` |
| `footer-text` | Zeile im Fußbereich: die des Betreibers auf Seiten ohne Community, die der Community auf ihren Seiten (jeweils Darstellung → Texte) | `font-weight: 500;` |
| `footer-promo` | Zeile „läuft mit QuickTribe“ mit der Versionsangabe – darf nicht ausgeblendet oder unlesbar gemacht werden | `font-style: italic;` |
| `external-post` | Karte eines externen Feeds zwischen den Beiträgen im Feed (gestrichelter Rand auf `bg-page`, Plakette „Extern · …“) | `border-left: 3px solid var(--color-primary);` |

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](/downloads/beispiel-theme.zip).

### Primärfarbe ändern

```css
:root {
  --color-primary: light-dark(#0f766e, #2dd4bf);
  --color-primary-hover: light-dark(#115e59, #5eead4);
  --color-on-primary: light-dark(#ffffff, #042f2e);
  --color-focus: light-dark(#0f766e, #5eead4);
}
```

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

### Rundungen und Pillen-Knöpfe

```css
:root {
  --radius-button: 9999px; /* Pillen */
  --radius-field: 0.75rem;
  --radius-card: 1rem;
  --radius-panel: 1.25rem;
  --radius-hero: 1.5rem;
}
```

Eckig: alle Werte auf `0`.

### Eigene Überschriften-Schrift

```css
:root {
  --font-display: 'Space Grotesk', var(--font-sans);
}
@media screen {
  [data-ui='page-title'] { letter-spacing: -0.02em; }
}
```

Die Schrift selbst hosten wie unter [Schriften](#schriften) beschrieben.

### Gläserne Kopfleiste

```css
@media screen {
  [data-ui='header'] {
    background: light-dark(rgb(255 255 255 / 0.75), rgb(15 23 42 / 0.65));
    backdrop-filter: blur(12px);
  }
}
```

### Farbverlauf im Seitentitel

```css
@media screen {
  [data-ui='page-title'] {
    background: linear-gradient(90deg, light-dark(#0f766e, #2dd4bf), light-dark(#0e7490, #67e8f9));
    -webkit-background-clip: text;
    background-clip: text;
    color: transparent;
  }
}
```

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:

```json
{
  "defaultMode": "dark",
  "themeColor": "#0b1020",
  "backgroundColor": "#0b1020"
}
```

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](#hell-dunkel-und-systemeinstellung) gezeigt. Das mitgelieferte Theme `mitternacht` ist ein vollständiges Beispiel.

### Hintergrundbild im Kopfbereich öffentlicher Seiten

```css
@media screen {
  [data-ui='hero'] {
    background-image: linear-gradient(rgb(0 0 0 / 0.45), rgb(0 0 0 / 0.45)), url('hero.webp');
    background-size: cover;
    background-position: center;
  }
}
```

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.

## Communities mit eigener Farbe und eigenem Logo

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:

| Was | Mindestkontrast |
| --- | --- |
| Fließtext und kleine Schrift | 4,5 : 1 |
| Große Schrift (ab 24 px oder 18,5 px fett) | 3 : 1 |
| Bedienelemente und Fokus-Rahmen gegenüber ihrer Umgebung | 3 : 1 |

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.
