Crumbls

Templates provide pre-built page layouts that can be loaded into new or existing pages.

Built-in templates

Layup ships with five templates stored as JSON files in resources/templates/:

Blank -- empty page with no content
Landing -- landing page with hero, features, and CTA sections
About -- about page layout
Contact -- contact page with form
Pricing -- pricing tiers layout

Creating custom templates

From an existing page

Save any page's content as a reusable template:

use Crumbls\Layup\Support\PageTemplate;

PageTemplate::saveFromPage(
    name: 'Product Page',
    content: $page->content,
    description: 'Standard product landing page',
);

This writes a JSON file to resources/layup/templates/product-page.json.

Manually

Create a JSON file in resources/layup/templates/:

{
    "name": "My Template",
    "description": "Description shown in the template picker",
    "thumbnail": null,
    "content": {
        "rows": [
            {
                "id": "row-1",
                "settings": {},
                "columns": [
                    {
                        "id": "col-1",
                        "span": {"sm": 12, "md": 12, "lg": 12, "xl": 12},
                        "settings": {},
                        "widgets": [
                            {
                                "id": "widget-1",
                                "type": "heading",
                                "data": {"content": "Page Title", "level": "h1"}
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

Publish the templates directory first:

php artisan vendor:publish --tag=layup-templates

Using templates programmatically

use Crumbls\Layup\Support\PageTemplate;

// Get all templates (built-in + custom)
$templates = PageTemplate::all();

// Get a single template by slug
$template = PageTemplate::get('landing');
// Returns: ['name' => 'Landing', 'description' => '...', 'content' => [...]]

// Get options for a select dropdown
$options = PageTemplate::options();
// Returns: ['blank' => 'Blank', 'landing' => 'Landing', ...]

Contributors

Thank you to everyone who has contributed to this package. Every pull request, bug report, and idea makes a difference.

chasecmiller

TheGodlyLuzer

DGINXREAL