WS
Docs /Démarrage/Theming

Theming & Personnalisation

Personnalisez les couleurs, les rayons, la typographie et les valeurs par défaut des composants via config/ws.php.

Mode sombre

Tous les composants Wirestack UI intègrent le mode sombre nativement via les classes dark: de Tailwind CSS. Aucune configuration supplémentaire n'est requise.

Aperçu — switch clair/sombre
Actif

Configurez le thème par défaut dans config/ws.php :

// config/ws.php
'theme' => 'system', // 'light' | 'dark' | 'system'
Valeur Comportement
'system'Suit prefers-color-scheme du navigateur
'light'Force le mode clair
'dark'Force le mode sombre

Toggle Dark Mode avec Alpine.js

Ajoutez un bouton de bascule dans votre layout pour que l'utilisateur choisisse son thème et que le choix soit persisté dans localStorage.

<button
    x-data
    x-on:click="
        const isDark = document.documentElement.classList.toggle('dark');
        localStorage.setItem('ws-theme', isDark ? 'dark' : 'light');
    "
    class="p-2 rounded-lg hover:bg-zinc-100 dark:hover:bg-zinc-800"
>
    <!-- Soleil (mode sombre actif) -->
    <x-ws::icon name="sun" class="hidden dark:block text-zinc-300" />
    <!-- Lune (mode clair actif) -->
    <x-ws::icon name="moon" class="block dark:hidden text-zinc-700" />
</button>

Pour éviter le flash de thème au chargement, ajoutez ce script dans le <head> avant le CSS :

<script>
(function () {
    const stored = localStorage.getItem('ws-theme');
    const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
    if (stored === 'dark' || (!stored && prefersDark)) {
        document.documentElement.classList.add('dark');
    }
})();
</script>

Changer la couleur primaire

La couleur primaire est définie en HSL dans config/ws.php et propagée automatiquement à tous les composants.

// config/ws.php
'tokens' => [
    // Bleu (défaut)
    'primary-h' => '221',
    'primary-s' => '83%',
    'primary-l' => '53%',

    // Violet (SaaS moderne)
    'primary-h' => '263',
    'primary-s' => '70%',
    'primary-l' => '50%',

    // Vert émeraude
    'primary-h' => '160',
    'primary-s' => '84%',
    'primary-l' => '39%',
],
Couleur H S L
Bleu (défaut)22183%53%
Violet26370%50%
Vert émeraude16084%39%
Orange2595%53%
Rouge rubis084%60%
Rose33081%60%
Indigo23984%67%

Rayons globaux

Changez les arrondis de tous les composants en une seule fois pour un look « pill », « sharp » ou intermédiaire.

// config/ws.php — Design "pill" : tout en arrondi
'tokens' => [
    'radius-sm'  => '9999px',
    'radius-md'  => '9999px',
    'radius-lg'  => '9999px',
    'radius-xl'  => '9999px',
    'radius-2xl' => '9999px',
],

// Design "sharp" : look enterprise sans arrondi
'tokens' => [
    'radius-sm'  => '0',
    'radius-md'  => '0',
    'radius-lg'  => '0',
    'radius-xl'  => '0',
    'radius-2xl' => '0',
],

Typographie

// config/ws.php
'tokens' => [
    // Inter — très utilisé dans les SaaS
    'font-sans' => "'Inter', ui-sans-serif, system-ui, sans-serif",

    // Geist — style Vercel
    'font-sans' => "'Geist', ui-sans-serif, system-ui, sans-serif",

    // Système natif — zéro chargement
    'font-sans' => "ui-sans-serif, system-ui, -apple-system, sans-serif",
],

Valeurs par défaut des composants

Surcharger les valeurs par défaut permet d'appliquer un style cohérent à tous les composants sans répéter les props partout.

// config/ws.php
'defaults' => [
    // Boutons doux partout
    'button' => ['variant' => 'soft', 'color' => 'neutral', 'size' => 'md'],

    // Badges solides
    'badge'  => ['variant' => 'solid', 'color' => 'primary'],

    // Inputs avec fond coloré
    'input'  => ['variant' => 'filled', 'size' => 'md'],

    // Cards avec ombre plutôt que bordure
    'card'   => ['variant' => 'elevated', 'padding' => 'lg'],
],

Surcharger les vues

Pour personnaliser un composant spécifiquement sans modifier le package, publiez ses vues :

php artisan vendor:publish --tag=ws-views

Les vues seront copiées dans resources/views/vendor/wirestack/ et prendront la priorité sur celles du package.