Inertia.js-Revamped

Appearance

Laravel Server-side Setup ​

This guide assumes you've already read the Project Structure Basics.

This document will guide you through the setup of the Laravel adapter.

Installation ​

Install the Inertia.js-Revamped server-side adapter using the Composer package manager.

shell
composer require inertiajs-revamped/laravel

The package will automatically register a service provider.

Setup Middleware ​

Next, install the middleware.

shell
php artisan inertia:middleware

Once the middleware has been published, append the HandleInertiaRequests middleware to the web middleware group in your application's bootstrap/app.php file.

php
use App\Http\Middleware\HandleInertiaRequests; 

->withMiddleware(function (Middleware $middleware) {
  $middleware->web(append: [ 
    HandleInertiaRequests::class, 
  ]); 
})

Publish Config ​

shell
php artisan vendor:publish --provider="Inertia\ServiceProvider"

Create app.blade.php ​

Proceed to delete resources/views, and create resources/views/app.blade.php.

blade
<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    @viteReactRefresh
    @vite('resources/application/main.tsx')
    @inertiaHead
  </head>
  <body>
    @inertia
  </body>
</html>

Server-side Rendering (SSR) ​

Server-side rendering uses Node.js to render your pages in a background process; therefore, Node must be available on your server for server-side rendering to function properly.

shell
# start the ssr server
php artisan inertia:start-ssr

# stop the ssr server
php artisan inertia:stop-ssr