Wirestack UI expose deux directives Blade à placer dans votre layout principal : @wsStyles et @wsScripts.
À placer dans le <head>. Injecte un bloc <style> contenant toutes les variables CSS (design tokens) définies dans config/ws.php.
<head>
<meta charset="UTF-8">
@wsStyles
@vite(['resources/css/app.css'])
@livewireStyles
</head>
Exemple de sortie générée par @wsStyles :
<style>
:root {
--ws-primary-h: 221;
--ws-primary-s: 83%;
--ws-primary-l: 53%;
--ws-radius-sm: 0.25rem;
--ws-radius-md: 0.375rem;
--ws-radius-lg: 0.5rem;
--ws-radius-xl: 0.75rem;
--ws-radius-2xl: 1rem;
--ws-radius-full: 9999px;
--ws-font-sans: "Instrument Sans", ui-sans-serif, system-ui, sans-serif;
--ws-transition-fast: 100ms ease;
--ws-transition-normal: 180ms ease;
--ws-transition-slow: 300ms ease;
--ws-shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
--ws-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), ...;
--ws-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), ...;
}
</style>
À placer juste avant </body>. Injecte les helpers JavaScript globaux du package et configure le raccourci clavier ⌘K pour la palette de commandes.
<body>
{{ $slot }}
@wsScripts
@livewireScripts
</body>
Helpers disponibles après injection :
| Objet global | Description |
|---|---|
| DsToast | Déclencher des notifications flottantes |
| DsModal | Ouvrir / fermer une modale par son ID |
| DsDrawer | Ouvrir / fermer un drawer par son ID |
| DsCommandPalette | Ouvrir / fermer la palette de commandes |
| DsCopy | Copier du texte dans le presse-papiers |
Exemple de layout Blade minimal avec toutes les directives nécessaires :
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Mon App</title>
@wsStyles
@vite(['resources/css/app.css', 'resources/js/app.js'])
@livewireStyles
</head>
<body class="bg-white dark:bg-zinc-950 text-zinc-900 dark:text-zinc-100">
<livewire:ws::toast />
{{ $slot }}
@wsScripts
@livewireScripts
</body>
</html>
Important : @wsStyles doit être placé avant @vite pour que les variables CSS soient disponibles dès le rendu. De même, @wsScripts doit être placé avant @livewireScripts.