Creating Responses

We’re creating Inertia responses inside Kirby controllers. You can use the Inertia::createResponse() method to correctly format the response. The default controller simply runs the toArray() methods on the Pages. You can override this by creating a custom controller for your page templates.

<?php

use Kirby\Cms\Page;
use tobimori\Inertia\Inertia;

return function (Page $page) {
	return Inertia::createResponse(
		$page->intendedTemplate(), // the component name passed to inertia
		$page->toArray() // the props passed to the component
	);
};

If you need to access any additional data in the Kirby template, you can pass it on by returning an array as the third argument.

Lazy Evaluation

Inertia allows partial requesting of data from the server. In that case, if you’re running resource-heavy operations in your controller, you might want to delay them until they’re actually needed. You can do this by utilizing Kirby’s LazyValue class as props.

Inertia::createResponse(
	'page',
	[
		'title' => $page->title(), // will be evaluated immediately
		'children' => new LazyValue(function () use ($page) { // will be evaluated when requested
			return $page->children()->listed();
		})
	]
);

Shared data

Shared data can be defined anywhere in your application before the first inertia() or inertiaHead() call in the template. You can use the Inertia::share() method to define shared data.

Inertia::share('user', kirby()->user()->id());

You can also use the config option tobimori.inertia.shared to define shared data in your site/config/config.php file.

// site/config/config.php
return [
	'tobimori.inertia.shared' => [
		'user' => new LazyValue(function () { // lazy evaluation works here as well
			return kirby()->user()->id();
		})
	]
];

Keep in mind that you can’t access the Kirby instance in the config file, so we’re using the LazyValue class here.

Server-side rendering

Inertia allows you to render your application on the server-side. This is especially useful for SEO and performance reasons. To enable server-side rendering, you need to set the tobimori.inertia.ssr.enabled config option to true.

// site/config/config.php
return [
	'tobimori.inertia.ssr' => [
		'enabled' => true,
		'server' => 'http://127.0.0.1:13714'
	],
];

You’ll also have to specify the URL of the server-side renderer.

Kirby Inertia doesn’t provide a command to start the server-side renderer like the Laravel package, you’ll have to implement that yourself using a process manager like PM2.

Custom routes

If you want to use custom routes for your Inertia application (e.g. when data is defined in the component), you can use the Inertia::route() helper to define a custom route in your site/config/config.php file.

// site/config/config.php
return [
	'routes' => [
		Inertia::route('about', 'about') // renders the about component on /about
	]
];

Caching

Support for Kirby caching is currently WIP, stuff might not work with the pages cache enabled.

Auto Templates

This plugin automatically assigns the default template to all pages with a controller that don’t have a template assigned. This is necessary so Kirby picks up the correct controller.