# sandikodev/hono-aurelia architecture

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

- Interactive diagram: https://gitdiagram.com/sandikodev/hono-aurelia
- Repository: https://github.com/sandikodev/hono-aurelia

## Overview

@hono/aurelia is a thin Hono adapter for Aurelia 2 server rendering and server actions. Its main workflow runs a route loader, renders a component through Aurelia SSR, and returns HTML—optionally streamed or negotiated as JSON. Separate capabilities provide request-scoped defaults and mutation-action dispatch. The excerpts show the adapter’s calls to Aurelia SSR and its request-scoped state; README statements support the documented Hono integration. Other source behavior is not inferred beyond those sources.

Main entry points: [`src/adapter.ts`](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts) (Route handler), [`src/index.ts`](https://github.com/sandikodev/hono-aurelia/blob/main/src/index.ts) (Public exports), [`src/server.ts`](https://github.com/sandikodev/hono-aurelia/blob/main/src/server.ts) (Server entry), [`src/types.ts`](https://github.com/sandikodev/hono-aurelia/blob/main/src/types.ts) (Adapter types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Route handling"]
  node_route["Route handler<br/>[adapter.ts]"]
  node_loader["Loader execution<br/>[adapter.ts]"]
  node_defaults["Scoped defaults<br/>[adapter.ts]"]
  node_request_state[("Request defaults map<br/>[adapter.ts]")]
end

subgraph group_rendering["SSR rendering"]
  node_renderer["Aurelia renderer<br/>[adapter.ts]"]
  node_document["Document response<br/>[adapter.ts]"]
end

subgraph group_actions["Server actions"]
  node_action_dispatch["Action dispatch<br/>[adapter.ts]"]
  node_action_map["Action handlers<br/>[adapter.ts]"]
end

subgraph group_api["Public API"]
  node_contracts["Adapter types<br/>[types.ts]"]
  node_exports["Public exports<br/>[index.ts]"]
  node_server_entry["Server entry<br/>[server.ts]"]
end

node_hono(("Hono request"))
node_ssr["Aurelia SSR"]

node_hono -->|"invokes"| node_route
node_hono -->|"configures"| node_defaults
node_defaults -->|"stores defaults"| node_request_state
node_route -->|"reads defaults"| node_request_state
node_route -->|"runs loader"| node_loader
node_route -->|"builds render options"| node_renderer
node_renderer -->|"renders component"| node_ssr
node_route -->|"assembles response"| node_document
node_document -->|"creates document"| node_ssr
node_hono -->|"invokes mutation"| node_action_dispatch
node_action_dispatch -->|"dispatches action"| node_action_map
node_exports -->|"exports"| node_route
node_exports -->|"exports types"| node_contracts
node_server_entry -->|"re-exports"| node_exports

click node_route "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_loader "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_defaults "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_request_state "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_renderer "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_document "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_action_dispatch "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_action_map "https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts"
click node_contracts "https://github.com/sandikodev/hono-aurelia/blob/main/src/types.ts"
click node_exports "https://github.com/sandikodev/hono-aurelia/blob/main/src/index.ts"
click node_server_entry "https://github.com/sandikodev/hono-aurelia/blob/main/src/server.ts"

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_route,node_loader,node_defaults,node_request_state toneBlue
class node_renderer,node_document toneAmber
class node_action_dispatch,node_action_map,node_hono toneMint
class node_contracts,node_exports,node_server_entry toneRose
class node_ssr toneIndigo
```

## Components

### Route handling

- [Route handler](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`
- [Loader execution](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`
- [Scoped defaults](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`
- [Request defaults map](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`

### SSR rendering

- [Aurelia renderer](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`
- [Document response](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`

### Server actions

- [Action dispatch](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`
- [Action handlers](https://github.com/sandikodev/hono-aurelia/blob/main/src/adapter.ts): `src/adapter.ts`

### Public API

- [Adapter types](https://github.com/sandikodev/hono-aurelia/blob/main/src/types.ts): `src/types.ts`
- [Public exports](https://github.com/sandikodev/hono-aurelia/blob/main/src/index.ts): `src/index.ts`
- [Server entry](https://github.com/sandikodev/hono-aurelia/blob/main/src/server.ts): `src/server.ts`

### Other components

- **Hono request**
- **Aurelia SSR**

## Connections

- Hono request → Route handler: invokes (evidence: `README.md`)
- Hono request → Scoped defaults: configures (evidence: `README.md`)
- Scoped defaults → Request defaults map: stores defaults (evidence: `src/adapter.ts`)
- Route handler → Request defaults map: reads defaults (evidence: `src/adapter.ts`)
- Route handler → Loader execution: runs loader (evidence: `src/adapter.ts`)
- Route handler → Aurelia renderer: builds render options (evidence: `src/adapter.ts`)
- Aurelia renderer → Aurelia SSR: renders component (evidence: `src/adapter.ts`)
- Route handler → Document response: assembles response (evidence: `src/adapter.ts`)
- Document response → Aurelia SSR: creates document (evidence: `src/adapter.ts`)
- Hono request → Action dispatch: invokes mutation (evidence: `README.md`)
- Action dispatch → Action handlers: dispatches action (evidence: `src/adapter.ts`)
- Public exports → Route handler: exports (evidence: `src/index.ts`)
- Public exports → Adapter types: exports types (evidence: `src/index.ts`)
- Server entry → Public exports: re-exports (evidence: `src/server.ts`)
