Prérequis
Prérequis détaillés
node et npm ou pnpm installés pour compiler les assets.packages/wirestack (voir plus bas).Commandes utiles :
composer install
npm install
npm run dev
Ajoutez le package à votre projet.
composer require darken10/wirestack
Configurez Tailwind CSS pour scanner les vues du package.
Pourquoi cette étape ?
Wirestack fournit des composants avec leurs propres styles Tailwind CSS. Pour que Tailwind CSS génère automatiquement tous les styles utilisés, il doit scanner les fichiers du package. Sans cette configuration, les classes CSS ne seront pas générées et l'interface ne s'affichera pas correctement.
Ouvrez resources/css/app.css et ajoutez :
@import "tailwindcss";
/* Scanner les vues Blade et classes PHP du package Wirestack pour Tailwind */
@source "../../vendor/darken10/wirestack/resources/views/**/*.blade.php";
@source "../../vendor/darken10/wirestack/src/**/*.php";
Exemple : configurer tailwind.config.js pour inclure les vues du package
module.exports = {
content: [
'./resources/views/**/*.blade.php',
'./resources/js/**/*.js',
'../../vendor/darken10/wirestack/resources/views/**/*.blade.php',
'../../vendor/darken10/wirestack/src/**/*.php'
],
theme: { extend: {} },
plugins: [],
};
Remplacez les chemins par ../../packages/wirestack/... si vous travaillez en monorepo.
Ce que cela fait :
@import "tailwindcss" — Importe le framework Tailwind CSS@source "...views/**/*.blade.php" — Scanne les fichiers Blade du package@source "...src/**/*.php" — Scanne les fichiers PHP (pour les classes dynamiques)📦 Développement local (monorepo)
Si vous développez Wirestack dans packages/wirestack/, remplacez les chemins :
@import "tailwindcss";
/* Chemin local du package en développement */
@source "../../packages/wirestack/resources/views/**/*.blade.php";
@source "../../packages/wirestack/src/**/*.php";
Publiez le fichier de configuration pour le personnaliser.
php artisan vendor:publish --tag=ws-config
Cela crée config/ws.php dans votre projet.
Ajoutez ces directives dans votre layout principal.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>WireStack</title>
@wsStyles
@livewireStyles
</head>
<body>
{{ $slot }}
@wsScripts
@livewireScripts
</body>
</html>
Les composants sont disponibles immédiatement via le préfixe ws.
<x-ws::button variant="solid" color="primary">
Mon bouton
</x-ws::button>
<x-ws::badge color="success">Actif</x-ws::badge>
<x-ws::alert color="info" title="Bon à savoir">
Wirestack UI est installé et fonctionnel.
</x-ws::alert>
Bon à savoir
Les composants Livewire (Modal, Drawer, Toast) se déclarent une fois dans le layout.
<body>
<livewire:ws::toast />
<livewire:ws::command-palette :commands="[]" />
{{ $slot }}
@wsScripts
@livewireScripts
</body>
Publiez les vues pour les modifier directement.
php artisan vendor:publish --tag=ws-views
Les vues seront copiées dans resources/views/vendor/ws/.
Dépannage rapide
npm run build ou npm run dev puis rechargez.php artisan view:clear && npm run dev.resources/css/app.css ou tailwind.config.js pointent bien vers vendor/darken10/wirestack ou packages/wirestack.