Skip to content
Inertia

Middleware

HandleInertiaRequests (typealias InertiaMiddleware) should sit on the HTTP kernel for all Inertia routes.

  1. Resolve Inertia.manager() (requires booted InertiaServiceProvider)
  2. setRequest(request)
  3. Apply share(request) → shareForRequest
  4. Optional version(request) → updates manager.version
  5. If versionConflict(request) → return decorated 409
  6. Else decorate(next.handle(request))
  7. finally → setRequest(null) (clears request-scoped shared props)
Method Default Purpose
share(request) empty map Per-request props
version(request) null (keep manager version) Dynamic asset version
app.resolve(HttpKernel::class.java).pushMiddleware(HandleInertia())
// or alias via HttpMiddleware if you use the web stack

Push after InertiaServiceProvider has booted so the facade manager is set.