Front-end assets

The board needs its CSS and JS (Tailwind utilities, the theme system, SortableJS, and Laravel Echo when a broadcaster is configured). It ships them precompiled, so by default there is nothing to do. The mode is config('griglia.assets'), env GRIGLIA_ASSETS.

Precompiled — the default, zero buildBundled by your app — Vite

Use the files shipped with the package: no npm, no Vite, nothing to configure.

The assets are published under Laravel's own laravel-assets tag, which a default app republishes after every composer update — so an upgrade brings the new build with it. To do it by hand:

php artisan vendor:publish --tag=griglia-assets --force   # → public/vendor/griglia/{build,images}

<x-griglia::assets /> then links public/vendor/griglia/build/griglia.{css,js}.

Set GRIGLIA_ASSETS=vite and import the package sources into your own build. Worth it when you already use Tailwind and want one bundle, or when you restyle the board. Tailwind 4 does not scan vendor/, so declare the views as a source:

/* resources/css/app.css */
@import 'tailwindcss';
@source '../../vendor/alle80/griglia/resources/views/**/*.blade.php';
@import '../../vendor/alle80/griglia/resources/css/griglia.css';

// resources/js/app.js
import '../../vendor/alle80/griglia/resources/js/griglia.js';   // SortableJS + Echo (optional)

npm i sortablejs laravel-echo pusher-js && npm run build

Both modes

• The Echo client is configured at runtime from config('griglia.echo') (VITE_REVERB_* / REVERB_*). An empty key opens no WebSocket at all.
• Runtime Echo, translation, speech and Web Push configuration is emitted as script-safe JSON. Values that contain HTML end tags, quotes or Unicode line separators cannot terminate their inline script element.
• Theme fonts come from config('griglia.fonts_url') (bunny.net by default; set it to '' to self-host).
• To rebuild the precompiled files after editing the package sources: cd vendor/alle80/griglia && npm install && npm run build.

See also

• Installation · Troubleshooting