Introduction

Layup is a visual page-builder field for Filament. It turns a JSON column into an editor canvas with sections, rows, responsive columns, and registered widgets.

The bundled Pages resource is optional. You can use Layup as a complete page CMS, or you can use only Crumbls\Layup\Forms\Components\LayupBuilder on your own Eloquent model and render the saved content yourself.

What it does

• Provides a flex-based 12-column grid with sm, md, lg, and xl breakpoints.
• Registers 96 built-in widget classes from config/layup.php.
• Ships optional frontend routes for published pages.
• Includes SEO helpers, structured data, breadcrumbs, page revisions, scheduled publishing, and Tailwind safelist generation.
• Supports custom widgets, custom page models, custom rendering, and plugin-level widget/theme configuration.

When to use it

Use Layup when a Laravel application needs editor-managed landing pages, marketing pages, documentation-style pages, or structured content blocks inside an existing resource.

Choose the bundled Pages resource when you want Layup to own page records, routing, status, SEO metadata, revisions, and scheduled publishing.

Choose field-only mode when your application already has its own model, resource, route, authorization, or publishing workflow and only needs the visual builder field.

Requirements

livewire/livewire is suggested when you build widgets that extend Crumbls\Layup\View\BaseLivewireWidget. Standard Blade-rendered widgets do not require declaring Livewire as a separate application dependency beyond what Filament already brings to the app.

Core concepts

Quick start

composer require crumbls/layup
php artisan layup:install

Register the plugin in a Filament panel provider:

use Crumbls\Layup\LayupPlugin;

public function panel(\Filament\Panel $panel): \Filament\Panel
{
    return $panel
        ->plugins([
            LayupPlugin::make(),
        ]);
}

For the full install path, see Installation. For field-only usage, see Field-only installation and Embedding the field.