# z-ze489/zekit architecture

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

- Interactive diagram: https://gitdiagram.com/z-ze489/zekit
- Repository: https://github.com/z-ze489/zekit

## Overview

Zekit is a self-contained C++ GUI toolkit. The principal workflow is that an application creates a window and value-semantic widgets, shows the window, and runs its event loop; platform code translates native input while the shared widget layer lays out and paints through a per-window rendering backend. The graph also includes documented layout, theme, text, shape, and image-preview capabilities. Most implementation files were not sampled, so documented relationships use README evidence and uncertain implementation links are omitted.

Main entry points: [`Zekit/include/ZeWidget.h`](https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeWidget.h) (Widget tree), [`Zekit/include/Zekit.h`](https://github.com/z-ze489/zekit/blob/main/Zekit/include/Zekit.h) (Window and loop), [`Zekit/include/ZeRenderBackend.h`](https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeRenderBackend.h) (Backend interface), [`Zekit/ZeFrameCollector.h`](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeFrameCollector.h) (Frame collector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Application and windows"]
  node_window["Window and loop<br/>[Zekit.h]"]
end

subgraph group_kit["Widget and presentation"]
  node_widget["Widget tree<br/>[ZeWidget.h]"]
  node_layout["Layouts<br/>[ZeLayoutBase.cpp]"]
  node_theme["Theme and styles<br/>[ZeTheme.h]"]
  node_controls["UI controls<br/>[ZeButton.cpp]"]
  node_image_preview["Image preview<br/>[ZeImagePreview.cpp]"]
end

subgraph group_paint["Display and text"]
  node_shapes["Shapes<br/>[Shape.h]"]
  node_collector["Frame collector<br/>[ZeFrameCollector.h]"]
  node_font["Font rendering<br/>[ZeFontRenderer.cpp]"]
  node_draw["Drawing utilities<br/>[ZeDrawUtil.h]"]
  node_assets["Image resources<br/>[ZeImageStore.cpp]"]
end

subgraph group_platform["Platform and rendering"]
  node_platform_window["Native windows<br/>[ZeWindowWin32.cpp]"]
  node_input["Input and IME<br/>[ZeInputEvents.h]"]
  node_backend["Backend interface<br/>[ZeRenderBackend.h]"]
  node_gl["OpenGL backends<br/>[ZeGLContext.cpp]"]
  node_vulkan["Vulkan backend"]
  node_d3d["D3D12 backend<br/>[ZeD3D12Context.cpp]"]
  node_android["Android backend"]
  node_harmony["Harmony backend"]
end

node_app(("Application"))

node_app -->|"creates and configures"| node_window
node_app -->|"adds widgets"| node_widget
node_app -->|"shows and runs"| node_window
node_window -->|"uses native window"| node_platform_window
node_platform_window -->|"translates input"| node_input
node_input -->|"dispatches events"| node_widget
node_window -->|"hosts tree"| node_widget
node_widget -->|"supports layout"| node_layout
node_window -->|"provides defaults"| node_theme
node_widget -.->|"specializes as"| node_controls
node_widget -->|"hosts overlay"| node_image_preview
node_image_preview -->|"adds image and text"| node_collector
node_widget -.->|"collects display data"| node_collector
node_shapes -.->|"paints primitives"| node_draw
node_draw -->|"records drawing"| node_collector
node_collector -->|"measures text"| node_font
node_window -->|"selects renderer"| node_backend
node_backend -->|"implemented by"| node_gl
node_backend -->|"implemented by"| node_vulkan
node_backend -->|"implemented by"| node_d3d
node_backend -.->|"platform variant"| node_android
node_assets -.->|"supplies images"| node_collector

click node_window "https://github.com/z-ze489/zekit/blob/main/Zekit/include/Zekit.h"
click node_platform_window "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeWindowWin32.cpp"
click node_input "https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeInputEvents.h"
click node_widget "https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeWidget.h"
click node_layout "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeLayoutBase.cpp"
click node_theme "https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeTheme.h"
click node_controls "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeButton.cpp"
click node_image_preview "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeImagePreview.cpp"
click node_shapes "https://github.com/z-ze489/zekit/blob/main/Zekit/Shape.h"
click node_collector "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeFrameCollector.h"
click node_font "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeFontRenderer.cpp"
click node_draw "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeDrawUtil.h"
click node_backend "https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeRenderBackend.h"
click node_gl "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeGLContext.cpp"
click node_vulkan "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeVulkanContext.cpp"
click node_d3d "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeD3D12Context.cpp"
click node_android "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeRenderBackendAndroid.cpp"
click node_harmony "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeRenderBackendHarmony.cpp"
click node_assets "https://github.com/z-ze489/zekit/blob/main/Zekit/ZeImageStore.cpp"

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_window toneBlue
class node_widget,node_layout,node_theme,node_controls,node_image_preview toneAmber
class node_shapes,node_collector,node_font,node_draw,node_assets toneMint
class node_platform_window,node_input,node_backend,node_gl,node_vulkan,node_d3d,node_android,node_harmony toneRose
class node_app toneIndigo
```

## Components

### Application and windows

- [Window and loop](https://github.com/z-ze489/zekit/blob/main/Zekit/include/Zekit.h): `Zekit/include/Zekit.h`

### Widget and presentation

- [Widget tree](https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeWidget.h): `Zekit/include/ZeWidget.h`
- [Layouts](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeLayoutBase.cpp): `Zekit/ZeLayoutBase.cpp`
- [Theme and styles](https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeTheme.h): `Zekit/include/ZeTheme.h`
- [UI controls](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeButton.cpp): `Zekit/ZeButton.cpp`
- [Image preview](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeImagePreview.cpp): `Zekit/ZeImagePreview.cpp`

### Display and text

- [Shapes](https://github.com/z-ze489/zekit/blob/main/Zekit/Shape.h): `Zekit/Shape.h`
- [Frame collector](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeFrameCollector.h): `Zekit/ZeFrameCollector.h`
- [Font rendering](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeFontRenderer.cpp): `Zekit/ZeFontRenderer.cpp`
- [Drawing utilities](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeDrawUtil.h): `Zekit/ZeDrawUtil.h`
- [Image resources](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeImageStore.cpp): `Zekit/ZeImageStore.cpp`

### Platform and rendering

- [Native windows](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeWindowWin32.cpp): `Zekit/ZeWindowWin32.cpp`
- [Input and IME](https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeInputEvents.h): `Zekit/include/ZeInputEvents.h`
- [Backend interface](https://github.com/z-ze489/zekit/blob/main/Zekit/include/ZeRenderBackend.h): `Zekit/include/ZeRenderBackend.h`
- [OpenGL backends](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeGLContext.cpp): `Zekit/ZeGLContext.cpp`
- [Vulkan backend](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeVulkanContext.cpp): `Zekit/ZeVulkanContext.cpp`
- [D3D12 backend](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeD3D12Context.cpp): `Zekit/ZeD3D12Context.cpp`
- [Android backend](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeRenderBackendAndroid.cpp): `Zekit/ZeRenderBackendAndroid.cpp`
- [Harmony backend](https://github.com/z-ze489/zekit/blob/main/Zekit/ZeRenderBackendHarmony.cpp): `Zekit/ZeRenderBackendHarmony.cpp`

### Other components

- **Application**

## Connections

- Application → Window and loop: creates and configures (evidence: `README.md`)
- Application → Widget tree: adds widgets (evidence: `README.md`)
- Application → Window and loop: shows and runs (evidence: `README.md`)
- Window and loop → Native windows: uses native window (evidence: `README.md`)
- Native windows → Input and IME: translates input (evidence: `README.md`)
- Input and IME → Widget tree: dispatches events (evidence: `README.md`)
- Window and loop → Widget tree: hosts tree (evidence: `README.md`)
- Widget tree → Layouts: supports layout (evidence: `README.md`)
- Window and loop → Theme and styles: provides defaults (evidence: `Zekit/include/ZeTheme.h`)
- Widget tree → UI controls: specializes as
- Widget tree → Image preview: hosts overlay
- Image preview → Frame collector: adds image and text (evidence: `Zekit/ZeImagePreview.cpp`)
- Widget tree → Frame collector: collects display data
- Shapes → Drawing utilities: paints primitives
- Drawing utilities → Frame collector: records drawing (evidence: `Zekit/ZeDrawUtil.h`)
- Frame collector → Font rendering: measures text (evidence: `Zekit/ZeFrameCollector.h`)
- Window and loop → Backend interface: selects renderer (evidence: `README.md`)
- Backend interface → OpenGL backends: implemented by (evidence: `README.md`)
- Backend interface → Vulkan backend: implemented by (evidence: `README.md`)
- Backend interface → D3D12 backend: implemented by (evidence: `README.md`)
- Backend interface → Android backend: platform variant
- Image resources → Frame collector: supplies images
