monkeyscloud / monkeyslegion-inertia

1.0.2 2026-09-29 02:08 UTC

Requires

• php: >=8.4
• monkeyscloud/monkeyslegion-core: ^2.1
• monkeyscloud/monkeyslegion-http: ^2.1
• monkeyscloud/monkeyslegion-router: ^2.2
• monkeyscloud/monkeyslegion-session: ^2.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

Published on Packagist.org on 2026-09-29 02:08 UTC

README

Inertia.js server-side adapter for the MonKeysLegion framework — bridges PHP controllers with React/Vue single-page applications.

Features

• Full Inertia.js protocol — X-Inertia headers, version mismatch (409), 303 redirects
• Server-side rendering (SSR) — optional Node.js SSR with graceful CSR fallback
• Shared props — global props available on every page
• Lazy props — deferred evaluation for performance
• Flash message bridge — session flash data to Inertia props
• PSR-15 middleware — drop-in middleware pipeline integration
• SSR manifest reader — Vite SSR manifest for CSS/JS chunk resolution

Installation

composer require monkeyscloud/monkeyslegion-inertia

Basic Usage

use MonkeysLegion\Inertia\Inertia;

// In a controller
return Inertia::render('Dashboard', [
    'user' => $user,
    'stats' => $stats,
]);

Server-Side Rendering

$inertia = $container->get(Inertia::class);
$inertia->enableSsr('http://localhost:13714');

// Now all renders go through the Node.js SSR server
// Falls back to client-side rendering if SSR is unavailable

Middleware

Register InertiaMiddleware in your middleware pipeline:

# config/middleware.mlc
middleware {
    global = ["inertia"]
}

License

MIT © MonKeysCloud