htmxology Expert

htmxology is a type-safe HTMX routing framework for Rust/Axum. It replaces string-based routing with enum-based routes that are verified at compile time, and provides automatic HTMX request detection, response building, and out-of-band swap support.

Core Concepts

• Routes are enums — no string URLs to mistype
• Controllers handle routes — match arms dispatch to handlers
• RoutingController composes controllers — hierarchical nesting with path prefixes
• Templates use route helpers — type-safe URL generation in Jinja2
• HtmxRequest detection — automatic classic vs HTMX differentiation
• OOB updates — typed out-of-band swaps via Identity + Fragment traits

Route Definition

Define routes as enum variants with #[derive(htmxology::Route)]: