# Résoudre les problèmes d'habillage

> Fichier refusé, nom de thème déjà pris, logo qui ne change pas dans l'application - causes et solutions.

Cette page couvre les erreurs rencontrées en déposant des visuels, en créant un thème ou en lisant l'habillage par l'API.

## Symptômes

- [« Type MIME non autorisé pour … »](#type-mime-non-autorisé)
- [« Le fichier dépasse la taille maximale de 2 Mo »](#fichier-trop-volumineux)
- [« Le contenu réel du fichier ne correspond pas au type déclaré »](#contenu-différent-du-type)
- [« Aucune variable CSS detectee »](#aucune-variable-détectée)
- [« La valeur du champ "name" existe déjà »](#nom-de-thème-déjà-pris)
- [Le Theme Studio de l'application est en lecture seule](#theme-studio-en-lecture-seule)
- [L'application affiche encore l'ancien logo ou l'ancien thème](#ancien-habillage-affiché)
- [`403` sur `runtime-config`](#403-sur-runtime-config)

## Type MIME non autorisé

**Cause** : le format du fichier n'est pas accepté pour cet emplacement. Le message complet liste les types autorisés, par exemple « Type MIME non autorisé pour logo : image/svg+xml. Autorisés : image/png, image/webp ».

**Solution** : exportez le visuel en PNG ou en WebP (ou en ICO pour le favicon), puis déposez-le de nouveau.

## Fichier trop volumineux

**Cause** : le fichier dépasse 2 Mo. Pour le favicon, la console bloque dès 512 Ko.

**Solution** : réduisez les dimensions ou la qualité de l'image. Un logo de 1 000 pixels de large en WebP pèse en général bien moins de 200 Ko.

## Contenu différent du type

**Cause** : l'extension ne correspond pas au contenu, par exemple un JPEG renommé en `.png`. Le message indique le « Type détecté ».

**Solution** : exportez de nouveau l'image dans le bon format avec votre outil graphique, sans la renommer à la main.

## Aucune variable détectée

**Cause** : le texte collé dans **Collez le CSS copie** ne contient pas de bloc `:root { … }` ni de bloc `.dark { … }` avec des variables.

**Solution** : sur tweakcn.com, utilisez **Copy CSS** et collez le résultat sans le modifier.

## Nom de thème déjà pris

**Cause** : le nom des thèmes est unique sur toute la plateforme. Le message est « La valeur du champ "name" existe déjà. Veuillez en choisir une autre. »

**Solution** : ajoutez votre marque ou un suffixe au nom, par exemple `Clinique Saint-Jean vert 2026`.

## Theme Studio en lecture seule

**Cause** : les visuels, les thèmes et le thème de connexion du **niveau application** sont gérés par l'équipe Wakastart. Le Theme Studio de l'application s'affiche en lecture.

**Solution** : transmettez vos fichiers à Wakastart, ou habillez vos réseaux et vos clients depuis leur propre Theme Studio.

## Ancien habillage affiché

**Cause possible 1** : un niveau plus proche de l'utilisateur définit déjà ce visuel. Le logo d'un client masque celui du réseau.

**Cause possible 2** : pour le thème, l'utilisateur a choisi un **Thème préféré** dans **Mon profil**.

**Cause possible 3** : votre application garde en cache une ancienne réponse de `GET /api/me`.

**Pour vérifier** : appelez `GET /api/me` avec le jeton de cet utilisateur et comparez `branding.logoLightUrl` ou `branding.themeName` avec ce que vous attendez.

## 403 sur runtime-config

**Cause** : le jeton a été émis pour une autre application que celle du `appWid` demandé. Le message est « Access denied: you can only access the runtime config of your own application ».

**Solution** : utilisez un jeton du realm de votre application, ou corrigez le WID dans l'URL.

## Toujours bloqué ?

Rassemblez le WID de l'application, du réseau ou du client, l'heure de l'essai et le message exact affiché, puis contactez le support Wakastart.
