# Was Du Tun Musst

## 1. Theme nach Keycloak kopieren

Den Ordner

- `CopyToKeycloak/theme/kusche-desktop`

in das Keycloak-Themes-Verzeichnis kopieren.

Typische Ziele:

- Container: `/opt/keycloak/themes/`
- VM/Bare Metal: `<KEYCLOAK_HOME>/themes/`

Danach muss dort existieren:

- `/opt/keycloak/themes/kusche-desktop/login/theme.properties`

## 2. Keycloak neu laden

Wenn du in Entwicklung arbeitest:

- Keycloak neu starten

Wenn du in Produktion Theme-Caches aktiv hast:

1. Keycloak stoppen oder neu starten
2. falls noetig Theme-Cache loeschen:
   - `data/tmp/kc-gzip-cache`

## 3. Theme nur fuer den Desktop-Client setzen

In Keycloak:

1. Realm `KuscheBerlin` oeffnen
2. Client `desktop-kusche-berlin` oeffnen
3. Die Login-Theme-Override fuer den Client auf `kusche-desktop` setzen

Wichtig:

- Das Theme soll **nicht** pauschal als Realm-Login-Theme fuer alle Clients gesetzt werden, wenn andere Clients das Standard-Keycloak-Login behalten sollen.

Falls deine Keycloak-Version im Client-UI keine direkte Login-Theme-Auswahl anzeigt:

- pruefen, ob die Client-spezifische Login-Theme-Option in den Client-Einstellungen / Advanced Settings vorhanden ist
- falls nicht vorhanden, bleibt als saubere Alternative nur:
  - eigener Realm fuer Desktop
  - oder spaeter ein Theme Selector SPI

## 4. Testen

Danach testen:

1. `https://staging.desktop.kusche.berlin`
2. `https://desktop.kusche.berlin`

Erwartung:

- fuer den Client `desktop-kusche-berlin` erscheint das neue Desktop-Login-Theme
- nach erfolgreichem Login geht es zur Desktop-Shell zurueck

## 5. Falls das Theme nicht erscheint

Dann diese Punkte pruefen:

- Theme-Ordner liegt wirklich im Keycloak-`themes/`-Verzeichnis
- Verzeichnisname ist exakt `kusche-desktop`
- `theme.properties` liegt unter `kusche-desktop/login/`
- Keycloak wurde nach dem Kopieren neu gestartet
- Cache wurde geleert
- wirklich der Client `desktop-kusche-berlin` wird verwendet

## 6. Welche Datei du spaeter bei Aenderungen ersetzt

Wenn du nur Styling aendern willst, reicht meist:

- `theme/kusche-desktop/login/resources/css/desktop-kusche.css`

Wenn du die Struktur aendern willst:

- `theme/kusche-desktop/login/login.ftl`

## 7. Was ich bewusst nicht fuer dich serverseitig tue

Diese Schritte musst du selbst auf dem Keycloak-System machen:

- Dateien nach Keycloak kopieren
- Keycloak neu starten
- Client-Theme-Override setzen

Das Projekt hier erzeugt nur den fertigen Theme-Ordner.