PHPackages capell-app/layout-builder - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. capell-app/layout-builder ActiveLibrary capell-app/layout-builder ========================= The visual layout and widget composition engine for Capell CMS — content-first and drag-drop editing, responsive containers, reusable widgets, and safe public rendering. v1.0.19(2w ago)1223proprietaryPHPPHP ^8.4 Since Jul 11Pushed 2d agoCompare [ Source](https://github.com/capell-app/layout-builder)[ Packagist](https://packagist.org/packages/capell-app/layout-builder)[ Docs](https://github.com/capell-app/layout-builder)[ RSS](/packages/capell-app-layout-builder/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)Dependencies (8)Versions (23)Used By (3) Layout Builder ============== [](#layout-builder) What This Plugin Adds --------------------- [](#what-this-plugin-adds) Layout Builder is an **Available**, **Schema-owning** Capell package in the **Capell Foundation** product group. It ships as `capell-app/layout-builder` and extends these surfaces: admin, frontend, console. Layout Builder adds a visual page composition workflow with layout areas, widgets, reusable widgets, presets, and reversible layout edits. Editors can add, reorder, resize, and edit page widgets in admin. Visitors receive the saved layout graph as ordinary public output without authoring markers. Evidence: [`src/LayoutBuilderServiceProvider.php`](src/LayoutBuilderServiceProvider.php), [`src/Actions/PersistLayoutBuilderStateAction.php`](src/Actions/PersistLayoutBuilderStateAction.php), [`src/Actions/SaveLayoutPresetAction.php`](src/Actions/SaveLayoutPresetAction.php), [`tests/Feature/Livewire/LayoutBuilderContentFirstTest.php`](tests/Feature/Livewire/LayoutBuilderContentFirstTest.php), [`src/Actions/BuildPublicLayoutGraphAction.php`](src/Actions/BuildPublicLayoutGraphAction.php), [`tests/Feature/Render/LayoutBuilderPublicRenderingSafetyTest.php`](tests/Feature/Render/LayoutBuilderPublicRenderingSafetyTest.php), [`tests/Feature/Livewire/LayoutPresetLivewireTest.php`](tests/Feature/Livewire/LayoutPresetLivewireTest.php). Status details: - Status: Available - Tier: free - Bundle: foundation - Composer package: `capell-app/layout-builder` - Namespace: `Capell\LayoutBuilder` - Theme key: not applicable Why It Matters -------------- [](#why-it-matters) **For developers:** Registries and typed Actions provide stable extension points for widget definitions, layout widgets, presets, and public render data. **For teams:** Teams can compose pages and reuse approved sections without asking a developer to build a new template for each page. Evidence: [`src/Support/LayoutWidgets/LayoutWidgetRegistry.php`](src/Support/LayoutWidgets/LayoutWidgetRegistry.php), [`src/Support/WidgetExtensions/WidgetExtensionRegistry.php`](src/Support/WidgetExtensions/WidgetExtensionRegistry.php), [`src/Actions/BuildPublicLayoutGraphAction.php`](src/Actions/BuildPublicLayoutGraphAction.php), [`tests/Integration/PublicLayoutGraphActionTest.php`](tests/Integration/PublicLayoutGraphActionTest.php), [`docs/overview.admin.md`](docs/overview.admin.md), [`src/Actions/CreateLinkedLayoutPresetAction.php`](src/Actions/CreateLinkedLayoutPresetAction.php), [`src/Actions/InsertLinkedLayoutPresetAction.php`](src/Actions/InsertLinkedLayoutPresetAction.php). Screens And Workflow -------------------- [](#screens-and-workflow) Screenshot contract: `docs/screenshots.json`. [![Layout Builder visual editor with main and sidebar containers](docs/screenshots/layout-builder-editor-main-sidebar.png)](docs/screenshots/layout-builder-editor-main-sidebar.png) [![Layout Builder active-theme container settings](docs/screenshots/layout-builder-edit-container-theme-settings.png)](docs/screenshots/layout-builder-edit-container-theme-settings.png) - Layout Builder visual editor with main and sidebar containers (admin, required evidence). - Layout Builder content-first editing mode (admin, supplementary evidence). - Layout Builder add widget action (admin, supplementary evidence). - Layout Builder add container action (admin, supplementary evidence). - Layout Builder edit widget action (admin, supplementary evidence). - Layout Builder edit container action (admin, supplementary evidence). - Layout Builder active-theme container settings (admin, required evidence). - Layout Builder responsive padding controls on mobile (admin, required evidence). - Layout Builder active-theme container settings on mobile (admin, required evidence). - Layout Builder responsive preview (admin, supplementary evidence). - Layout Builder tree selection (admin, supplementary evidence). - Layout Builder filtered tree keyboard navigation (admin, supplementary evidence). - Layout Builder preset action fixture (frontend, supplementary evidence). - Layout Builder undo and redo actions fixture (frontend, supplementary evidence). - Layout Builder bulk change criteria fixture (frontend, supplementary evidence). - Layout Builder bulk change review fixture (frontend, supplementary evidence). - Layout Builder main and sidebar admin example (admin, supplementary evidence). - Layout Builder main and sidebar public example (frontend, supplementary evidence). - Layout Builder full-width public example (frontend, supplementary evidence). - Widgets admin index (admin, required evidence). - Create and edit widget form with widget assets (admin, required evidence). - Unused and disabled widget integrity state (admin, supplementary evidence). - Broken and unscoped widget asset integrity states (admin, supplementary evidence). - Sections admin index (admin, required evidence). - Widgets admin index with admin sidebar menu open (admin, supplementary evidence). Works With ---------- [](#works-with) - [Content Sections](../content-sections/README.md): optional integration backed by the interop evidence map. - [Frontend Authoring](../frontend-authoring/README.md): optional integration backed by the interop evidence map. - [Publishing Studio](../publishing-studio/README.md): optional integration backed by the interop evidence map. - [Structured Content Library](../structured-content-library/README.md): optional integration backed by the interop evidence map. Technical Shape --------------- [](#technical-shape) - Service providers: `Capell\LayoutBuilder\LayoutBuilderServiceProvider`, `AbstractFoundationWidgetServiceProvider`. - Config files: `packages/layout-builder/config/capell-layout-builder.php`. - Migrations: `packages/layout-builder/database/migrations/2026_05_10_190841_02_create_widgets_table.php`, `packages/layout-builder/database/migrations/2026_05_10_190841_03_create_widget_assets_table.php`, `packages/layout-builder/database/migrations/2026_05_10_190841_04_create_widget_widgets_table.php`, `packages/layout-builder/database/migrations/2026_05_10_190841_05_add_container_widgets_to_layouts_table.php`, `packages/layout-builder/database/migrations/2026_05_10_190841_06_create_layout_presets_table.php`, `packages/layout-builder/database/migrations/2026_06_07_000001_create_layout_bulk_change_tables.php`, `packages/layout-builder/database/migrations/2026_07_09_000001_create_public_widget_snapshots_table.php`, `packages/layout-builder/database/migrations/2026_07_10_000001_add_linked_preset_fields_to_layout_presets_table.php`, `packages/layout-builder/database/migrations/2026_07_10_000002_create_layout_preset_usages_table.php`, `packages/layout-builder/database/migrations/2026_07_10_000003_create_layout_preset_sync_runs_table.php`, `packages/layout-builder/database/migrations/2026_08_28_000003_change_widget_visibility_to_datetime.php`. - Models: `Layout`, `LayoutBulkChangeResult`, `LayoutBulkChangeRun`, `LayoutPreset`, `LayoutPresetSyncResult`, `LayoutPresetSyncRun`, `LayoutPresetUsage`, `PublicWidgetSnapshot`, `Widget`, `WidgetAsset`, `WidgetWidget`. - Filament classes: `CreateWidgetAction`, `ActionsRepeater`, `AlignSelect`, `AssetTypeSelect`, `AssetsRepeater`, `BackgroundSchema`, `BorderSelect`, `CarouselSettingsSchema`, `ColorSchemeComponent`, `ColumnInput`, `ContainerWidthSelect`, `CustomColorInput`, `and 84 more`. - Livewire components: `AuthorizesLayoutBuilderAccess`, `HasLayoutActions`, `ManagesAssets`, `ManagesContainers`, `ManagesLayoutBuilderState`, `ManagesWidgets`, `LayoutBuilder`, `ModalTableSelect`, `LayoutBuilderActionFactory`. - Policies: `LayoutPresetPolicy`. - Extension contracts: `PublicLayoutWidgetAssetsRenderer`, `LayoutContainerSchemaExtender`, `WidgetAssetSchemaExtender`, `WidgetSchemaExtender`, `LayoutContainerThemePresentationProjector`, `LayoutContentGroupContributor`, `LayoutSidebarWidgetContributor`, `PublicLayoutWidgetPayloadContributor`, `PublicLayoutWidgetPayloadResolver`, `WidgetAssetReferenceRepointer`, `WidgetExtensionBatchPayloadResolver`, `WidgetExtensionDependencyResolver`, `and 2 more`. - Listeners: `AfterRecordSaved`, `LayoutLoaded`, `MaintainPublicWidgetSnapshotsListener`, `SiteTreeRebuilt`, `TypeValidated`. - Actions: `AddHeroWidgetToLayoutAction`, `AddWidgetToLayoutContainerAction`, `AnalyzeLayoutDiagnosticsAction`, `AnalyzeLayoutHealthAction`, `ApplyLayoutPresetAction`, `ApplyLayoutSidebarWidgetContributionsAction`, `ApplyStarterLayoutPresetAction`, `AttachWidgetToLayoutAreaAction`, `BuildLayoutBuilderTreeAction`, `BuildLayoutContentInventoryAction`, `BuildLayoutHealthWorkQueueAction`, `BuildPublicLayoutGraphAction`, `and 78 more`. - Data objects: `AdminLayoutPreviewData`, `AdminWidgetPreviewData`, `ActivityItemData`, `LayoutHealthData`, `LayoutHealthWorkQueueItemData`, `LeastUsedWidgetData`, `RecentActivityData`, `UnusedWidgetData`, `WidgetGroupData`, `DemoSitePlanData`, `LayoutAssetBridgeData`, `LayoutBuilderStateData`, `and 43 more`. - Jobs: `ApplyLayoutBulkChangeRunJob`, `SyncLinkedLayoutPresetJob`. - Command signatures: `capell:layout-builder-install`, `capell:layout-builder:prune-bulk-change-runs`. - Manifest action API: `install: Capell\LayoutBuilder\Actions\InstallLayoutBuilderPackageAction`, `pruneLayoutBulkChangeRuns: Capell\LayoutBuilder\Actions\PruneLayoutBulkChangeRunsAction`, `setup: Capell\LayoutBuilder\Actions\SetupLayoutBuilderPackageAction`. - Scheduled commands: `capell:layout-builder:prune-bulk-change-runs (daily; manifest declared)`, `capell:widget-snapshots:prune (daily; manifest declared)`. - Console command classes: `InstallCommand`, `LayoutBulkChangeCommand`, `PruneLayoutBulkChangeRunsCommand`, `PrunePublicWidgetSnapshotsCommand`, `ResyncLayoutPresetCommand`, `WidgetVisualRegressionCommand`. - Manifest contributions: `admin-resource: Capell\LayoutBuilder\Support\LayoutBuilderAdminRegistrar`, `asset: Capell\LayoutBuilder\Support\LayoutBuilderAdminRegistrar`, `configurator: Capell\LayoutBuilder\Support\LayoutBuilderAdminRegistrar`, `migration: Capell\LayoutBuilder\Manifest\LayoutBuilderMigrationsContribution`, `model: Capell\LayoutBuilder\Manifest\LayoutBuilderModelsContribution`, `page-type: Capell\LayoutBuilder\Manifest\LayoutBuilderPageTypesContribution`, `route: Capell\LayoutBuilder\Manifest\LayoutBuilderRoutesContribution`, `scheduled-job: Capell\LayoutBuilder\Manifest\LayoutBuilderBulkChangePruneScheduleContribution`, `scheduled-job: Capell\LayoutBuilder\Manifest\LayoutBuilderSnapshotPruneScheduleContribution`, `schema-extender: Capell\LayoutBuilder\Support\LayoutBuilderAdminRegistrar`. - Health checks: `Capell\LayoutBuilder\Health\LayoutBuilderHealthCheck`. - Blade views: `packages/layout-builder/resources/views/components/filament/layout-builder/asset.blade.php`, `packages/layout-builder/resources/views/components/filament/layout-builder/assets.blade.php`, `packages/layout-builder/resources/views/components/filament/layout-builder/container.blade.php`, `packages/layout-builder/resources/views/components/filament/layout-builder/drag-handle-icon.blade.php`, `packages/layout-builder/resources/views/components/filament/layout-builder/widget.blade.php`, `packages/layout-builder/resources/views/components/infolists/entries/layout-widget.blade.php`, `packages/layout-builder/resources/views/components/infolists/entries/layout-widgets.blade.php`, `packages/layout-builder/resources/views/components/layout-widget-assets.blade.php`, `packages/layout-builder/resources/views/components/layout-widgets/content.blade.php`, `packages/layout-builder/resources/views/components/layout-widgets/extension-gated.blade.php`, `packages/layout-builder/resources/views/components/layout-widgets/extension-unavailable.blade.php`, `packages/layout-builder/resources/views/components/layout-widgets/image.blade.php`, `and 25 more`. - Cache tags: `layout-builder`. Data Model ---------- [](#data-model) - Required tables: `layouts`, `widgets`, `widget_assets`, `widget_widgets`, `layout_presets`, `layout_bulk_change_runs`, `layout_bulk_change_results`, `layout_preset_usages`, `layout_preset_sync_runs`, `layout_preset_sync_results`, `public_widget_snapshots`. - Models: `Layout`, `LayoutBulkChangeResult`, `LayoutBulkChangeRun`, `LayoutPreset`, `LayoutPresetSyncResult`, `LayoutPresetSyncRun`, `LayoutPresetUsage`, `PublicWidgetSnapshot`, `Widget`, `WidgetAsset`, `WidgetWidget`. - Core record references in migrations: `sites via site_id`, `languages via language_id`, `layouts via layout_id`, `widgets via widget_id`, `themes via theme_id`. - Migration files: `2026_05_10_190841_02_create_widgets_table.php`, `2026_05_10_190841_03_create_widget_assets_table.php`, `2026_05_10_190841_04_create_widget_widgets_table.php`, `2026_05_10_190841_05_add_container_widgets_to_layouts_table.php`, `2026_05_10_190841_06_create_layout_presets_table.php`, `2026_06_07_000001_create_layout_bulk_change_tables.php`, `2026_07_09_000001_create_public_widget_snapshots_table.php`, `2026_07_10_000001_add_linked_preset_fields_to_layout_presets_table.php`, `2026_07_10_000002_create_layout_preset_usages_table.php`, `2026_07_10_000003_create_layout_preset_sync_runs_table.php`, `2026_08_28_000003_change_widget_visibility_to_datetime.php`. - Migration impact: run host migrations through the package install flow before opening package surfaces. - Deletion/retention behaviour: migrations declare cascade-on-delete relationships and null-on-delete relationships; retention is scheduled through `capell:widget-snapshots:prune` (daily; declared in the manifest) and `capell:layout-builder:prune-bulk-change-runs` (daily; declared in the manifest). Install Impact -------------- [](#install-impact) - Required packages: `capell-app/core`, `capell-app/admin`, `capell-app/block-library`, `capell-app/frontend`. - Admin navigation: declares `admin-resource: LayoutBuilderAdminRegistrar`; each Filament page or resource controls its own navigation visibility. - Admin/editor extensions: `configurator: LayoutBuilderAdminRegistrar`, `schema-extender: LayoutBuilderAdminRegistrar`. - Permissions: `ViewAny:Layout`, `View:Layout`, `Create:Layout`, `EditContent:Layout`, `EditLayout:Layout`, `Update:Layout`, `Delete:Layout`, `DeleteAny:Layout`, `Restore:Layout`, `ForceDelete:Layout`, `Replicate:Layout`, `Reorder:Layout`, `BulkMutate:Layout`. - Public routes: registers `LayoutBuilderRoutesContribution`. - Database changes: package migrations are declared. - Config: `config/capell-layout-builder.php`. - Settings: no package settings declared. - Queues or schedules: scheduled commands `capell:layout-builder:prune-bulk-change-runs (daily; manifest declared)`, `capell:widget-snapshots:prune (daily; manifest declared)`; queue jobs `ApplyLayoutBulkChangeRunJob`, `SyncLinkedLayoutPresetJob`. - Cache tags: `layout-builder`. - Commands: `capell:layout-builder-install`, `capell:layout-builder:prune-bulk-change-runs`. Common Pitfalls --------------- [](#common-pitfalls) - Keep required Capell packages on compatible v4 releases: `capell-app/core`, `capell-app/admin`, `capell-app/block-library`, `capell-app/frontend`. - Run migrations before opening package resources or public routes. - Review package configuration before production-like verification: `config/capell-layout-builder.php`. - Keep the host Laravel scheduler running so package-registered schedules can execute: `capell:layout-builder:prune-bulk-change-runs (daily; manifest declared)`, `capell:widget-snapshots:prune (daily; manifest declared)`. - Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries. - Custom write integrations must preserve invalidation for `layout-builder` cache tags. Troubleshooting --------------- [](#troubleshooting) SymptomLikely causeCheckFixPackage surface is missing after installProvider or manifest is not loadedConfirm `capell.json`, package `composer.json`, and provider registrationReinstall the package, refresh Composer autoload, and clear host cachesAdmin screen or command fails on missing tablePackage migrations have not runCheck the tables listed in `Data Model`Run host migrations and rerun the focused package testBackground work does not runQueue worker or declared schedule is not activeCheck the jobs and scheduled commands listed in `Technical Shape`Start the queue worker or host scheduler, then run the focused command or package testPublic output leaks unexpected stateRender data, cache variation, or authoring boundary has regressedCheck public Blade, cache tags, and public-output safety testsMove data loading out of Blade and rerun the package public-output testsQuick Start ----------- [](#quick-start) 1. Install the package: `composer require capell-app/layout-builder`. 2. Run the required setup: `php artisan capell:layout-builder-install`. 3. Open the package admin surface at `/screenshot-fixtures/layout-builder-admin-editor` and confirm Layout Builder is available. Next Steps ---------- [](#next-steps) - [Package docs](docs/README.md) - [Overview](docs/overview.md) - [Admin guide](docs/admin-guide.md) - Configuration files: [`config/capell-layout-builder.php`](config/capell-layout-builder.php). - [Troubleshooting](#troubleshooting) - [Screenshot contract](docs/screenshots.json) - [Marketplace assets](docs/assets/marketplace/) - [Capell content language plan](../../docs/CONTENT_LANGUAGE_PLAN.md) - [Capell documentation design system](../../docs/DESIGN_SYSTEM.md) - [Capell and package ERD notes](../../docs/erd/capell-and-package-erds.md) - Related packages: [Block Library](../block-library/README.md), [Content Sections](../content-sections/README.md), [Frontend Authoring](../frontend-authoring/README.md), [Publishing Studio](../publishing-studio/README.md), [Structured Content Library](../structured-content-library/README.md). - Focused tests: `vendor/bin/pest packages/layout-builder/tests --configuration=phpunit.xml`. ### Health Score 49 — FairBetter than 94% of packages Maintenance98 Actively maintained with recent releases Popularity11 Limited adoption so far Community16 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 97.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~21 days Recently: every ~2 days Total 20 Last Release 16d ago Major Versions 3.x-dev → 4.x-dev2026-07-09 PHP version history (2 changes)3.x-devPHP ^8.0|^8.1|^8.2 4.x-devPHP ^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/85b211531c530cd60c8e1b7b2c125c7e42192c820cde99fb6b201b1dde7a9d96?d=identicon)[capell-app](/maintainers/capell-app) --- Top Contributors [![howdu](https://avatars.githubusercontent.com/u/533658?v=4)](https://github.com/howdu "howdu (1425 commits)")[![capell-app-user](https://avatars.githubusercontent.com/u/213955377?v=4)](https://github.com/capell-app-user "capell-app-user (20 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (14 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (4 commits)") --- Tags capellcapell-cmsdrag-and-dropfilamentlaravellayout-builderlivewirepage-builderphpwidgetscmslivewirelayout builderfilamentcapell ### Embed Badge ![Health badge](/badges/capell-app-layout-builder/health.svg) ``` [![Health](https://phpackages.com/badges/capell-app-layout-builder/health.svg)](https://phpackages.com/packages/capell-app-layout-builder) ``` ### Alternatives [riodwanto/superduper-filament-starter-kit A comprehensive Laravel Filament 3 💡 starter kit with pre-installed plugins, admin panel, user management, SEO tools, theme customization, and content management for rapid application development 2818.7k](/packages/riodwanto-superduper-filament-starter-kit)[qalainau/filament-team-chat A Slack-like team chat plugin for Filament v5 153.0k](/packages/qalainau-filament-team-chat) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)