Créer un thème CSS
Générer des couleurs sur tweakcn.com, les importer dans le Theme Studio d'un réseau ou d'un client, ou créer le thème par l'API publique.
- Accès requis
- Console : accès en écriture au Theme Studio du réseau ou du client, et droit themes.create. API : Administrateur client ou niveau supérieur, avec le droit themes.create
- Durée
- 10 min
Un thème donne à votre application les couleurs d'un réseau ou d'un client, en mode clair comme en mode sombre. Vous le créez une fois, puis vous le désignez comme thème par défaut là où il doit s'appliquer.
Avant de commencer
- Lisez Thèmes CSS : un thème est partagé sur toute la plateforme et son nom doit être unique.
- Choisissez un nom de 50 caractères au plus, sans les caractères
<,>,&,"ni'. Faites-y figurer votre marque, par exempleClinique Saint-Jean vert. - Ayez votre charte sous la main : couleur primaire, couleur d'accent, rayon des arrondis, police.
Générer le CSS sur tweakcn.com
- Ouvrez tweakcn.com et réglez les couleurs selon votre charte, en mode clair et en mode sombre.
- Cliquez sur Copy CSS.
Résultat : le presse-papiers contient un bloc :root { … } et un bloc .dark { … }, chacun rempli de variables comme --primary ou --background.
Vérifiez le format des couleurs copiées : elles doivent être des composantes HSL sans fonction, par exemple --primary: 221.2 83.2% 53.3%. Si elles s'écrivent oklch(…) ou hsl(…), changez le format d'export de tweakcn.com avant de copier : Wakastart enregistre les valeurs telles quelles, et une wakapp construite avec waka-ui n'affiche que ce format (voir Thèmes CSS).
Créer le thème
- Ouvrez le Theme Studio du réseau ou du client (voir Ouvrir le Theme Studio), puis cliquez sur Theme CSS. La section Theme CSS (tweakcn) s'affiche ; le bouton Ouvrir tweakcn.com ouvre le générateur dans un nouvel onglet.
- Collez le CSS copié dans la zone Collez le CSS copie. Un indicateur vert affiche le nombre de variables detectees. S'il indique « Aucune variable CSS detectee », le texte collé ne contient pas de bloc
:rootou.dark. - Optionnel : activez Apercu en temps reel. La page de la console adopte le thème, avec le bandeau « Apercu en cours — cette page utilise le theme temporaire ». Cliquez sur Arreter pour revenir au thème habituel.
- Saisissez le nom dans le champ Nommez ce theme.
- Cliquez sur Sauvegarder.
Résultat : le message « Theme sauvegarde » s'affiche et le thème rejoint la liste Themes enregistres.
Créez le thème en envoyant ses variables, sans le préfixe de bloc :
curl -X POST "https://api.wakastart.app/api/themes" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Clinique Saint-Jean vert",
"cssVarsLight": {
"--background": "0 0% 100%",
"--foreground": "220 38% 11%",
"--primary": "138 100% 28%",
"--primary-foreground": "0 0% 97%",
"--radius": "0.5rem"
},
"cssVarsDark": {
"--background": "220 34% 8%",
"--foreground": "0 0% 96%",
"--primary": "140 54% 47%",
"--primary-foreground": "220 34% 8%"
}
}'const response = await fetch("https://api.wakastart.app/api/themes", {
method: "POST",
headers: {
Authorization: `Bearer ${accessToken}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Clinique Saint-Jean vert",
cssVarsLight: {
"--background": "0 0% 100%",
"--foreground": "220 38% 11%",
"--primary": "138 100% 28%",
"--primary-foreground": "0 0% 97%",
"--radius": "0.5rem",
},
cssVarsDark: {
"--background": "220 34% 8%",
"--foreground": "0 0% 96%",
"--primary": "140 54% 47%",
"--primary-foreground": "220 34% 8%",
},
}),
});
if (!response.ok) throw new Error(`Création refusée : ${response.status}`);
const theme = await response.json();
console.log(theme.id);Réponse attendue (201 Created) :
{
"id": "3f6c2a10-0000-4000-8000-000000000001",
"name": "Clinique Saint-Jean vert",
"cssPath": "custom/1761206400000-Clinique_Saint-Jean_vert.css",
"variables": null,
"cssVarsLight": {
"--background": "0 0% 100%",
"--foreground": "220 38% 11%",
"--primary": "138 100% 28%",
"--primary-foreground": "0 0% 97%",
"--radius": "0.5rem"
},
"cssVarsDark": {
"--background": "220 34% 8%",
"--foreground": "0 0% 96%",
"--primary": "140 54% 47%",
"--primary-foreground": "220 34% 8%"
}
}Chaque nom de variable fait 200 caractères au plus et ne contient ni {, }, ;, < ni >. Chaque valeur fait 500 caractères au plus, sans accolade ni url(data: ou url(javascript:.
Important
Créer un thème ne change encore rien pour vos utilisateurs. Il faut ensuite le désigner comme thème par défaut du réseau ou du client.
Vérifier le résultat
- Dans la console, le thème figure dans la liste Themes enregistres et dans la liste Thème par défaut de l'onglet Général du réseau ou du client.
- Par l'API,
GET /api/themes/{id}/cssrenvoie la feuille de style du thème, avec un bloc:rootet un bloc.dark.