# Référence de l'habillage

> Champs d'habillage par niveau, formats et limites des fichiers, objet thème et réponses des appels de l'API publique.

Cette page rassemble les valeurs de référence de l'habillage. Les endpoints complets sont décrits dans la [référence API des contenus de l'application](/v1.0/reference-api/contenus-application).

## Visuels

| Visuel | Champ renvoyé | Formats | Taille maximale | Niveaux |
|---|---|---|---|---|
| Logo mode clair | `logoLightUrl` | PNG, WebP | 2 Mo | application, réseau, client |
| Logo mode sombre | `logoDarkUrl` | PNG, WebP | 2 Mo | application, réseau, client |
| Fond mode clair | `bgLightUrl` | PNG, WebP | 2 Mo | application, réseau, client |
| Fond mode sombre | `bgDarkUrl` | PNG, WebP | 2 Mo | application, réseau, client |
| Favicon | `faviconUrl` | PNG, WebP, ICO | 512 Ko depuis la console | application, réseau, client |
| Asset nommé | adresse affichée dans la liste **Assets custom** | PNG, WebP | 2 Mo | application, réseau, client |

- Le SVG est refusé. Le type est contrôlé sur le contenu réel du fichier.
- Nom d'un asset nommé : minuscules, chiffres, `-` et `_`.
- Chaque fichier est servi par une adresse publique suivie d'un paramètre `?v=<horodatage>`, qui change à chaque envoi. Le cache navigateur est de 24 heures.

## Thème

| Champ | Type | Contraintes | Description |
|---|---|---|---|
| `id` | UUID | — | Identifiant du thème |
| `name` | chaîne | 1 à 50 caractères, unique sur la plateforme, sans `<` `>` `&` `"` `'` | Nom affiché dans les listes |
| `cssVarsLight` | objet | nom ≤ 200 caractères, valeur ≤ 500 caractères | Variables du mode clair, appliquées sur `:root` |
| `cssVarsDark` | objet | mêmes contraintes | Variables du mode sombre, appliquées sur `.dark` |
| `cssPath` | chaîne | ≤ 255 caractères, `.css` ou `.json` ; généré si absent | Chemin de stockage de la feuille de style |

`GET /api/themes/{id}/css` renvoie la feuille de style en `text/css`, avec l'en-tête `Cache-Control: public, max-age=3600`.

## Objet `branding` de `GET /api/me`

| Champ | Résolution | Description |
|---|---|---|
| `logoLightUrl`, `logoDarkUrl` | client → réseau → application | Logos |
| `bgLightUrl`, `bgDarkUrl` | client → réseau → application | Images de fond |
| `faviconUrl` | client → réseau → application | Favicon |
| `primaryColor`, `accentColor` | application | Couleurs de marque, au format `#RRGGBB` |
| `background` | application | Fond CSS (couleur ou dégradé) |
| `themeName` | utilisateur → client → réseau → application | Nom du thème retenu |
| `themeCssPath` | idem | Chemin de stockage de sa feuille de style |
| `themeCssVarsLight`, `themeCssVarsDark` | idem | Variables du thème retenu |

Un champ sans valeur à aucun niveau vaut `null` ou est omis de la réponse.

## Réponse de `GET /api/apps/{appWid}/runtime-config`

| Champ | Description |
|---|---|
| `theme` | Thème par défaut de l'application : `id`, `name`, `cssUrl` (chemin relatif à `https://api.wakastart.app/api`), ou `null` |
| `languages[]` | Langues de l'application : `code`, `name`, `isDefault`, `i18nUrl` (chemin indicatif ; l'URL du fichier s'obtient par `GET /api/languages/code/{code}/file`) |
| `branding` | Visuels du niveau application : `logoLightUrl`, `logoDarkUrl`, `faviconUrl`, `bgLightUrl`, `bgDarkUrl` (`null` si absents) |

## Revendication du jeton enrichi

| Revendication | Contenu |
|---|---|
| `wthm` | Nom du thème retenu pour l'utilisateur : préférence, sinon client, sinon réseau. Absente si aucun de ces niveaux n'en désigne. |

## Écrans de la console

| Écran | Chemin | Sections |
|---|---|---|
| Theme Studio d'un réseau | **Administration > Réseaux** › **Configuration avancée** › onglet **Thème** | **Logos**, **Fonds**, **Favicon**, **Theme CSS**, **Assets custom** |
| Theme Studio d'un client | configuration du client › onglet **Thèmes** | mêmes sections |
| Theme Studio de l'application | **Mes Apps** › application › **Paramétrage** › onglet **Thèmes** | mêmes sections et **Thème Keycloak**, en lecture seule |
| Thème par défaut | onglet **Général** du réseau ou du client | liste **Thème par défaut** |
| Thème préféré | **Mon profil** › **Préférences** | liste **Thème préféré** |
