How iced-rs/iced works
Iced is a cross-platform Rust GUI library centered on an Elm-style application loop: application state produces a widget view, user/system events become messages, and update logic changes state or schedules async work. The runtime and windowing shell coordinate interfaces and events; renderer abstractions feed either GPU or software drawing. The README documents this user-facing flow and major capabilities. Some internal subsystem links are omitted where only directory structure, rather than call evidence, was available.
Main entry points: src/lib.rs Built-in Widgets · application.rs Application API · engine.rs GPU Engine · src/lib.rs GUI Runtime
Components 26
Application API
- Application API
src/application.rs - Hot Reload
src/hot.rs
Runtime and UI
- Built-in Widgets
widget/src/lib.rs - Pane Grid
widget/src/pane_grid.rs - Pick List
widget/src/pick_list.rs - Scrollable
widget/src/scrollable.rs - Shader Widget
widget/src/shader.rs - Core Types
core/src/lib.rs - GUI Runtime
runtime/src/lib.rs - Async Tasks
futures/src/lib.rs
Rendering
- Renderer Abstraction
renderer/src/lib.rs - Graphics Abstractions
graphics/src/lib.rs - GPU Engine
wgpu/src/engine.rs - GPU Primitives
wgpu/src/primitive.rs - GPU Quads
wgpu/src/quad.rs - GPU Text
wgpu/src/text.rs - GPU Triangles
wgpu/src/triangle.rs - GPU Pixel Alignment
wgpu/src/nudge.rs - Software Engine
tiny_skia/src/engine.rs - Software Raster
tiny_skia/src/raster.rs - Software Text
tiny_skia/src/text.rs - Software Vector
tiny_skia/src/vector.rs
Windowing and tools
- Window Shell
winit/src/lib.rs - Event Conversion
winit/src/conversion.rs - Debug Tooling
devtools/src/lib.rs
Other components
- User
Connections 25
- User → Application API: defines state and logic
- Application API → Built-in Widgets: builds view
- Built-in Widgets → Application API: produces messages
- Application API → GUI Runtime: runs application
- GUI Runtime → Core Types: uses foundations
runtime/src/lib.rs - GUI Runtime → Async Tasks: supports async work
- GUI Runtime → Window Shell: runs in shell
- Window Shell → Event Conversion: uses conversions
winit/src/lib.rs - Built-in Widgets → Pane Grid: includes
widget/src/lib.rs - Built-in Widgets → Pick List: includes
widget/src/lib.rs - Built-in Widgets → Scrollable: includes
widget/src/lib.rs - Built-in Widgets → Shader Widget: includes
widget/src/lib.rs - Renderer Abstraction → Graphics Abstractions: uses abstractions
- GPU Engine → GPU Primitives: dispatches primitives
wgpu/src/engine.rs - GPU Engine → GPU Quads: dispatches quads
wgpu/src/engine.rs - GPU Engine → GPU Text: dispatches text
wgpu/src/engine.rs - GPU Engine → GPU Triangles: dispatches triangles
wgpu/src/engine.rs - GPU Text → GPU Pixel Alignment: uses alignment
wgpu/src/text.rs - Software Engine → Software Raster: uses raster
tiny_skia/src/engine.rs - Software Engine → Software Text: uses text
tiny_skia/src/engine.rs - Software Engine → Software Vector: uses vector
tiny_skia/src/engine.rs - Application API → Hot Reload: references reload
src/application.rs - Application API → Debug Tooling: optional instrumentation
- Renderer Abstraction → GPU Engine: offers GPU renderer
- Renderer Abstraction → Software Engine: offers software renderer