Resources and Notes
Version state, reading list, and how this connects to theok.
Version state (verified October 2026)
| Line | Status | Notes |
|---|---|---|
| 1.x | maintained | served at v1.htmx.org for IE11 support; migration guide at htmx.org/migration-guide-htmx-1 |
| 2.x | stable, current | 2.0.11 (package.json on master; docs CDN pin). <hx-partial> server-sent swap commands are already documented and implemented here (src/htmx.js:2004) |
| 4.0 | beta only | newest tag v4.0.0-beta6; no stable release. Plans in the-fetchening.md: promoted <htmx-partial> tag, streaming support, OOB simplifying toward plain id replacement |
Write against 2.x today; the 4.0 ideas to watch are streaming and the partial-tag promotion, both extensions of what 2.x already does.
Essays worth reading
All in the repo mirror:
- locality-of-behaviour.md - the design principle behind attributes-in-markup
- hypermedia-driven-applications.md - the HDA architecture term
- 10-tips-for-SSR-HDA-apps.md - practical guidance, the best first deep-read
- hateoas.md and does-hypermedia-scale.md - the two theory questions everyone eventually asks
- complexity-budget.md - framing for framework exits
- a-real-world-nextjs-to-htmx-port.md - a concrete port with before/after code
The essays index lives at essays/ (or htmx.org/essays). The docs intro also links a quirks page - a short list of browser and htmx edge cases worth one read before shipping.
theok relevance
htmx is the interactivity layer candidate for the Go-native rendering path:
- templ integration: templ has first-class fragment support for exactly this style -
@templ.Fragment("name")marks a subsection, and a handler withtempl.WithFragments("name")renders just that fragment while a handler without it renders the whole page, which is theHX-Requestbranch in template form. See _repos/a-h-templ/docs/docs/03-syntax-and-usage/19-fragments.md. - What htmx would replace: the client-side React islands (share actions, load-more, player controls) become server-rendered fragments swapped by attributes - the patterns in Common Patterns map directly.
- Pre-reading before a spike: the Next.js port essay above plus the 10-tips essay. Together they cover the migration mechanics and the server-structure conventions that make an HDA maintainable.