How we-are-mono/verso works
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: server.go HTTP server · transport.go Plugin transport · backend.go OpenWrt backend · lib.rs Plugin SDK
Components 19
Web shell
- Verso command
cmd/verso/main.go - HTTP server
internal/server/server.go - HTTP routes
internal/server/routes.go - Authentication
internal/openwrt/auth.go
Router services
- OpenWrt backend
internal/openwrt/backend.go - Privileged companion
verso-rpcd/src/main.rs - ubus client
internal/ubus/client.go - Router configuration
Plugin system
- Plugin registry
internal/plugin/registry.go - Plugin transport
internal/plugin/transport.go - Plugin SDK
plugins/verso-plugin-sdk/src/lib.rs - Firewall plugin
plugins/verso-plugin-firewall/src/main.rs - Interfaces plugin
plugins/verso-plugin-interfaces/src/main.rs - System plugin
plugins/verso-plugin-system/src/main.rs
State and presentation
- Change history
internal/history/history.go - Telemetry sampler
internal/telemetry/sampler.go - Widget renderer
internal/widget/renderer.go
Other components
- Operator
- Web browser
Connections 20
- Operator → Web browser: uses
README.md - Web browser → HTTP server: requests pages
README.md - Verso command → HTTP server: serves
cmd/verso/main.go - HTTP server → HTTP routes: routes requests
internal/server/server.go - HTTP server → Authentication: authenticates
internal/server/server.go - HTTP server → OpenWrt backend: reads live state
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
internal/server/server.go - HTTP server → Plugin transport: dispatches to plugins
internal/server/server.go - Plugin transport → Firewall plugin: dispatches
- Plugin transport → Interfaces plugin: dispatches
- Plugin transport → System plugin: dispatches
- Firewall plugin → Plugin SDK: uses
plugins/verso-plugin-firewall/src/main.rs - Interfaces plugin → Plugin SDK: uses
plugins/verso-plugin-interfaces/src/main.rs - System plugin → Plugin SDK: uses
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