inertia-defer-default

What problem does it solve?

It prevents slow, unnecessary backend SQL work from running during Inertia partial reloads, which otherwise causes users to experience “full page loading” and degraded UX.

Core Features & Use Cases

• Default defer for heavy props: Ensures controller props backed by expensive SQL, aggregates, eager-loads, service DB calls, or external HTTP are wrapped with Inertia::defer(fn () => ...).
• Frontend-safe deferred rendering: Guides pages to use Inertia <Deferred> with skeleton fallbacks and to mark deferred props as optional (?:) to avoid blank screens from undefined access.
• Exception handling and verification: Defines legitimate exceptions where defer should not be applied and provides a checklist to confirm the pattern is followed.

Quick Start

Ask the AI to update your Inertia controller and page so any heavy query props are wrapped with Inertia::defer and are rendered via <Deferred> with an appropriate skeleton fallback.