litestar-htmx

Litestar has first-party HTMX support in litestar_htmx. It exposes HTMXPlugin, HTMXRequest (request-side helpers), HTMXTemplate (template response with HTMX headers), and HTMX-specific response objects (TriggerEvent, Reswap, Retarget, PushUrl, HXLocation, ClientRedirect, ClientRefresh).

This skill is Litestar-specific. For generic HTMX hx-* attributes and patterns that aren't Litestar-bound, refer directly to https://htmx.org/docs/.

Code Style Rules

• PEP 604 unions: T | None, never Optional[T]
• Consumer Litestar app modules MAY use from __future__ import annotations
• Async all I/O — handlers are async def
• Return partial HTML, not full pages, from HTMX-targeted endpoints
• Use Jinja2 (or Mako) templates for partials; do not string-concat HTML

Quick Reference

HTMXRequest

HTMXRequest is a Request subclass with HTMX-aware properties: