README

Pagewire

Livewire 4 page builder package for Laravel 12 using Mary UI components. Inspired by existing implementation with reusable/global sections.

Installation

composer require hemant/pagewire
php artisan pagewire:install
php artisan vendor:publish --tag=pagewire-config --tag=pagewire-migrations --tag=pagewire-views
php artisan migrate

Routes

• Admin index: admin/pages (name: admin.pages.index)
• Builder: admin/pages/builder/{slug?} (name: admin.pages.builder)
• Menu manager: admin/menus (name: admin.menus.manager)
• Public page: /{public_prefix}/{slug} (default: /pages/{slug}) (name: dynamic.page)

You can change prefix/middleware via config/pagewire.php.

Home page (optional)

If you want Pagewire to render a "home" page at /, enable:

'home' => [
  'register_route' => true,
],

Pagewire will render the page marked is_home = true (if the column exists), otherwise it will fall back to the slug configured by pagewire.home.fallback_slug (default: home).

Layout

Set layout in config/pagewire.php (e.g., 'layout' => 'layouts.app') to force the Livewire pages to use a specific Blade layout. Leave it null to let the caller/default layout apply.

Sections

Builder lists templates by scanning config('pagewire.sections_paths') (defaults include resources/views/sections/*.blade.php). Provide matching section editor partials at resources/views/livewire/admin/page/section-editors/{section}.blade.php (or rely on the package defaults like the hero-area example).

Quick scaffolding:

php artisan pagewire:make-section hero-area

This creates:

• Front-end section: resources/views/sections/hero-area.blade.php
• Builder editor override (namespaced): resources/views/livewire/pagewire/section-editors/hero-area.blade.php
• Defaults + repeater stubs: resources/pagewire/sections/hero-area.php

Defaults and repeaters

To avoid editing vendor code, put per-section defaults and repeater item stubs in resources/pagewire/sections/{section}.php:

return [
  'defaults' => ['title' => '...', 'description' => '...'],
  'repeaters' => [
    'items' => ['title' => '', 'description' => ''],
    'team_members.social_links' => ['platform' => '', 'url' => ''],
  ],
];

The builder reads these files automatically via config('pagewire.definitions_path').

In editor blades, use the generic methods:

wire:click="repeaterAdd({{ $index }}, 'items')"
wire:click="repeaterRemove({{ $index }}, 'items', {{ $itemIndex }})"
wire:click="repeaterAddNested({{ $index }}, 'team_members', {{ $memberIndex }}, 'social_links')"
wire:click="repeaterRemoveNested({{ $index }}, 'team_members', {{ $memberIndex }}, 'social_links', {{ $linkIndex }})"

File uploads

Pagewire ships an anonymous Blade component you can use in your editor partials:

<x-pagewire::file-upload
  label="Background Image"
  accept="image/*"
  :aspectRatio="null"
  wire:model.live="pageContents.{{ $index }}.content.background_image"
/>

Component view: resources/views/components/file-upload.blade.php.

Dependencies

• Laravel ^12
• Livewire ^4
• Mary UI
• spatie/livewire-filepond

Authorization

This package does not ship Gate/Policy checks. Protect the admin routes using your app middleware/authorization as needed.

Models

The package ships Page, PageContent, and GlobalSection models plus migrations. admin_id, created_by, and updated_by reference your default user provider; override via PAGEWIRE_USER_MODEL env/config if needed.

Livewire components

• pagewire.admin.page.index – list, search, filter, duplicate, publish toggle, delete.
• pagewire.admin.page.builder – drag/drop sections, global reuse/override, publish/draft, file uploads.

Rendering public pages

The included pagewire::page view loops the stored sections and includes sections.{section_name}. Provide your front-end section blades there.

Editor assets (Quill, Cropper, etc.)

By default, Pagewire can load editor-related assets from CDNs on the builder page. Configure in config/pagewire.php:

• pagewire.cdn_assets.enabled (set false if your app bundles these)
• pagewire.cdn_assets.styles / pagewire.cdn_assets.scripts

Menu manager

Configure locations in config/pagewire.php:

'menu' => [
  'locations' => [
    'header' => 'Header',
    'footer' => 'Footer',
  ],
]

Then visit admin/menus to create menus, assign them to locations, and build nested menu items (drag-sort within each level; indent/outdent via buttons).