Inertia Bundle for Symfony

Inertia.js for Symfony — build a Vue or React single-page app against your existing Symfony controllers, without hand-rolling a JSON API.

#[Route('/', name: 'home')]
public function index(InertiaInterface $inertia): Response
{
    return $inertia->render('Home', [
        'title' => 'Hello from Symfony!',
    ]);
}

Features

• Full Inertia.js v3 protocol — lazy, always, deferred (with groups), and merge/deep-merge props
• Automatic 302→303 redirect conversion and asset-version conflict handling (the two things every from-scratch integration forgets)
• Server-side rendering with a real body+head hand-off to your Twig shell
• Vite integration with automatic asset-version detection from the manifest
• Automatic auth data and flash message sharing on every response
• back() / redirect() / location() / redirectWithErrors() helpers
• History encryption (encryptHistory() / clearHistory())
• A testing trait (InertiaAssertionsTrait) for asserting on Inertia responses in PHPUnit

Requirements

• PHP 8.2+
• Symfony 7.0+ (including Symfony 8)
• symfony/security-bundle (used for automatic auth-data sharing)

Install

composer require creativspeed/inertia-bundle

Not using Symfony Flex? Register it manually:

// config/bundles.php
return [
    // ...
    CreativSpeed\InertiaBundle\InertiaBundle::class => ['all' => true],
];

Then read docs/installation.md for the root template, config, and frontend setup — there's a couple of details there (specifically around the protocol_version setting) worth getting right the first time.

Documentation

Contributing

Issues and PRs welcome at github.com/CreativSpeed/inertia-bundle.

License

MIT.

Made by CreativSpeed · bachir@creativspeed.com