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.
This page has not been translated yet and is shown in French.
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.