# we-are-mono/verso architecture

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

- Interactive diagram: https://gitdiagram.com/we-are-mono/verso
- Repository: https://github.com/we-are-mono/verso

## Overview

Verso is an experimental OpenWrt router web interface. The main workflow is an operator signing in through the Go HTTP shell, which reads router state and serves built-in pages or dispatches requests to installed plugins; configuration changes are brokered to the privileged companion. Major extensions include firewall, interface, and system plugins, with a shared Rust plugin SDK. The graph also shows history, telemetry, and widget rendering as supporting layers. Edges are limited to README statements and source-index references; some runtime transport details are not shown in the excerpts.

Main entry points: [`internal/server/server.go`](https://github.com/we-are-mono/verso/blob/main/internal/server/server.go) (HTTP server), [`internal/plugin/transport.go`](https://github.com/we-are-mono/verso/blob/main/internal/plugin/transport.go) (Plugin transport), [`internal/openwrt/backend.go`](https://github.com/we-are-mono/verso/blob/main/internal/openwrt/backend.go) (OpenWrt backend), [`plugins/verso-plugin-sdk/src/lib.rs`](https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-sdk/src/lib.rs) (Plugin SDK)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Web shell"]
  node_verso["Verso command<br/>[main.go]"]
  node_http["HTTP server<br/>[server.go]"]
  node_routes["HTTP routes<br/>[routes.go]"]
  node_auth["Authentication<br/>[auth.go]"]
end

subgraph group_router["Router services"]
  node_backend["OpenWrt backend<br/>[backend.go]"]
  node_rpcd["Privileged companion<br/>[main.rs]"]
  node_ubus["ubus client<br/>[client.go]"]
  node_routerstate[("Router configuration")]
end

subgraph group_extensions["Plugin system"]
  node_pluginregistry["Plugin registry<br/>[registry.go]"]
  node_transport["Plugin transport<br/>[transport.go]"]
  node_sdk["Plugin SDK<br/>[lib.rs]"]
  node_firewall["Firewall plugin<br/>[main.rs]"]
  node_interfaces["Interfaces plugin<br/>[main.rs]"]
  node_systemplugin["System plugin<br/>[main.rs]"]
end

subgraph group_support["State and presentation"]
  node_history[("Change history<br/>[history.go]")]
  node_telemetry["Telemetry sampler<br/>[sampler.go]"]
  node_widgets["Widget renderer<br/>[renderer.go]"]
end

node_operator(("Operator"))
node_browser(("Web browser"))

node_operator -->|"uses"| node_browser
node_browser -->|"requests pages"| node_http
node_verso -->|"serves"| node_http
node_http -->|"routes requests"| node_routes
node_http -->|"authenticates"| node_auth
node_http -->|"reads live state"| node_backend
node_backend -->|"uses"| node_ubus
node_backend -.->|"requests privileged work"| node_rpcd
node_rpcd -.->|"operates on"| node_routerstate
node_http -->|"loads manifests"| node_pluginregistry
node_http -->|"dispatches to plugins"| node_transport
node_transport -.->|"dispatches"| node_firewall
node_transport -.->|"dispatches"| node_interfaces
node_transport -.->|"dispatches"| node_systemplugin
node_firewall -->|"uses"| node_sdk
node_interfaces -->|"uses"| node_sdk
node_systemplugin -->|"uses"| node_sdk
node_http -.->|"renders pages"| node_widgets
node_http -->|"starts history"| node_history
node_http -.->|"samples metrics"| node_telemetry

click node_verso "https://github.com/we-are-mono/verso/blob/main/cmd/verso/main.go"
click node_http "https://github.com/we-are-mono/verso/blob/main/internal/server/server.go"
click node_routes "https://github.com/we-are-mono/verso/blob/main/internal/server/routes.go"
click node_auth "https://github.com/we-are-mono/verso/blob/main/internal/openwrt/auth.go"
click node_backend "https://github.com/we-are-mono/verso/blob/main/internal/openwrt/backend.go"
click node_rpcd "https://github.com/we-are-mono/verso/blob/main/verso-rpcd/src/main.rs"
click node_ubus "https://github.com/we-are-mono/verso/blob/main/internal/ubus/client.go"
click node_pluginregistry "https://github.com/we-are-mono/verso/blob/main/internal/plugin/registry.go"
click node_transport "https://github.com/we-are-mono/verso/blob/main/internal/plugin/transport.go"
click node_sdk "https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-sdk/src/lib.rs"
click node_firewall "https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-firewall/src/main.rs"
click node_interfaces "https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-interfaces/src/main.rs"
click node_systemplugin "https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-system/src/main.rs"
click node_history "https://github.com/we-are-mono/verso/blob/main/internal/history/history.go"
click node_telemetry "https://github.com/we-are-mono/verso/blob/main/internal/telemetry/sampler.go"
click node_widgets "https://github.com/we-are-mono/verso/blob/main/internal/widget/renderer.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_verso,node_http,node_routes,node_auth,node_browser toneBlue
class node_backend,node_rpcd,node_ubus,node_routerstate toneAmber
class node_pluginregistry,node_transport,node_sdk,node_firewall,node_interfaces,node_systemplugin toneMint
class node_history,node_telemetry,node_widgets toneRose
class node_operator toneIndigo
```

## Components

### Web shell

- [Verso command](https://github.com/we-are-mono/verso/blob/main/cmd/verso/main.go): `cmd/verso/main.go`
- [HTTP server](https://github.com/we-are-mono/verso/blob/main/internal/server/server.go): `internal/server/server.go`
- [HTTP routes](https://github.com/we-are-mono/verso/blob/main/internal/server/routes.go): `internal/server/routes.go`
- [Authentication](https://github.com/we-are-mono/verso/blob/main/internal/openwrt/auth.go): `internal/openwrt/auth.go`

### Router services

- [OpenWrt backend](https://github.com/we-are-mono/verso/blob/main/internal/openwrt/backend.go): `internal/openwrt/backend.go`
- [Privileged companion](https://github.com/we-are-mono/verso/blob/main/verso-rpcd/src/main.rs): `verso-rpcd/src/main.rs`
- [ubus client](https://github.com/we-are-mono/verso/blob/main/internal/ubus/client.go): `internal/ubus/client.go`
- **Router configuration**

### Plugin system

- [Plugin registry](https://github.com/we-are-mono/verso/blob/main/internal/plugin/registry.go): `internal/plugin/registry.go`
- [Plugin transport](https://github.com/we-are-mono/verso/blob/main/internal/plugin/transport.go): `internal/plugin/transport.go`
- [Plugin SDK](https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-sdk/src/lib.rs): `plugins/verso-plugin-sdk/src/lib.rs`
- [Firewall plugin](https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-firewall/src/main.rs): `plugins/verso-plugin-firewall/src/main.rs`
- [Interfaces plugin](https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-interfaces/src/main.rs): `plugins/verso-plugin-interfaces/src/main.rs`
- [System plugin](https://github.com/we-are-mono/verso/blob/main/plugins/verso-plugin-system/src/main.rs): `plugins/verso-plugin-system/src/main.rs`

### State and presentation

- [Change history](https://github.com/we-are-mono/verso/blob/main/internal/history/history.go): `internal/history/history.go`
- [Telemetry sampler](https://github.com/we-are-mono/verso/blob/main/internal/telemetry/sampler.go): `internal/telemetry/sampler.go`
- [Widget renderer](https://github.com/we-are-mono/verso/blob/main/internal/widget/renderer.go): `internal/widget/renderer.go`

### Other components

- **Operator**
- **Web browser**

## Connections

- Operator → Web browser: uses (evidence: `README.md`)
- Web browser → HTTP server: requests pages (evidence: `README.md`)
- Verso command → HTTP server: serves (evidence: `cmd/verso/main.go`)
- HTTP server → HTTP routes: routes requests (evidence: `internal/server/server.go`)
- HTTP server → Authentication: authenticates (evidence: `internal/server/server.go`)
- HTTP server → OpenWrt backend: reads live state (evidence: `internal/server/server.go`)
- OpenWrt backend → ubus client: uses
- OpenWrt backend → Privileged companion: requests privileged work
- Privileged companion → Router configuration: operates on
- HTTP server → Plugin registry: loads manifests (evidence: `internal/server/server.go`)
- HTTP server → Plugin transport: dispatches to plugins (evidence: `internal/server/server.go`)
- Plugin transport → Firewall plugin: dispatches
- Plugin transport → Interfaces plugin: dispatches
- Plugin transport → System plugin: dispatches
- Firewall plugin → Plugin SDK: uses (evidence: `plugins/verso-plugin-firewall/src/main.rs`)
- Interfaces plugin → Plugin SDK: uses (evidence: `plugins/verso-plugin-interfaces/src/main.rs`)
- System plugin → Plugin SDK: uses (evidence: `plugins/verso-plugin-system/src/main.rs`)
- HTTP server → Widget renderer: renders pages
- HTTP server → Change history: starts history
- HTTP server → Telemetry sampler: samples metrics
