index.md

ASP.NET Core + HTMX

HtmxToolkit guides

Build server-rendered interactions with typed requests, fluent responses, Razor Tag Helpers, version-aware configuration, and automatic antiforgery.

Get started API reference

These guides focus on complete application tasks; the API reference documents individual types and members.

Start here

Concept Overview Understand what the toolkit provides and where HTMX itself fits. Tutorial Getting started Build a working interaction from installation through a server-rendered fragment. Decision Choose an HTMX version Target the correct markup for HTMX 1.x, 2.x, or 4.x.

Build an integration

Full pages and fragmentsSupport normal navigation and HTMX from the same application. Read HTMX requestsDetect requests, inspect typed headers, and select MVC actions. Control HTMX responsesChoose targets, swaps, navigation, history, and client events. Use Tag HelpersGenerate URLs, values, headers, and request options from Razor.

Configure and operate

Application configurationRender strongly typed global settings for the selected version. Version compatibilityCompare requests, configuration, events, and swaps across releases. Antiforgery and assetsProtect non-GET requests and deploy the companion script. Common recipesImplement validation, polling, redirects, and cross-component updates. TroubleshootingDiagnose failures from generated markup and browser network data.

Tip

If an application already uses HTMX, begin with Choose an HTMX version, then add only the toolkit features it needs.