# sdidsa/oppa architecture

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

- Interactive diagram: https://gitdiagram.com/sdidsa/oppa
- Repository: https://github.com/sdidsa/oppa

## Overview

Oppa is a retained, declarative Rust GUI framework for Windows, Linux, Android, and Web. Users mount component trees, which the reactive runtime updates and the platform presenters render; the principal workflow runs through the desktop app runner, with DOM and native backends as platform alternatives. The repository also provides controls, text services, accessibility, dialogs, storage, and hot reload. The graph preserves documented branches, but source excerpts are partial; unverified implementation links are omitted rather than inferred.

Main entry points: [`crates/oppa-app/src/lib.rs`](https://github.com/sdidsa/oppa/blob/main/crates/oppa-app/src/lib.rs) (Desktop runner), [`crates/oppa/src/reactive/mod.rs`](https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/reactive/mod.rs) (Reactive runtime), [`crates/oppa/src/render.rs`](https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/render.rs) (Retained rendering), [`crates/oppa-controls/src/lib.rs`](https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/lib.rs) (Control catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["UI Runtime"]
  node_runtime["Reactive runtime<br/>[mod.rs]"]
  node_state["Reactive state<br/>[state.rs]"]
  node_input["Input dispatch<br/>[input.rs]"]
  node_worker["Worker tasks<br/>[worker.rs]"]
  node_reload["Hot reload<br/>[registry.rs]"]
end

subgraph group_present["Presentation"]
  node_render["Retained rendering<br/>[render.rs]"]
  node_vello["Vello GPU backend<br/>[backend.rs]"]
  node_cpu["CPU backend<br/>[backend.rs]"]
  node_dom["DOM presenter<br/>[dom.rs]"]
end

subgraph group_platform["Platform Hosts"]
  node_desktop["Desktop runner<br/>[lib.rs]"]
  node_linux_app["Linux runner<br/>[linux.rs]"]
  node_windows_app["Windows runner<br/>[windows.rs]"]
  node_web["Web host<br/>[lib.rs]"]
  node_android["Android host<br/>[lib.rs]"]
  node_android_shell["Android shell<br/>[shell.rs]"]
  node_linux_shell["Linux shell<br/>[lib.rs]"]
  node_win_shell["Windows shell<br/>[win.rs]"]
end

subgraph group_features["UI Capabilities"]
  node_controls["Control catalog<br/>[lib.rs]"]
  node_studio["Studio controls<br/>[studio.rs]"]
  node_kitchen["Kitchen sink<br/>[kitchen_sink.rs]"]
  node_menu["Menus<br/>[menu.rs]"]
  node_accessibility["Accessibility<br/>[tree.rs]"]
  node_uia["Windows UIA<br/>[provider.rs]"]
end

subgraph group_services["Text And Services"]
  node_text["Text shaping<br/>[lib.rs]"]
  node_fonts["Font service<br/>[lib.rs]"]
end

node_developer(("App developer"))

node_developer -->|"mounts UI"| node_desktop
node_desktop -->|"runs scene"| node_runtime
node_linux_app -.->|"platform entry"| node_desktop
node_windows_app -.->|"platform entry"| node_desktop
node_runtime -->|"tracks state"| node_state
node_runtime -->|"dispatches input"| node_input
node_runtime -->|"schedules tasks"| node_worker
node_runtime -.->|"updates tree"| node_render
node_desktop -->|"renders GPU"| node_vello
node_desktop -->|"fallback renders"| node_cpu
node_web -.->|"presents DOM"| node_dom
node_render -->|"diffs to DOM"| node_dom
node_render -.->|"presents scene"| node_vello
node_render -.->|"presents scene"| node_cpu
node_developer -->|"uses controls"| node_controls
node_controls -->|"provides studio"| node_studio
node_controls -->|"provides showcase"| node_kitchen
node_controls -->|"provides menus"| node_menu
node_desktop -.->|"shapes text"| node_text
node_android -->|"uses shell"| node_android_shell
node_linux_app -.->|"uses host"| node_linux_shell
node_windows_app -.->|"uses host"| node_win_shell
node_accessibility -.->|"Windows provider"| node_uia
node_runtime -.->|"supports swapping"| node_reload

click node_desktop "https://github.com/sdidsa/oppa/blob/main/crates/oppa-app/src/lib.rs"
click node_linux_app "https://github.com/sdidsa/oppa/blob/main/crates/oppa-app/src/linux.rs"
click node_windows_app "https://github.com/sdidsa/oppa/blob/main/crates/oppa-app/src/windows.rs"
click node_runtime "https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/reactive/mod.rs"
click node_state "https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/reactive/state.rs"
click node_input "https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/input.rs"
click node_worker "https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/worker.rs"
click node_render "https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/render.rs"
click node_vello "https://github.com/sdidsa/oppa/blob/main/crates/oppa-vello/src/backend.rs"
click node_cpu "https://github.com/sdidsa/oppa/blob/main/crates/oppa-cpu/src/backend.rs"
click node_dom "https://github.com/sdidsa/oppa/blob/main/crates/oppa-dom/src/dom.rs"
click node_web "https://github.com/sdidsa/oppa/blob/main/crates/oppa-web/src/lib.rs"
click node_controls "https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/lib.rs"
click node_studio "https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/studio.rs"
click node_kitchen "https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/kitchen_sink.rs"
click node_menu "https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/menu.rs"
click node_text "https://github.com/sdidsa/oppa/blob/main/crates/oppa-text-rustybuzz/src/lib.rs"
click node_fonts "https://github.com/sdidsa/oppa/blob/main/crates/oppa-fonts/src/lib.rs"
click node_accessibility "https://github.com/sdidsa/oppa/blob/main/crates/oppa-atspi/src/tree.rs"
click node_uia "https://github.com/sdidsa/oppa/blob/main/crates/oppa-uia/src/provider.rs"
click node_reload "https://github.com/sdidsa/oppa/blob/main/crates/oppa-reload/src/registry.rs"
click node_android "https://github.com/sdidsa/oppa/blob/main/crates/oppa-android-app/src/lib.rs"
click node_android_shell "https://github.com/sdidsa/oppa/blob/main/crates/oppa-shell-android/src/shell.rs"
click node_linux_shell "https://github.com/sdidsa/oppa/blob/main/crates/oppa-shell-linux/src/lib.rs"
click node_win_shell "https://github.com/sdidsa/oppa/blob/main/crates/oppa-shell-win/src/win.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_runtime,node_state,node_input,node_worker,node_reload toneBlue
class node_render,node_vello,node_cpu,node_dom toneAmber
class node_desktop,node_linux_app,node_windows_app,node_web,node_android,node_android_shell,node_linux_shell,node_win_shell toneMint
class node_controls,node_studio,node_kitchen,node_menu,node_accessibility,node_uia toneRose
class node_text,node_fonts,node_developer toneIndigo
```

## Components

### UI Runtime

- [Reactive runtime](https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/reactive/mod.rs): `crates/oppa/src/reactive/mod.rs`
- [Reactive state](https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/reactive/state.rs): `crates/oppa/src/reactive/state.rs`
- [Input dispatch](https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/input.rs): `crates/oppa/src/input.rs`
- [Worker tasks](https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/worker.rs): `crates/oppa/src/worker.rs`
- [Hot reload](https://github.com/sdidsa/oppa/blob/main/crates/oppa-reload/src/registry.rs): `crates/oppa-reload/src/registry.rs`

### Presentation

- [Retained rendering](https://github.com/sdidsa/oppa/blob/main/crates/oppa/src/render.rs): `crates/oppa/src/render.rs`
- [Vello GPU backend](https://github.com/sdidsa/oppa/blob/main/crates/oppa-vello/src/backend.rs): `crates/oppa-vello/src/backend.rs`
- [CPU backend](https://github.com/sdidsa/oppa/blob/main/crates/oppa-cpu/src/backend.rs): `crates/oppa-cpu/src/backend.rs`
- [DOM presenter](https://github.com/sdidsa/oppa/blob/main/crates/oppa-dom/src/dom.rs): `crates/oppa-dom/src/dom.rs`

### Platform Hosts

- [Desktop runner](https://github.com/sdidsa/oppa/blob/main/crates/oppa-app/src/lib.rs): `crates/oppa-app/src/lib.rs`
- [Linux runner](https://github.com/sdidsa/oppa/blob/main/crates/oppa-app/src/linux.rs): `crates/oppa-app/src/linux.rs`
- [Windows runner](https://github.com/sdidsa/oppa/blob/main/crates/oppa-app/src/windows.rs): `crates/oppa-app/src/windows.rs`
- [Web host](https://github.com/sdidsa/oppa/blob/main/crates/oppa-web/src/lib.rs): `crates/oppa-web/src/lib.rs`
- [Android host](https://github.com/sdidsa/oppa/blob/main/crates/oppa-android-app/src/lib.rs): `crates/oppa-android-app/src/lib.rs`
- [Android shell](https://github.com/sdidsa/oppa/blob/main/crates/oppa-shell-android/src/shell.rs): `crates/oppa-shell-android/src/shell.rs`
- [Linux shell](https://github.com/sdidsa/oppa/blob/main/crates/oppa-shell-linux/src/lib.rs): `crates/oppa-shell-linux/src/lib.rs`
- [Windows shell](https://github.com/sdidsa/oppa/blob/main/crates/oppa-shell-win/src/win.rs): `crates/oppa-shell-win/src/win.rs`

### UI Capabilities

- [Control catalog](https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/lib.rs): `crates/oppa-controls/src/lib.rs`
- [Studio controls](https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/studio.rs): `crates/oppa-controls/src/studio.rs`
- [Kitchen sink](https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/kitchen_sink.rs): `crates/oppa-controls/src/kitchen_sink.rs`
- [Menus](https://github.com/sdidsa/oppa/blob/main/crates/oppa-controls/src/menu.rs): `crates/oppa-controls/src/menu.rs`
- [Accessibility](https://github.com/sdidsa/oppa/blob/main/crates/oppa-atspi/src/tree.rs): `crates/oppa-atspi/src/tree.rs`
- [Windows UIA](https://github.com/sdidsa/oppa/blob/main/crates/oppa-uia/src/provider.rs): `crates/oppa-uia/src/provider.rs`

### Text And Services

- [Text shaping](https://github.com/sdidsa/oppa/blob/main/crates/oppa-text-rustybuzz/src/lib.rs): `crates/oppa-text-rustybuzz/src/lib.rs`
- [Font service](https://github.com/sdidsa/oppa/blob/main/crates/oppa-fonts/src/lib.rs): `crates/oppa-fonts/src/lib.rs`

### Other components

- **App developer**

## Connections

- App developer → Desktop runner: mounts UI (evidence: `crates/oppa-app/src/lib.rs`)
- Desktop runner → Reactive runtime: runs scene (evidence: `crates/oppa-app/src/lib.rs`)
- Linux runner → Desktop runner: platform entry (evidence: `crates/oppa-app/src/lib.rs`)
- Windows runner → Desktop runner: platform entry (evidence: `crates/oppa-app/src/lib.rs`)
- Reactive runtime → Reactive state: tracks state (evidence: `crates/oppa/src/reactive/mod.rs`)
- Reactive runtime → Input dispatch: dispatches input (evidence: `crates/oppa/src/reactive/mod.rs`)
- Reactive runtime → Worker tasks: schedules tasks (evidence: `crates/oppa/src/worker.rs`)
- Reactive runtime → Retained rendering: updates tree
- Desktop runner → Vello GPU backend: renders GPU (evidence: `crates/oppa-app/src/lib.rs`)
- Desktop runner → CPU backend: fallback renders (evidence: `crates/oppa-app/src/lib.rs`)
- Web host → DOM presenter: presents DOM
- Retained rendering → DOM presenter: diffs to DOM (evidence: `crates/oppa-dom/src/dom.rs`)
- Retained rendering → Vello GPU backend: presents scene
- Retained rendering → CPU backend: presents scene
- App developer → Control catalog: uses controls (evidence: `crates/oppa-controls/src/lib.rs`)
- Control catalog → Studio controls: provides studio (evidence: `crates/oppa-controls/src/lib.rs`)
- Control catalog → Kitchen sink: provides showcase (evidence: `crates/oppa-controls/src/lib.rs`)
- Control catalog → Menus: provides menus (evidence: `crates/oppa-controls/src/lib.rs`)
- Desktop runner → Text shaping: shapes text
- Android host → Android shell: uses shell
- Linux runner → Linux shell: uses host
- Windows runner → Windows shell: uses host
- Accessibility → Windows UIA: Windows provider
- Reactive runtime → Hot reload: supports swapping
