README

installation

composer require neoisrecursive/inertia-tempest

Setup

It should be very familiar if you have used inertia before, with some small differences, for example:

• No configuration is done in the middleware, use the the config file, a provider class or your own middleware to set your "globally-shared-props".
• No automatic redirect back handling in non get requests, since all tempest routes must return a response you have to return your own Back response.
• Includes all validation errors for each field by default, instead of just the first one.

We provide an installer that you can use to set up some of the boilerplate code, but you can also do it manually.

Installer

First run the tempest vite installer (the inertia installer assumes you use vite):

./tempest install vite

Then you can run the inertia installer:

./tempest install inertia

Then all you have to do is to follow the instructions in the terminal. The only manual step is to add the vite plugin for your fe-framework to the vite config file.

Manual setup

If you don't want to use the installer, you can do the following steps manually:

Backend

If you use the default config, a view called app.view.php is required. That view will then be rendered as an NeoIsRecursive\Inertia\Views\InertiaBaseView and to render the inertia element you just do:

<x-inertia />

Frontend

Install the bundler of your choice, since tempest comes with a vite installer, that is very much recommended. Tempest vite docs.

When that is done, you can go on to install your prefered inertia client by following the guide on inertia's official site here

Usage

It is pretty similar to the Laravel adapter, except that to return an Inertia respone, you return a Component instance - like in your other Tempest routes.

use Tempest\Http\Get;
use NeoIsRecursive\Inertia\Http\Component;

final class ReviewController
{
    #[Get(uri: '/reviews/{review}')]
    public function show(Review $review): Component
    {
        return new Component('reviews/show', [
            'review' => $review,
        ]);
    }
}

Configuration

This is the default config:

<?php

use NeoIsRecursive\Inertia\DefaultSharedPropResolver;
use NeoIsRecursive\Inertia\InertiaConfig;
use NeoIsRecursive\Inertia\ManifestVersionResolver;

use function Tempest\root_path;

return new InertiaConfig(
    /**
     * The view that inertia should render on the first request
     */
    rootView: 'app.view.php',
    /**
     * Version resolver, if you use vite for example you probably want to use the default here,
     * or you can add a custom one to maybe get from enviroment variables etc.
     *
     * default path: public/build/manifest.json
     */
    versionResolver: new ManifestVersionResolver(),
    /**
     * Props that should be included in "all" requests, the default is errors and the authenticated user
     */
    sharedProps: [
        'user' => new AlwaysProp(fn(Authenticator $auth) => $auth->currentUser()),
        'errors' => new AlwaysProp(fn(ResolveErrorProps $errors) => $errors->resolve()),
    ]
);