Installation

Praesepe UI is a copy-paste component library. Copy the Blade components, tokens, and Alpine patterns into your Laravel app.

Requirements

• Laravel 12 or 13
• PHP 8.3+
• Tailwind CSS 4 with @tailwindcss/vite
• Alpine.js 3 with @alpinejs/focus

Tailwind v4 source scanning

Declare explicit @source paths so classes used only in snippets and metadata are never purged.

@import "tailwindcss";
@import "./theme.css";

@source "../views/**/*.blade.php";
@source "../snippets/**/*.html";
@source "../docs/**/*.php";

Theme tokens

Import theme.css and map semantic --ui-* variables with @theme inline. See Theming.

Alpine setup

import Alpine from 'alpinejs';
import focus from '@alpinejs/focus';

Alpine.plugin(focus);
window.Alpine = Alpine;
Alpine.start();

Livewire notes

Praesepe UI does not require Livewire. If your app already uses Livewire, do not start a second Alpine instance. Livewire bundles Alpine; register the focus plugin on the existing Alpine global before Livewire boots, and prefer long-form directives in Blade to avoid attribute collisions.