How zvnoob/cppreact works
cppreact is an immediate-mode C++ UI library. Users build a widget tree, with stateful functions rebuilding their elements as state changes; the renderer runs layout, dispatches draw commands and routes input, while SDL2 and SFML provide optional concrete backends. The graph preserves layout, widgets, text/font handling, scrolling, input, and rendering as distinct capabilities. Source excerpts clarify several calls and transfers; other links are limited to explicit README workflow descriptions.
Main entry points: container Widget Tree · renderer.hpp Renderer Loop · func.hpp Stateful Function · layout.cpp Layout Passes
Components 24
UI Composition
- Widget Tree
container - Stateful Function
container/func.hpp - Layout Containers
container
Runtime Core
- Persistent State
internal/state.hpp - Arena Allocation
internal/arena.hpp - Widget Identity
internal/identifiable.hpp - Layout Passes
src/layout.cpp - Element Model
internal/element.hpp - State Registry
internal/registry.hpp - Font Fallback
internal/font.hpp
Widgets
- Viewport Scroll
container/viewport.hpp - Scroll Input
widgets/scrolling.hpp - Text Shaping
widgets/text.hpp - Text Input
widgets/input.hpp - Buttons
widgets/button_full.hpp - Visual Widgets
widgets
Rendering
- Render Commands
internal/drawing.hpp - Renderer Loop
renderer/renderer.hpp
Platform Backends
- SDL Backend
renderer/sdl_renderer.hpp - SFML Backend
renderer/sfml_renderer.hpp
Other components
- UI Author
- GPU Window
- Font Files
- Pointer Keyboard
Connections 32
- UI Author → Widget Tree: constructs
- Widget Tree → Stateful Function: includes
- Stateful Function → Persistent State: reads updates
- Stateful Function → Arena Allocation: allocates within
- Stateful Function → State Registry: looks up state
- Widget Tree → Widget Identity: assigns IDs
- Widget Tree → Layout Passes: enters layout
- Layout Passes → Element Model: updates positions
- Layout Passes → Layout Containers: sizes children
- Widget Tree → Text Shaping: may include
- Widget Tree → Text Input: may include
- Widget Tree → Buttons: may include
- Widget Tree → Visual Widgets: may include
- Widget Tree → Viewport Scroll: may include
- Viewport Scroll → Scroll Input: combines with
- Renderer Loop → Widget Tree: runs frame
- Renderer Loop → Layout Passes: performs layout
- Renderer Loop → Render Commands: collects dispatches
- Text Shaping → Font Fallback: shapes with
- Renderer Loop → Font Fallback: loads fonts
- Font Fallback → Font Files: loads faces
- Text Shaping → Render Commands: emits drawing
- Visual Widgets → Render Commands: emits drawing
- Buttons → Renderer Loop: routes events
- Scroll Input → Renderer Loop: routes scroll
- Text Input → Renderer Loop: uses focus and IME
- Renderer Loop → SDL Backend: implemented by
- Renderer Loop → SFML Backend: implemented by
- SDL Backend → GPU Window: draws and presents
- SFML Backend → GPU Window: draws and presents
- Pointer Keyboard → SDL Backend: polled by
- Pointer Keyboard → SFML Backend: polled by