jengo / inertia

v1.1.33 2026-10-10 00:10 UTC

Requires

• php: ^8.5
• codeigniter4/framework: ^4.7
• gilads-otiannoh254/inertia-protocol: ^0.0
• jengo/base: ^1.1

Requires (Dev)

• codeigniter/coding-standard: ^1.7
• deptrac/deptrac: ^3.0
• ergebnis/composer-normalize: ^2.41
• icanhazstring/composer-unused: ^0.9.1
• infection/infection: ^0.32.4
• pestphp/pest: ^4.3
• pestphp/pest-plugin-faker: ^4.0
• pestphp/pest-plugin-type-coverage: ^4.0
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^12.5
• rector/rector: ^1.0
• vimeo/psalm: ^6.15

MIT

• Ian Oching

Published on Packagist.org on 2026-10-10 00:11 UTC

README

Jengo Inertia

Modern Single Page Application (SPA) adapter connecting CodeIgniter 4 with React, Vue 3, and Svelte via Inertia.js v3.

Documentation • License • Issues

Installation

composer require jengo/inertia
php spark jengo:install vite
php spark jengo:install inertia

Quick Start

namespace App\Controllers;

use Jengo\Inertia\Inertia;

class DashboardController extends BaseController
{
    public function index()
    {
        return Inertia::render('Dashboard', [
            'totalUsers' => 150,
            'recentActivity' => [...],
        ]);
    }
}

Exception Handling & Error Pages (New in v1.1.23)

To return matching Inertia components on errors (e.g. 404, 500, 403) instead of raw CodeIgniter HTML views, jengo/inertia provides InertiaExceptionHandler (introduced in v1.1.23).

In your app/Config/Exceptions.php:

use CodeIgniter\Debug\ExceptionHandlerInterface;
use Jengo\Inertia\Debug\InertiaExceptionHandler;
use Throwable;

public function handler(int $statusCode, Throwable $exception): ExceptionHandlerInterface
{
    return new InertiaExceptionHandler($this);
}

Running php spark jengo:install inertia automatically publishes this configuration. Error pages can be customized per status code in app/Config/Inertia.php via $errorPages.

Documentation

For full guides on Inertia v3 protocol features (lazy, deferred, and partial props), history encryption, exception handling, and Vite configuration, visit https://lipex-org.github.io/jengophp.com/packages/inertia.

License

Released under the MIT License.