WS
Docs / Installation

Installation

Ajouter Wirestack UI à votre projet Laravel en quelques étapes.

Prérequis détaillés

  • PHP >= 8.2 et dépendances Composer installées.
  • Laravel 10/11/12 — Wirestack supporte Laravel 10+ (y compris 12).
  • Livewire 3+ ou 4+ selon votre projet.
  • Tailwind CSS (v3 ou v4 recommandé). Assurez-vous d'avoir node et npm ou pnpm installés pour compiler les assets.
  • Pour l'environnement de développement local (monorepo), utilisez la source packages/wirestack (voir plus bas).

Commandes utiles :

Terminal
composer install
npm install
npm run dev

1 Installer via Composer

Ajoutez le package à votre projet.

Terminal
composer require darken10/wirestack

2 Intégrer les assets CSS

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 :

resources/css/app.css
@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

tailwind.config.js
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 :

resources/css/app.css
@import "tailwindcss";

/* Chemin local du package en développement */
@source "../../packages/wirestack/resources/views/**/*.blade.php";
@source "../../packages/wirestack/src/**/*.php";

3 Publier la configuration (optionnel)

Publiez le fichier de configuration pour le personnaliser.

Terminal
php artisan vendor:publish --tag=ws-config

Cela crée config/ws.php dans votre projet.

4 Ajouter les directives Blade

Ajoutez ces directives dans votre layout principal.

resources/views/layouts/app.blade.php
<!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>

5 Utiliser les composants

Les composants sont disponibles immédiatement via le préfixe ws.

Blade
<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>
Rendu
Actif

6 Composants Livewire

Les composants Livewire (Modal, Drawer, Toast) se déclarent une fois dans le layout.

resources/views/layouts/app.blade.php
<body>
    
    <livewire:ws::toast />

    
    <livewire:ws::command-palette :commands="[]" />

    {{ $slot }}

    @wsScripts
    @livewireScripts
</body>

Personnaliser les vues

Publiez les vues pour les modifier directement.

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

Les vues seront copiées dans resources/views/vendor/ws/.

← Introduction Configuration →

Dépannage rapide

  • Erreur Vite / manifest : exécutez npm run build ou npm run dev puis rechargez.
  • Après modification des chemins Tailwind, videz le cache et relancez le dev server : php artisan view:clear && npm run dev.
  • Si les styles du package n'apparaissent pas, vérifiez que les chemins relatifs dans resources/css/app.css ou tailwind.config.js pointent bien vers vendor/darken10/wirestack ou packages/wirestack.