# 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.

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](/v1.0/apparence/themes-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 exemple `Clinique 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

1. Ouvrez [tweakcn.com](https://tweakcn.com) et réglez les couleurs selon votre charte, en mode clair et en mode sombre.
2. 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](/v1.0/interface-waka-ui) n'affiche que ce format (voir [Thèmes CSS](/v1.0/apparence/themes-css)).

## Créer le thème

::::tabs{sync="voie"}
:::tab{label="Console"}
1. Ouvrez le Theme Studio du réseau ou du client (voir [Ouvrir le Theme Studio](/v1.0/apparence/personnaliser-les-visuels#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.
2. 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 `:root` ou `.dark`.
3. 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.
4. Saisissez le nom dans le champ **Nommez ce theme**.
5. Cliquez sur **Sauvegarder**.

Résultat : le message « Theme sauvegarde » s'affiche et le thème rejoint la liste **Themes enregistres**.
:::
:::tab{label="API"}
Créez le thème en envoyant ses variables, sans le préfixe de bloc :

```bash
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%"
    }
  }'
```

```ts
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`) :

```json
{
  "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}/css` renvoie la feuille de style du thème, avec un bloc `:root` et un bloc `.dark`.

## Voir aussi

- [Choisir le thème par défaut](/v1.0/apparence/choisir-le-theme-par-defaut)
- [Thèmes CSS](/v1.0/apparence/themes-css)
- [Référence API : contenus de l'application](/v1.0/reference-api/contenus-application)
