name: engram-dashboard-htmx description: > HTMX and templ interaction rules for the Engram dashboard. Trigger: Any change to htmx attributes, partial updates, forms, or server-rendered browser UI. license: Apache-2.0 metadata: author: gentleman-programming version: "1.0"
When to Use
Use this skill when:
- Adding htmx partial loading or filter controls
- Wiring forms or toggles in the dashboard
- Changing browser/search interactions
HTMX Rules
- Server-rendered HTML is the product; htmx enhances it, it does not replace it.
- Prefer simple
hx-getandhx-includeover custom client-side state. - Filters must preserve the active state users would expect across interactions.
- Forms that mutate system state must still work as normal HTTP posts.
- Partial endpoints return meaningful HTML on their own, not fragments that depend on hidden JS assumptions.
Interaction Rules
- Search and filter controls must compose cleanly.
- Toggle actions must visibly reflect the resulting server state.
- Connected navigation should keep URLs meaningful and shareable.
- Use htmx for speed, not to hide business logic in the browser.