# cunha-renato/connui architecture

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

- Interactive diagram: https://gitdiagram.com/cunha-renato/connui
- Repository: https://github.com/cunha-renato/connui

## Overview

Connui is a Rust immediate-mode UI toolkit: applications compose widgets, submit them to a Context, and receive interaction responses while the toolkit lays out, clips, and renders the tree. Its core crate supplies UI state, events, layout, fonts, and renderer abstractions; companion crates provide a wgpu backend and reusable widgets. The README is empty, so capability coverage is based on the source index and excerpts; some backend and widget interactions are not shown, and are left unconnected where evidence is insufficient.

Main entry points: [`connui_widgets/src/lib.rs`](https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/lib.rs) (Widget Traits), [`connui/src/context.rs`](https://github.com/cunha-renato/connui/blob/main/connui/src/context.rs) (UI Context), [`connui/src/types.rs`](https://github.com/cunha-renato/connui/blob/main/connui/src/types.rs) (Widget Tree), [`connui/src/font/renderer.rs`](https://github.com/cunha-renato/connui/blob/main/connui/src/font/renderer.rs) (Glyph Renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["UI Core"]
  node_context["UI Context<br/>[context.rs]"]
  node_input["Input Events<br/>[event.rs]"]
  node_tree["Widget Tree<br/>[types.rs]"]
  node_layout["Layout Engine<br/>[layout.rs]"]
  node_state["Widget State<br/>[state.rs]"]
  node_renderer_api["Renderer API<br/>[renderer.rs]"]
end

subgraph group_text["Text and Images"]
  node_font_layout["Font Layout<br/>[cosmic_types.rs]"]
  node_font_render["Glyph Renderer<br/>[renderer.rs]"]
  node_glyph_atlas["Glyph Atlas<br/>[atlas.rs]"]
  node_image_handles["Image Handles<br/>[image.rs]"]
end

subgraph group_widgets["Widget Library"]
  node_widget_traits["Widget Traits<br/>[lib.rs]"]
  node_div["Div Widget<br/>[div.rs]"]
  node_button["Button Widget<br/>[button.rs]"]
  node_scrollable["Scrollable Widget<br/>[scrollable.rs]"]
  node_text_widget["Text Widget<br/>[text.rs]"]
  node_image_widget["Image Widget<br/>[image.rs]"]
end

subgraph group_backend["GPU Backend"]
  node_wgpu_renderer["Wgpu Renderer<br/>[lib.rs]"]
  node_wgpu_images["Wgpu Images<br/>[image.rs]"]
end

node_app(("Application"))

node_app -->|"submits UI"| node_context
node_app -->|"sends events"| node_context
node_context -->|"builds and updates"| node_tree
node_context -->|"dispatches input"| node_input
node_context -->|"renders through"| node_renderer_api
node_tree -->|"uses layout"| node_layout
node_tree -->|"updates state"| node_state
node_tree -->|"generates events"| node_input
node_widget_traits -->|"exports"| node_div
node_widget_traits -->|"exports"| node_image_widget
node_widget_traits -->|"exports"| node_text_widget
node_widget_traits -->|"declares"| node_button
node_widget_traits -->|"declares"| node_scrollable
node_font_layout -->|"renders layout"| node_font_render
node_font_render -->|"caches glyphs"| node_glyph_atlas
node_font_render -->|"uploads atlas images"| node_image_handles
node_font_render -->|"draws glyphs"| node_renderer_api
node_image_widget -.->|"uses handles"| node_image_handles
node_wgpu_renderer -->|"uses image support"| node_wgpu_images
node_wgpu_renderer -.->|"implements renderer"| node_renderer_api

click node_context "https://github.com/cunha-renato/connui/blob/main/connui/src/context.rs"
click node_input "https://github.com/cunha-renato/connui/blob/main/connui/src/event.rs"
click node_tree "https://github.com/cunha-renato/connui/blob/main/connui/src/types.rs"
click node_layout "https://github.com/cunha-renato/connui/blob/main/connui/src/layout.rs"
click node_state "https://github.com/cunha-renato/connui/blob/main/connui/src/state.rs"
click node_renderer_api "https://github.com/cunha-renato/connui/blob/main/connui/src/renderer.rs"
click node_widget_traits "https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/lib.rs"
click node_div "https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/div.rs"
click node_button "https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/button.rs"
click node_scrollable "https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/scrollable.rs"
click node_text_widget "https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/text.rs"
click node_image_widget "https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/image.rs"
click node_font_layout "https://github.com/cunha-renato/connui/blob/main/connui/src/font/cosmic_types.rs"
click node_font_render "https://github.com/cunha-renato/connui/blob/main/connui/src/font/renderer.rs"
click node_glyph_atlas "https://github.com/cunha-renato/connui/blob/main/connui/src/font/atlas.rs"
click node_image_handles "https://github.com/cunha-renato/connui/blob/main/connui/src/image.rs"
click node_wgpu_renderer "https://github.com/cunha-renato/connui/blob/main/connui_wgpu/src/lib.rs"
click node_wgpu_images "https://github.com/cunha-renato/connui/blob/main/connui_wgpu/src/image.rs"

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_context,node_input,node_tree,node_layout,node_state,node_renderer_api toneBlue
class node_font_layout,node_font_render,node_glyph_atlas,node_image_handles toneAmber
class node_widget_traits,node_div,node_button,node_scrollable,node_text_widget,node_image_widget toneMint
class node_wgpu_renderer,node_wgpu_images toneRose
class node_app toneIndigo
```

## Components

### UI Core

- [UI Context](https://github.com/cunha-renato/connui/blob/main/connui/src/context.rs): `connui/src/context.rs`
- [Input Events](https://github.com/cunha-renato/connui/blob/main/connui/src/event.rs): `connui/src/event.rs`
- [Widget Tree](https://github.com/cunha-renato/connui/blob/main/connui/src/types.rs): `connui/src/types.rs`
- [Layout Engine](https://github.com/cunha-renato/connui/blob/main/connui/src/layout.rs): `connui/src/layout.rs`
- [Widget State](https://github.com/cunha-renato/connui/blob/main/connui/src/state.rs): `connui/src/state.rs`
- [Renderer API](https://github.com/cunha-renato/connui/blob/main/connui/src/renderer.rs): `connui/src/renderer.rs`

### Text and Images

- [Font Layout](https://github.com/cunha-renato/connui/blob/main/connui/src/font/cosmic_types.rs): `connui/src/font/cosmic_types.rs`
- [Glyph Renderer](https://github.com/cunha-renato/connui/blob/main/connui/src/font/renderer.rs): `connui/src/font/renderer.rs`
- [Glyph Atlas](https://github.com/cunha-renato/connui/blob/main/connui/src/font/atlas.rs): `connui/src/font/atlas.rs`
- [Image Handles](https://github.com/cunha-renato/connui/blob/main/connui/src/image.rs): `connui/src/image.rs`

### Widget Library

- [Widget Traits](https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/lib.rs): `connui_widgets/src/lib.rs`
- [Div Widget](https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/div.rs): `connui_widgets/src/div.rs`
- [Button Widget](https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/button.rs): `connui_widgets/src/button.rs`
- [Scrollable Widget](https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/scrollable.rs): `connui_widgets/src/scrollable.rs`
- [Text Widget](https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/text.rs): `connui_widgets/src/text.rs`
- [Image Widget](https://github.com/cunha-renato/connui/blob/main/connui_widgets/src/image.rs): `connui_widgets/src/image.rs`

### GPU Backend

- [Wgpu Renderer](https://github.com/cunha-renato/connui/blob/main/connui_wgpu/src/lib.rs): `connui_wgpu/src/lib.rs`
- [Wgpu Images](https://github.com/cunha-renato/connui/blob/main/connui_wgpu/src/image.rs): `connui_wgpu/src/image.rs`

### Other components

- **Application**

## Connections

- Application → UI Context: submits UI (evidence: `connui/src/context.rs`)
- Application → UI Context: sends events (evidence: `connui/src/context.rs`)
- UI Context → Widget Tree: builds and updates (evidence: `connui/src/context.rs`)
- UI Context → Input Events: dispatches input (evidence: `connui/src/context.rs`)
- UI Context → Renderer API: renders through (evidence: `connui/src/context.rs`)
- Widget Tree → Layout Engine: uses layout (evidence: `connui/src/types.rs`)
- Widget Tree → Widget State: updates state (evidence: `connui/src/types.rs`)
- Widget Tree → Input Events: generates events (evidence: `connui/src/event.rs`)
- Widget Traits → Div Widget: exports (evidence: `connui_widgets/src/lib.rs`)
- Widget Traits → Image Widget: exports (evidence: `connui_widgets/src/lib.rs`)
- Widget Traits → Text Widget: exports (evidence: `connui_widgets/src/lib.rs`)
- Widget Traits → Button Widget: declares (evidence: `connui_widgets/src/lib.rs`)
- Widget Traits → Scrollable Widget: declares (evidence: `connui_widgets/src/lib.rs`)
- Font Layout → Glyph Renderer: renders layout (evidence: `connui/src/font/mod.rs`)
- Glyph Renderer → Glyph Atlas: caches glyphs (evidence: `connui/src/font/renderer.rs`)
- Glyph Renderer → Image Handles: uploads atlas images (evidence: `connui/src/font/renderer.rs`)
- Glyph Renderer → Renderer API: draws glyphs (evidence: `connui/src/font/renderer.rs`)
- Image Widget → Image Handles: uses handles
- Wgpu Renderer → Wgpu Images: uses image support (evidence: `connui_wgpu/src/lib.rs`)
- Wgpu Renderer → Renderer API: implements renderer
