How nicbarker/clay works
Clay is a dependency-free C UI layout library: an application supplies dimensions, pointer and scroll state, declares a nested UI, then consumes sorted render commands through a renderer. The core also supports text measurement callbacks, scrolling, transitions, retained-mode rendering, visibility culling, and custom elements. Renderer adapters translate commands for graphics, terminal, and document/browser targets; language bindings expose the library to other ecosystems. Core workflow is documented in the README; sampled renderer excerpts show adapter responsibilities, but do not establish wiring among individual adapters.
Main entry points: clay.h Layout Engine · clay_renderer_SDL2.c SDL Renderers · clay_renderer_gles3.h GLES3 Renderer · clay_renderer_cairo.c Cairo Renderer
Components 20
Layout Core
- Declarative API
clay.h - Arena State
clay.h - Text Measurement
clay.h - Layout Engine
clay.h - Render Commands
clay.h
Interaction Features
- Pointer And Hover
clay.h - Scroll Containers
clay.h - Layout Transitions
clay.h - Retained Rendering
clay.h - Visibility Culling
clay.h
Renderer Adapters
- SDL Renderers
renderers/SDL2/clay_renderer_SDL2.c - GLES3 Renderer
renderers/GLES3/clay_renderer_gles3.h - Cairo Renderer
renderers/cairo/clay_renderer_cairo.c - Terminal Renderers
renderers/terminal/clay_renderer_terminal_ansi.c - Other Renderers
renderers
Language And Web
- Language Bindings
bindings - Web And HTML Targets
renderers/web
Other components
- UI Application
- Window And Input
- Display Or Document
Connections 28
- Window And Input → UI Application: provides input
- UI Application → Declarative API: declares UI
- UI Application → Arena State: initializes arena
- UI Application → Pointer And Hover: sets pointer
- UI Application → Scroll Containers: updates scroll
- UI Application → Layout Engine: sets dimensions
- Declarative API → Layout Engine: builds hierarchy
- Layout Engine → Text Measurement: measures text
- Layout Engine → Arena State: uses arena
- Layout Engine → Render Commands: produces commands
- Pointer And Hover → Arena State: updates interaction
- Scroll Containers → Arena State: updates offsets
- Layout Transitions → Layout Engine: animates layout
- Retained Rendering → Render Commands: supports rendering
- Visibility Culling → Render Commands: filters visibility
- UI Application → SDL Renderers: renders commands
- UI Application → GLES3 Renderer: renders commands
- UI Application → Cairo Renderer: renders commands
- UI Application → Terminal Renderers: renders commands
- UI Application → Other Renderers: selects adapter
- SDL Renderers → Display Or Document: draws UI
- GLES3 Renderer → Display Or Document: draws UI
- Cairo Renderer → Display Or Document: draws UI
- Terminal Renderers → Display Or Document: draws UI
- Other Renderers → Display Or Document: renders output
- UI Application → Language Bindings: uses language API
- UI Application → Web And HTML Targets: targets browser
- Web And HTML Targets → Display Or Document: renders HTML or canvas