Inertia.Net.Mvc 1.5.3

Inertia.Net.Mvc

Use the 1.5 packages together; from 1.3 or earlier, see the 1.4 upgrade notes. TempData state formats are unchanged.

MVC integration for Inertia.Net, a .NET 10 server adapter for the Inertia.js v3 protocol. Install it next to Inertia.Net:

dotnet add package Inertia.Net
dotnet add package Inertia.Net.Mvc

builder.Services.AddInertia();
builder.Services.AddControllersWithViews().AddInertiaMvc(o => o.UseRazorRootView("App")); // UseRazorRootView is optional
builder.Services.AddAntiforgery(o => o.HeaderName = InertiaHeaders.XsrfToken);

var app = builder.Build();
app.UseStaticFiles();
app.UseInertia();
app.UseInertiaAntiforgery();   // CSRF: XSRF-TOKEN cookie, 419 for mutations without a valid token
app.MapControllers();

public sealed class UsersController : Controller
{
    [HttpGet("/users")]
    public IResult Index() => Render("Users/Index", new InertiaProps { ["users"] = users });   // also Back(), Location(url)

    [HttpPost("/users")]
    public IActionResult Store([FromBody] CreateUserInput input) => Redirect("/users");
}

• Validation: a global filter redirects an Inertia non-GET request with an invalid ModelState back with the errors, in the bag named by X-Inertia-Error-Bag (default default). Keys go through the JSON naming policy per segment (Address.Street becomes address.street). [ApiController] controllers are covered too.
• Razor root view (optional): UseRazorRootView("App") renders Views/Shared/App.cshtml with an InertiaRootViewContext model. After @addTagHelper *, Inertia.Net.Mvc the view can use <inertia />, <inertia-head />, <vite entry="resources/js/app.tsx" /> and <vite-react-refresh />.
• TempData state store (optional): AddInertiaMvc(o => o.UseTempDataStateStore()) keeps flash data, errors and history flags in TempData (cookie provider by default, or AddSessionStateTempDataProvider() plus AddSession()/app.UseSession() before app.UseInertia()). It also serves Minimal API endpoints.
• Action components: return this.InertiaView(props); renders {Controller}/{Action} ({Area}/... in an area); change the rule with AddInertiaMvc(o => o.ComponentResolver = ctx => ...).
• Not Native AOT compatible (MVC is not).

Documentation:

• Quick start (MVC)
• Root template and Razor
• Validation and error bags