Docs Personnalisation Apparence Référence de l'habillage Référence de l'habillage Champs d'habillage par niveau, formats et limites des fichiers, objet thème et réponses des appels de l'API publique.
Référence Administrateur Développeur
Mis à jour le 23 octobre 2026
Cette page rassemble les valeurs de référence de l'habillage. Les endpoints complets sont décrits dans la référence API des contenus de l'application .
Visuels#
Visuel Champ renvoyé Formats Taille maximale Niveaux Logo mode clair logoLightUrlPNG, WebP 2 Mo application, réseau, client Logo mode sombre logoDarkUrlPNG, WebP 2 Mo application, réseau, client Fond mode clair bgLightUrlPNG, WebP 2 Mo application, réseau, client Fond mode sombre bgDarkUrlPNG, WebP 2 Mo application, réseau, client Favicon faviconUrlPNG, WebP, ICO 512 Ko depuis la console application, réseau, client Asset nommé adresse affichée dans la liste Assets custom PNG, WebP 2 Mo application, réseau, client
Le SVG est refusé. Le type est contrôlé sur le contenu réel du fichier.
Nom d'un asset nommé : minuscules, chiffres, - et _.
Chaque fichier est servi par une adresse publique suivie d'un paramètre ?v=<horodatage>, qui change à chaque envoi. Le cache navigateur est de 24 heures.
Thème#
Champ Type Contraintes Description idUUID — Identifiant du thème namechaîne 1 à 50 caractères, unique sur la plateforme, sans < > & " ' Nom affiché dans les listes cssVarsLightobjet nom ≤ 200 caractères, valeur ≤ 500 caractères Variables du mode clair, appliquées sur :root cssVarsDarkobjet mêmes contraintes Variables du mode sombre, appliquées sur .dark cssPathchaîne ≤ 255 caractères, .css ou .json ; généré si absent Chemin de stockage de la feuille de style
GET /api/themes/{id}/css renvoie la feuille de style en text/css, avec l'en-tête Cache-Control: public, max-age=3600.
Objet branding de GET /api/me#
Champ Résolution Description logoLightUrl, logoDarkUrlclient → réseau → application Logos bgLightUrl, bgDarkUrlclient → réseau → application Images de fond faviconUrlclient → réseau → application Favicon primaryColor, accentColorapplication Couleurs de marque, au format #RRGGBB backgroundapplication Fond CSS (couleur ou dégradé) themeNameutilisateur → client → réseau → application Nom du thème retenu themeCssPathidem Chemin de stockage de sa feuille de style themeCssVarsLight, themeCssVarsDarkidem Variables du thème retenu
Un champ sans valeur à aucun niveau vaut null ou est omis de la réponse.
Réponse de GET /api/apps/{appWid}/runtime-config#
Champ Description themeThème par défaut de l'application : id, name, cssUrl (chemin relatif à https://api.wakastart.app/api), ou null languages[]Langues de l'application : code, name, isDefault, i18nUrl (chemin indicatif ; l'URL du fichier s'obtient par GET /api/languages/code/{code}/file) brandingVisuels du niveau application : logoLightUrl, logoDarkUrl, faviconUrl, bgLightUrl, bgDarkUrl (null si absents)
Revendication du jeton enrichi#
Revendication Contenu wthmNom du thème retenu pour l'utilisateur : préférence, sinon client, sinon réseau. Absente si aucun de ces niveaux n'en désigne.
Écrans de la console#
Écran Chemin Sections Theme Studio d'un réseau Administration > Réseaux › Configuration avancée › onglet Thème Logos , Fonds , Favicon , Theme CSS , Assets custom Theme Studio d'un client configuration du client › onglet Thèmes mêmes sections Theme Studio de l'application Mes Apps › application › Paramétrage › onglet Thèmes mêmes sections et Thème Keycloak , en lecture seule Thème par défaut onglet Général du réseau ou du client liste Thème par défaut Thème préféré Mon profil › Préférences liste Thème préféré