marko/layout

Marko Framework Layout - Layout system with components and slots

0.3.0 2026-04-14 18:52 UTC

Requires

• php: ^8.5
• marko/core: 0.3.0
• marko/routing: 0.3.0
• marko/view: 0.3.0

Requires (Dev)

• marko/testing: 0.3.0
• pestphp/pest: ^4.0

MIT

README

Composable layout system with slot-based injection---define layouts and components with attributes, not configuration files.

Installation

composer require marko/layout

Quick Example

Define a layout component with named slots:

use Marko\Layout\Attributes\Component;

#[Component(
    template: 'blog::layout/default',
    slots: ['content', 'sidebar'],
)]
class DefaultLayout {}

Point a controller action at that layout:

use Marko\Layout\Attributes\Layout;
use Marko\Routing\Attributes\Get;
use Marko\Routing\Http\Response;

class PostController
{
    #[Get('/posts/{id}')]
    #[Layout(DefaultLayout::class)]
    public function show(int $id): Response
    {
        return new Response();
    }
}

Inject a page component into a slot from any module:

#[Component(
    template: 'blog::post/body',
    handle: 'post_show',
    slot: 'content',
)]
class PostBodyComponent {}

The layout middleware assembles all components targeting the current handle and renders the final page---no wiring required.

Documentation

Full usage, API reference, and examples: marko/layout