# Personnaliser les logos, fonds et favicon

> Déposer le logo clair et sombre, les images de fond et le favicon d'un réseau ou d'un client depuis le Theme Studio de la console.

Déposez les visuels d'un réseau pour qu'ils s'appliquent à tous ses clients, ou ceux d'un client pour ses seuls utilisateurs. Un emplacement laissé vide reprend le visuel du niveau supérieur.

## Avant de commencer

- Préparez vos fichiers :

  | Visuel | Formats | Taille maximale | Conseil |
  |---|---|---|---|
  | Logo mode clair | PNG, WebP | 2 Mo | proportions 5 sur 3 |
  | Logo mode sombre | PNG, WebP | 2 Mo | facultatif : sans lui, le logo clair sert dans les deux modes |
  | Fond mode clair, fond mode sombre | PNG, WebP | 2 Mo | proportions 16 sur 9 |
  | Favicon | PNG, WebP, ICO | 512 Ko | image carrée |

- Le SVG n'est pas accepté. Wakastart vérifie le contenu réel du fichier, pas seulement son extension.
- Les visuels du **niveau application** sont posés par l'équipe Wakastart : transmettez-lui vos fichiers.

## Ouvrir le Theme Studio

::::tabs{sync="niveau"}
:::tab{label="Réseau"}
1. Dans la barre latérale de la console, ouvrez **Administration > Réseaux**.
2. Sur la ligne du réseau, cliquez sur l'icône **Configuration avancée**.
3. Ouvrez l'onglet **Thème**.

Résultat : la carte **Theme Studio** s'affiche, avec la description « Gerez les logos, fonds, favicon et themes CSS de ce reseau. »
:::
:::tab{label="Client"}
1. Ouvrez `https://app.wakastart.app/customers`. Si vous administrez un seul client, la console ouvre directement sa configuration ; sinon, cliquez sur l'icône **Configuration** sur la ligne du client.
2. Ouvrez l'onglet **Thèmes**.

Résultat : la carte **Theme Studio** s'affiche, avec la description « Gerez les logos, fonds, favicon et themes CSS de ce client. »
:::
::::

Le Theme Studio présente ses sections dans une colonne à gauche : **Logos**, **Fonds**, **Favicon**, **Theme CSS** et **Assets custom**. Sur un écran étroit, elles deviennent des accordéons.

## Déposer les logos

::::steps
### Ouvrir la section
Cliquez sur **Logos**.

### Déposer le logo clair
Faites glisser votre fichier sur l'emplacement **Logo mode clair**, ou cliquez dessus pour le choisir.

Résultat : l'aperçu s'affiche dès la fin de l'envoi.

### Déposer le logo sombre
Optionnel : faites de même sur l'emplacement **Logo mode sombre**, avec une version lisible sur fond foncé.
::::

## Déposer les fonds

1. Cliquez sur **Fonds**.
2. Déposez votre image sur **Fond mode clair**.
3. Optionnel : déposez une seconde image sur **Fond mode sombre**.

## Déposer le favicon

1. Cliquez sur **Favicon**.
2. Déposez votre fichier sur l'emplacement **Favicon**.

Résultat : la section affiche un **Apercu dans le navigateur**, qui simule un onglet portant votre icône.

## Remplacer ou retirer un visuel

- Pour **remplacer** un visuel, survolez son aperçu et cliquez sur **Remplacer**, puis choisissez le nouveau fichier. L'ancien est écrasé.
- Pour **retirer** un visuel, survolez son aperçu, cliquez sur **Supprimer**, puis confirmez. Le niveau supérieur s'applique de nouveau.

:::note
Chaque nouvel envoi produit une nouvelle adresse de fichier. Les navigateurs de vos utilisateurs chargent donc la nouvelle version sans attendre l'expiration de leur cache.
:::

## Vérifier le résultat

1. Rechargez l'onglet : les aperçus affichent les fichiers enregistrés.
2. Connectez-vous à votre application avec un utilisateur de ce réseau ou de ce client.
3. Vérifiez le logo dans les deux modes, clair et sombre.

Côté développeur, la réponse de `GET /api/me` contient les nouvelles adresses dans `branding.logoLightUrl`, `branding.logoDarkUrl`, `branding.bgLightUrl`, `branding.bgDarkUrl` et `branding.faviconUrl`.

## Voir aussi

- [Ajouter un asset nommé](/v1.0/apparence/ajouter-un-asset-nomme)
- [Cascade d'habillage](/v1.0/apparence/cascade-d-habillage)
- [Résoudre les problèmes d'habillage](/v1.0/apparence/depannage)
