How sdidsa/oppa works
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: src/lib.rs Desktop runner · mod.rs Reactive runtime · render.rs Retained rendering · src/lib.rs Control catalog
Components 26
UI Runtime
- Reactive runtime
crates/oppa/src/reactive/mod.rs - Reactive state
crates/oppa/src/reactive/state.rs - Input dispatch
crates/oppa/src/input.rs - Worker tasks
crates/oppa/src/worker.rs - Hot reload
crates/oppa-reload/src/registry.rs
Presentation
- Retained rendering
crates/oppa/src/render.rs - Vello GPU backend
crates/oppa-vello/src/backend.rs - CPU backend
crates/oppa-cpu/src/backend.rs - DOM presenter
crates/oppa-dom/src/dom.rs
Platform Hosts
- Desktop runner
crates/oppa-app/src/lib.rs - Linux runner
crates/oppa-app/src/linux.rs - Windows runner
crates/oppa-app/src/windows.rs - Web host
crates/oppa-web/src/lib.rs - Android host
crates/oppa-android-app/src/lib.rs - Android shell
crates/oppa-shell-android/src/shell.rs - Linux shell
crates/oppa-shell-linux/src/lib.rs - Windows shell
crates/oppa-shell-win/src/win.rs
UI Capabilities
- Control catalog
crates/oppa-controls/src/lib.rs - Studio controls
crates/oppa-controls/src/studio.rs - Kitchen sink
crates/oppa-controls/src/kitchen_sink.rs - Menus
crates/oppa-controls/src/menu.rs - Accessibility
crates/oppa-atspi/src/tree.rs - Windows UIA
crates/oppa-uia/src/provider.rs
Text And Services
- Text shaping
crates/oppa-text-rustybuzz/src/lib.rs - Font service
crates/oppa-fonts/src/lib.rs
Other components
- App developer
Connections 24
- App developer → Desktop runner: mounts UI
crates/oppa-app/src/lib.rs - Desktop runner → Reactive runtime: runs scene
crates/oppa-app/src/lib.rs - Linux runner → Desktop runner: platform entry
crates/oppa-app/src/lib.rs - Windows runner → Desktop runner: platform entry
crates/oppa-app/src/lib.rs - Reactive runtime → Reactive state: tracks state
crates/oppa/src/reactive/mod.rs - Reactive runtime → Input dispatch: dispatches input
crates/oppa/src/reactive/mod.rs - Reactive runtime → Worker tasks: schedules tasks
crates/oppa/src/worker.rs - Reactive runtime → Retained rendering: updates tree
- Desktop runner → Vello GPU backend: renders GPU
crates/oppa-app/src/lib.rs - Desktop runner → CPU backend: fallback renders
crates/oppa-app/src/lib.rs - Web host → DOM presenter: presents DOM
- Retained rendering → DOM presenter: diffs to DOM
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
crates/oppa-controls/src/lib.rs - Control catalog → Studio controls: provides studio
crates/oppa-controls/src/lib.rs - Control catalog → Kitchen sink: provides showcase
crates/oppa-controls/src/lib.rs - Control catalog → Menus: provides menus
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