# hyperlibs/htmxui architecture

> Architecture diagram of the GitHub repository hyperlibs/htmxui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hyperlibs/htmxui
- Repository: https://github.com/hyperlibs/htmxui

## Overview

HTMXUI is a hypermedia-oriented UI platform: backend engineers define server-owned interfaces, while browser-side engines add reactive state and focused interaction capabilities. The repository also contains a demo server and a browser DevTools extension. The README documents the engines’ roles; the source excerpts show their exports and individual behavior, but do not establish runtime wiring between most engines and the server. Groups and modules reflect the documented product, not a fully verified call graph.

Main entry points: [`src/index.ts`](https://github.com/hyperlibs/htmxui/blob/master/src/index.ts) (Engine exports), [`server.ts`](https://github.com/hyperlibs/htmxui/blob/master/server.ts) (Demo server), [`demos.ts`](https://github.com/hyperlibs/htmxui/blob/master/demos.ts) (Demo catalog), [`src/htmx-bolt.ts`](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-bolt.ts) (Signals and state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_demo["Demo server"]
  node_server["Demo server<br/>[server.ts]"]
  node_demos["Demo catalog<br/>[demos.ts]"]
end

subgraph group_core["Framework core"]
  node_exports["Engine exports<br/>[index.ts]"]
  node_bolt["Signals and state<br/>[htmx-bolt.ts]"]
  node_appz["App navigation and hardware<br/>[appz.ts]"]
  node_go_components["Go component catalog<br/>[components.go]"]
  node_go_appz["Go Appz components<br/>[appz.go]"]
  node_go_api["Go framework API<br/>[htmxui.go]"]
end

subgraph group_data["Data and forms"]
  node_form["Forms and transactions<br/>[htmx-form.ts]"]
  node_flash["Search and column store<br/>[htmx-flash.ts]"]
  node_grid["Enterprise data grid<br/>[htmx-grid.ts]"]
  node_virtual["Virtual scrolling<br/>[htmx-virtual.ts]"]
  node_calc["Formula engine<br/>[htmx-calc.ts]"]
  node_offline["Offline mutation queue<br/>[htmx-offline.ts]"]
end

subgraph group_interaction["UI interactions"]
  node_a11y["Accessibility navigation<br/>[htmx-a11y.ts]"]
  node_vibe["Motion and animation<br/>[htmx-vibe.ts]"]
  node_sim["Physics simulation<br/>[htmx-sim.ts]"]
  node_canvas["Canvas engine<br/>[htmx-canvas.ts]"]
end

subgraph group_diagnostics["Diagnostics"]
  node_devtools["Runtime diagnostics<br/>[htmx-devtools.ts]"]
  node_extension["DevTools extension panel<br/>[panel.js]"]
  node_extension_setup["DevTools registration<br/>[devtools.js]"]
  node_extension_background["Extension background<br/>[background.js]"]
  node_extension_content["Page content script<br/>[content_script.js]"]
end

node_engineer(("Backend engineer"))

node_engineer -.->|"explores demos"| node_server
node_server -->|"uses catalog"| node_demos
node_exports -->|"exports"| node_bolt
node_exports -->|"exports"| node_a11y
node_exports -->|"exports"| node_vibe
node_exports -->|"exports"| node_sim
node_exports -->|"exports"| node_canvas
node_exports -->|"exports"| node_form
node_exports -->|"exports"| node_flash
node_exports -->|"exports"| node_grid
node_exports -->|"exports"| node_virtual
node_exports -->|"exports"| node_calc
node_exports -->|"exports"| node_offline
node_exports -->|"exports"| node_appz
node_exports -->|"exports"| node_devtools

click node_server "https://github.com/hyperlibs/htmxui/blob/master/server.ts"
click node_demos "https://github.com/hyperlibs/htmxui/blob/master/demos.ts"
click node_exports "https://github.com/hyperlibs/htmxui/blob/master/src/index.ts"
click node_bolt "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-bolt.ts"
click node_a11y "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-a11y.ts"
click node_vibe "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-vibe.ts"
click node_sim "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-sim.ts"
click node_canvas "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-canvas.ts"
click node_form "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-form.ts"
click node_flash "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-flash.ts"
click node_grid "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-grid.ts"
click node_virtual "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-virtual.ts"
click node_calc "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-calc.ts"
click node_offline "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-offline.ts"
click node_appz "https://github.com/hyperlibs/htmxui/blob/master/src/appz.ts"
click node_devtools "https://github.com/hyperlibs/htmxui/blob/master/src/htmx-devtools.ts"
click node_extension "https://github.com/hyperlibs/htmxui/blob/master/extension/devtools/panel.js"
click node_extension_setup "https://github.com/hyperlibs/htmxui/blob/master/extension/devtools/devtools.js"
click node_extension_background "https://github.com/hyperlibs/htmxui/blob/master/extension/background.js"
click node_extension_content "https://github.com/hyperlibs/htmxui/blob/master/extension/content_script.js"
click node_go_components "https://github.com/hyperlibs/htmxui/blob/master/go/components/components.go"
click node_go_appz "https://github.com/hyperlibs/htmxui/blob/master/go/components/appz.go"
click node_go_api "https://github.com/hyperlibs/htmxui/blob/master/go/htmxui/htmxui.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_demos toneBlue
class node_exports,node_bolt,node_appz,node_go_components,node_go_appz,node_go_api toneAmber
class node_form,node_flash,node_grid,node_virtual,node_calc,node_offline toneMint
class node_a11y,node_vibe,node_sim,node_canvas toneRose
class node_devtools,node_extension,node_extension_setup,node_extension_background,node_extension_content,node_engineer toneIndigo
```

## Components

### Demo server

- [Demo server](https://github.com/hyperlibs/htmxui/blob/master/server.ts): `server.ts`
- [Demo catalog](https://github.com/hyperlibs/htmxui/blob/master/demos.ts): `demos.ts`

### Framework core

- [Engine exports](https://github.com/hyperlibs/htmxui/blob/master/src/index.ts): `src/index.ts`
- [Signals and state](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-bolt.ts): `src/htmx-bolt.ts`
- [App navigation and hardware](https://github.com/hyperlibs/htmxui/blob/master/src/appz.ts): `src/appz.ts`
- [Go component catalog](https://github.com/hyperlibs/htmxui/blob/master/go/components/components.go): `go/components/components.go`
- [Go Appz components](https://github.com/hyperlibs/htmxui/blob/master/go/components/appz.go): `go/components/appz.go`
- [Go framework API](https://github.com/hyperlibs/htmxui/blob/master/go/htmxui/htmxui.go): `go/htmxui/htmxui.go`

### Data and forms

- [Forms and transactions](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-form.ts): `src/htmx-form.ts`
- [Search and column store](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-flash.ts): `src/htmx-flash.ts`
- [Enterprise data grid](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-grid.ts): `src/htmx-grid.ts`
- [Virtual scrolling](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-virtual.ts): `src/htmx-virtual.ts`
- [Formula engine](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-calc.ts): `src/htmx-calc.ts`
- [Offline mutation queue](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-offline.ts): `src/htmx-offline.ts`

### UI interactions

- [Accessibility navigation](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-a11y.ts): `src/htmx-a11y.ts`
- [Motion and animation](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-vibe.ts): `src/htmx-vibe.ts`
- [Physics simulation](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-sim.ts): `src/htmx-sim.ts`
- [Canvas engine](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-canvas.ts): `src/htmx-canvas.ts`

### Diagnostics

- [Runtime diagnostics](https://github.com/hyperlibs/htmxui/blob/master/src/htmx-devtools.ts): `src/htmx-devtools.ts`
- [DevTools extension panel](https://github.com/hyperlibs/htmxui/blob/master/extension/devtools/panel.js): `extension/devtools/panel.js`
- [DevTools registration](https://github.com/hyperlibs/htmxui/blob/master/extension/devtools/devtools.js): `extension/devtools/devtools.js`
- [Extension background](https://github.com/hyperlibs/htmxui/blob/master/extension/background.js): `extension/background.js`
- [Page content script](https://github.com/hyperlibs/htmxui/blob/master/extension/content_script.js): `extension/content_script.js`

### Other components

- **Backend engineer**

## Connections

- Backend engineer → Demo server: explores demos (evidence: `README.md`)
- Demo server → Demo catalog: uses catalog (evidence: `server.ts`)
- Engine exports → Signals and state: exports (evidence: `src/index.ts`)
- Engine exports → Accessibility navigation: exports (evidence: `src/index.ts`)
- Engine exports → Motion and animation: exports (evidence: `src/index.ts`)
- Engine exports → Physics simulation: exports (evidence: `src/index.ts`)
- Engine exports → Canvas engine: exports (evidence: `src/index.ts`)
- Engine exports → Forms and transactions: exports (evidence: `src/index.ts`)
- Engine exports → Search and column store: exports (evidence: `src/index.ts`)
- Engine exports → Enterprise data grid: exports (evidence: `src/index.ts`)
- Engine exports → Virtual scrolling: exports (evidence: `src/index.ts`)
- Engine exports → Formula engine: exports (evidence: `src/index.ts`)
- Engine exports → Offline mutation queue: exports (evidence: `src/index.ts`)
- Engine exports → App navigation and hardware: exports (evidence: `src/index.ts`)
- Engine exports → Runtime diagnostics: exports (evidence: `src/index.ts`)
