WS
Docs / Configuration

Configuration

Personnalisez le comportement global de Wirestack UI via config/ws.php.

Fichier complet

config/ws.php
<?php

return [

    /*
    | Préfixe des composants Blade.
    | Défaut : <x-ws::button> / <livewire:ws::modal>
    */
    'prefix' => 'ws',

    /*
    | Thème par défaut : 'light' | 'dark' | 'system'
    */
    'theme' => 'system',

    /*
    | Design Tokens — variables CSS injectées dans <head>
    */
    'tokens' => [
        'primary-h'   => '221',
        'primary-s'   => '83%',
        'primary-l'   => '53%',
        'radius-sm'   => '0.25rem',
        'radius-md'   => '0.375rem',
        'radius-lg'   => '0.5rem',
        'radius-xl'   => '0.75rem',
        'font-sans'   => "'Instrument Sans', ui-sans-serif, system-ui, sans-serif",
    ],

    /*
    | Valeurs par défaut des composants
    */
    'defaults' => [
        'button'   => ['variant' => 'solid',    'color' => 'primary', 'size' => 'md'],
        'badge'    => ['variant' => 'soft',     'color' => 'primary', 'size' => 'sm'],
        'avatar'   => ['size' => 'md',          'shape' => 'circle'],
        'input'    => ['variant' => 'bordered',  'size' => 'md'],
        'card'     => ['variant' => 'bordered',  'padding' => 'md'],
        'alert'    => ['variant' => 'soft',     'color' => 'info'],
        'modal'    => ['size' => 'md'],
        'drawer'   => ['position' => 'right',   'size' => 'md'],
    ],

    /*
    | Toast
    */
    'toast' => [
        'position' => 'bottom-right', // top-right | top-left | bottom-right | bottom-left | top-center | bottom-center
        'duration'  => 4000,           // ms avant fermeture automatique (0 = jamais)
        'max'       => 5,              // nombre maximum de toasts visibles
    ],
];

Changer le préfixe

Par défaut, le préfixe est ws. Vous pouvez le changer selon vos préférences.

config/ws.php
'prefix' => 'ui', // <x-ui::button> au lieu de <x-ws::button>

Valeurs par défaut globales

Définissez les props par défaut pour tous les composants. Ainsi, vous n'avez plus besoin de les répéter partout.

config/ws.php
// Tous les boutons auront variant=outline et color=neutral par défaut
'defaults' => [
    'button' => ['variant' => 'outline', 'color' => 'neutral', 'size' => 'sm'],
],
Blade (équivalent)
<!-- Avant -->
<x-ws::button variant="outline" color="neutral" size="sm">Enregistrer</x-ws::button>

<!-- Après (defaults configurés) -->
<x-ws::button>Enregistrer</x-ws::button>

Configuration du Toast

Contrôlez le comportement global des toasts.

config/ws.php
'toast' => [
    'position' => 'top-right',  // Position sur l'écran
    'duration'  => 3000,         // 3 secondes avant fermeture automatique
    'max'       => 3,            // 3 toasts visibles au maximum
],