# Custom themes (graphics-only)

Ecosistema temi caricati a **runtime** (niente rebuild del client). Un tema =
una cartella con un manifest + "pezzi" CSS. Ogni pezzo è attivabile/disattivabile
dall'utente da **Impostazioni → Temi** (checkbox). Se un pezzo è rotto/404 →
fallback automatico al default (solo quel pezzo).

## Dove vivono
- **Questa cartella (`custom-themes/`) è solo il TEMPLATE di riferimento**, versionata su git.
- I temi **veri** stanno sul server in `public/octane/custom-themes/` (serviti via
  l'url configurato in ui-config `theme.base.url`, es. `/client/octane/custom-themes`).
  NON vanno su git → vedi `.gitignore` (`public/custom-themes/`).

## Struttura
```
custom-themes/
  index.json                 # { "themes": [ { "id", "name", "author?" } ] }
  <id>/
    theme.json               # { "name", "pieces": [ { "id", "name", "file" } ] }
    cards.css  chat.css  ...  # un file per "pezzo"
    assets/...               # immagini referenziate dai CSS (url assoluti)
```

## Creare un tema
1. Copia `neon-viola/` in una nuova cartella `<id>/`.
2. Modifica `theme.json` (nome + elenco pezzi).
3. Scrivi i CSS dei pezzi (override con `!important`, caricati dopo il base).
4. Aggiungi `{ "id": "<id>", "name": "..." }` a `index.json`.
5. Carica la cartella in `public/octane/custom-themes/` sul server. **Nessun rebuild.**

## Default hotel-wide (admin)
In `ui-config.json`:
- `theme.base.url`  → dove sono serviti i temi
- `theme.default`   → id del tema attivo di default (vuoto = nessuno)
- `theme.default.pieces` → array di id pezzi attivi di default

Ogni utente può comunque sovrascrivere da Impostazioni → Temi (salvato in localStorage).

> Nota: i temi ri-skinnano solo la **grafica** (CSS). Non cambiano la struttura
> dei componenti né il comportamento.