Thèmes CSS
Ce qu'est un thème Wakastart - deux jeux de variables CSS, clair et sombre, au format shadcn/ui, partagés par nom sur toute la plateforme.
This page has not been translated yet and is shown in French.
Un thème fixe les couleurs, les rayons d'arrondi et les polices de l'interface de votre application. Il ne contient aucune règle de mise en page : seulement des valeurs, que vos composants lisent.
Définition
Un thème Wakastart est un objet nommé qui porte deux jeux de variables CSS personnalisées :
- les variables du mode clair, appliquées sur
:root; - les variables du mode sombre, appliquées sur la classe
.dark.
Les noms des variables suivent la convention de shadcn/ui : --background, --foreground, --primary, --primary-foreground, --radius, etc. C'est aussi la convention du design system Wakastart, présenté sur ui.wakastart.app. Le générateur tweakcn.com produit directement ce format.
Chaque couleur s'écrit en trois composantes HSL, sans fonction : --primary: 221.2 83.2% 53.3%. C'est le format de l'exemple du Theme Studio et de l'API publique, et le seul que lit waka-ui. Wakastart enregistre les valeurs telles que vous les fournissez, sans les convertir : une couleur écrite oklch(…), hsl(…) ou en hexadécimal est acceptée, mais s'affiche sans couleur dans une interface qui compose hsl(var(--primary)), comme waka-ui.
Wakastart restitue un thème sous la forme d'une feuille de style prête à charger :
:root {
--background: 0 0% 100%;
--foreground: 220 38% 11%;
--primary: 138 100% 28%;
--primary-foreground: 0 0% 97%;
--radius: 0.5rem;
}
.dark {
--background: 220 34% 8%;
--foreground: 0 0% 96%;
--primary: 140 54% 47%;
--primary-foreground: 220 34% 8%;
}Un thème est partagé par son nom
Un thème n'appartient ni à une application, ni à un réseau, ni à un client. Il existe une fois sur la plateforme, sous un nom unique, et chaque niveau le désigne :
- l'application, le réseau et le client le choisissent comme thème par défaut ;
- chaque utilisateur peut le choisir comme thème préféré.
Deux conséquences pratiques :
- choisissez un nom distinctif, qui porte votre marque (« Clinique Saint-Jean — vert » plutôt que « Vert ») : un nom déjà pris est refusé ;
- un thème ne se modifie pas depuis la console : pour changer de couleurs, créez un nouveau thème et désignez-le à la place de l'ancien.
Comment ça marche
- Vous générez vos couleurs sur tweakcn.com et copiez le CSS produit.
- Dans le Theme Studio d'un réseau ou d'un client, vous collez ce CSS. La console en extrait les variables des blocs
:rootet.dark, les affiche en aperçu sur la page, puis enregistre le thème sous le nom que vous lui donnez. - Vous désignez ce thème comme Thème par défaut du réseau ou du client.
- Votre application reçoit les variables du thème retenu pour l'utilisateur, dans la réponse de
GET /api/me, ou la feuille de style complète parGET /api/themes/{id}/css.
Ce qu'un thème ne contient pas
- Ni logo, ni fond, ni favicon : ce sont des visuels, gérés à part dans le même Theme Studio.
- Ni le style de la page de connexion : celle-ci est servie par Keycloak et se personnalise avec un thème de connexion.