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 … »
- « Le fichier dépasse la taille maximale de 2 Mo »
- « Le contenu réel du fichier ne correspond pas au type déclaré »
- « Aucune variable CSS detectee »
- « La valeur du champ "name" existe déjà »
- Le Theme Studio de l'application est en lecture seule
- L'application affiche encore l'ancien logo ou l'ancien thème
403surruntime-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.