# Apparence

> Habillez votre application aux couleurs de chaque réseau et de chaque client - logos, fonds, favicon et thème CSS, résolus en cascade.

Une même [wakapp](/v1.0/glossaire#wakapp) peut porter le logo de votre marque pour un [réseau](/v1.0/glossaire#réseau), et celui d'un [client](/v1.0/glossaire#client) pour ses propres utilisateurs. Wakastart stocke l'habillage à chaque niveau et calcule, pour chaque utilisateur, celui qui s'applique.

L'habillage couvre cinq éléments : le logo (clair et sombre), l'image de fond (claire et sombre), le favicon, des fichiers nommés que vous ajoutez vous-même, et un thème CSS qui fixe les couleurs de l'interface.

## Comment ça marche

Chaque niveau peut définir ses propres visuels. Quand un niveau ne définit rien, le niveau supérieur s'applique. Votre application lit le résultat par l'API publique, déjà résolu pour l'utilisateur connecté.

```mermaid
flowchart TB
  subgraph Console["Console Wakastart"]
    A["Application<br/>visuels et thème de base<br/>(posés par Wakastart)"]
    R["Réseau<br/>onglet Thème"]
    C["Client<br/>onglet Thèmes"]
    U["Utilisateur<br/>Mon profil › Thème préféré"]
  end
  A --> R --> C --> U
  U --> M["GET /api/me<br/>branding déjà résolu"]
  M --> W["Votre wakapp<br/>logo, fond, favicon, variables CSS"]
```

- Les **logos, fonds et favicon** se résolvent du client vers le réseau, puis vers l'application.
- Le **thème CSS** suit le même ordre, avec un niveau de plus : la préférence de l'utilisateur passe avant tout.
- Les visuels et le thème du niveau application sont posés par l'équipe Wakastart. Les niveaux réseau et client se gèrent depuis la console.

Le détail de la résolution est expliqué dans [Cascade d'habillage](/v1.0/apparence/cascade-d-habillage).

## Choisissez votre approche

| Vous voulez | Voie | Page |
|---|---|---|
| Déposer les logos d'un réseau ou d'un client | Console | [Personnaliser les logos, fonds et favicon](/v1.0/apparence/personnaliser-les-visuels) |
| Donner des couleurs à un réseau ou à un client | Console | [Créer un thème CSS](/v1.0/apparence/creer-un-theme-css) puis [Choisir le thème par défaut](/v1.0/apparence/choisir-le-theme-par-defaut) |
| Afficher le bon habillage dans votre application | API publique | [Afficher l'habillage dans votre application](/v1.0/apparence/afficher-l-habillage-dans-votre-application) |

## Commencer

::::cards{cols=3}
:::card{title="Cascade d'habillage" href="/v1.0/apparence/cascade-d-habillage" icon="Layers"}
Comprendre quel niveau gagne, élément par élément.
:::
:::card{title="Personnaliser les visuels" href="/v1.0/apparence/personnaliser-les-visuels" icon="Image"}
Déposer logos, fonds et favicon pour un réseau ou un client.
:::
:::card{title="Afficher l'habillage" href="/v1.0/apparence/afficher-l-habillage-dans-votre-application" icon="Code"}
Lire l'habillage résolu par l'API et l'appliquer à votre interface.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Logos, fonds et favicon" href="/v1.0/apparence/personnaliser-les-visuels" icon="ImagePlus"}
Une version claire et une version sombre, à chaque niveau.
:::
:::card{title="Assets nommés" href="/v1.0/apparence/ajouter-un-asset-nomme" icon="FolderOpen"}
Des fichiers supplémentaires, identifiés par un nom stable.
:::
:::card{title="Thèmes CSS" href="/v1.0/apparence/themes-css" icon="Palette"}
Des variables CSS claires et sombres, importées depuis tweakcn.com.
:::
:::card{title="Thème par défaut et préférence" href="/v1.0/apparence/choisir-le-theme-par-defaut" icon="SwatchBook"}
Un thème par réseau, par client, et le choix de chaque utilisateur.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Page de connexion" href="/v1.0/page-de-connexion" icon="PanelsTopLeft"}
Personnaliser l'écran de connexion de votre application.
:::
:::card{title="Langues et traductions" href="/v1.0/langues-et-traductions" icon="Languages"}
La langue suit la même cascade que le thème.
:::
:::card{title="Organisations" href="/v1.0/organisations" icon="Building2"}
Les réseaux et les clients qui portent l'habillage.
:::
::::

## Ressources

- [Référence de l'habillage](/v1.0/apparence/reference) : champs, formats, limites et réponses de l'API.
- [Résoudre les problèmes d'habillage](/v1.0/apparence/depannage).
- [Appliquer le thème avec waka-ui](/v1.0/interface-waka-ui/appliquer-le-theme) : si votre front utilise la bibliothèque de composants de Wakastart.
- [Référence API : contenus de l'application](/v1.0/reference-api/contenus-application).
