Personnalisez les couleurs, les rayons, la typographie et les valeurs par défaut des composants via config/ws.php.
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.
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 |
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>
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) | 221 | 83% | 53% |
| Violet | 263 | 70% | 50% |
| Vert émeraude | 160 | 84% | 39% |
| Orange | 25 | 95% | 53% |
| Rouge rubis | 0 | 84% | 60% |
| Rose | 330 | 81% | 60% |
| Indigo | 239 | 84% | 67% |
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',
],
// 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",
],
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'],
],
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.