Inertia.Core
0.1.1
dotnet add package Inertia.Core --version 0.1.1
NuGet\Install-Package Inertia.Core -Version 0.1.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Inertia.Core" Version="0.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Inertia.Core" Version="0.1.1" />
<PackageReference Include="Inertia.Core" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Inertia.Core --version 0.1.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Inertia.Core, 0.1.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Inertia.Core@0.1.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Inertia.Core&version=0.1.1
#tool nuget:?package=Inertia.Core&version=0.1.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Inertia.Core
Inertia.js server-side adapter for ASP.NET Core
Create modern single-page applications using classic server-side routing and controllers. No APIs required.
What is Inertia?
Inertia.js lets you build single-page apps (SPAs) without building an API. You write controllers like you normally would, and Inertia handles the client-side routing and rendering automatically.
Installation
dotnet add package Inertia.Core
Quick Start
1. Register Services
using Inertia.Core;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
builder.Services.AddInertia(options =>
{
options.Version = "1.0.0";
options.RootView = "_Inertia";
});
var app = builder.Build();
app.UseInertia();
app.MapControllers();
app.Run();
2. Create Root View
Create Views/Shared/_Inertia.cshtml:
@using Inertia.Core
@{
Layout = null;
var page = ViewData["page"] as Page;
var pageJson = ViewData["pageJson"] as string ?? "{}";
}
<!DOCTYPE html>
<html>
<head>
<title>@(page?.Component ?? "Inertia App")</title>
</head>
<body>
<div id="app" data-page='@Html.Raw(pageJson)'></div>
<script>window.__INERTIA_PAGE__ = @Html.Raw(pageJson);</script>
</body>
</html>
3. Return Inertia Responses
public class HomeController : Controller
{
private readonly IInertia _inertia;
public HomeController(IInertia inertia)
{
_inertia = inertia;
}
public IActionResult Index()
{
_inertia.Share("appName", "My App");
return this.Inertia("Home/Index", new Dictionary<string, object?>
{
["message"] = "Hello from Inertia!"
});
}
}
Features
- Server-Side Rendering (SSR) - Built-in SSR support with configurable renderers
- Lazy Props - Defer expensive data loading until needed
- Deferred Props - Load data on subsequent requests
- Partial Reloads - Only fetch the data you need with
only/except - Validation Errors - Automatic ModelState integration with Inertia-compatible format
- Versioning - Automatic asset version checking to handle deployments
- Shared Data - Share data across all responses
Configuration
builder.Services.AddInertia(options =>
{
options.RootView = "_Inertia"; // Root Razor view
options.Version = "1.0.0"; // Static version string
options.EnableSSR = true; // Enable server-side rendering
options.SSREndpoint = "http://..."; // SSR server endpoint
// Or use a version resolver
options.VersionResolver = _ => File.GetLastWriteTime("wwwroot/dist").Ticks.ToString();
});
Lazy & Deferred Props
public IActionResult Dashboard()
{
return this.Inertia("Dashboard/Index", new Dictionary<string, object?>
{
// Always included
["user"] = _db.Users.Find(userId),
// Only resolved when explicitly requested
["posts"] = InertiaExtensions.Lazy(() => _db.Posts.ToList()),
// Resolved only when 'stats' group is requested
["stats"] = InertiaExtensions.Deferred("stats", () => GetStats())
});
}
Validation
[HttpPost]
public IActionResult Store([FromBody] CreateRequest request)
{
this.InertiaValidate(ModelState, "createForm");
// Validation passed...
}
The validation errors will be returned in Inertia-compatible format with a 422 status code.
Project Structure
Inertia.Core/
├── src/
│ ├── IInertia.cs # Main service interface
│ ├── InertiaService.cs # Core implementation
│ ├── InertiaResult.cs # ActionResult for Inertia responses
│ ├── InertiaMiddleware.cs # Request/response handling
│ ├── InertiaExtensions.cs # Service registration & helpers
│ ├── InertiaOptions.cs # Configuration options
│ ├── Page.cs # Inertia page data model
│ ├── InertiaConstants.cs # Header names & helpers
│ ├── LazyProp.cs # Lazy prop wrapper
│ ├── InertiaValidationException.cs # Validation handling
│ └── ISSRRenderer.cs # SSR interface
└── Inertia.Core.csproj
Testing
Run the test suite:
dotnet test tests/Inertia.Core.Tests
License
MIT License - see LICENSE for details.
Contributing
Contributions are welcome! Please read our Contributing Guide for details.
Support
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Inertia.Core:
| Package | Downloads |
|---|---|
|
Inertia.React
React adapter for Inertia.js on ASP.NET Core |
GitHub repositories
This package is not used by any popular GitHub repositories.