# ocornut/imgui architecture

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

- Interactive diagram: https://gitdiagram.com/ocornut/imgui
- Repository: https://github.com/ocornut/imgui

## Overview

Dear ImGui is a platform-agnostic immediate-mode C++ GUI library. An application feeds platform events, creates a frame, emits widgets and tool content, then receives optimized draw lists for a renderer backend to submit to a graphics API. The core also manages layout, interaction, tables, fonts, and reusable UI state. Platform and renderer integrations are modular; FreeType is an optional font-building path. Some relationships are inferred from documented architecture because most core implementations were not sampled.

Main entry points: [`imgui.cpp`](https://github.com/ocornut/imgui/blob/master/imgui.cpp) (UI Context), [`imgui.h`](https://github.com/ocornut/imgui/blob/master/imgui.h) (ImGui API), [`imgui_draw.cpp`](https://github.com/ocornut/imgui/blob/master/imgui_draw.cpp) (Draw Lists), [`backends`](https://github.com/ocornut/imgui/tree/master/backends) (Renderer Backends)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core UI"]
  node_api["ImGui API<br/>[imgui.h]"]
  node_context["UI Context<br/>[imgui.cpp]"]
  node_widgets["Widgets &amp; Layout<br/>[imgui_widgets.cpp]"]
  node_tables["Tables<br/>[imgui_tables.cpp]"]
end

subgraph group_render["Drawing"]
  node_draw["Draw Lists<br/>[imgui_draw.cpp]"]
  node_fonts["Font Atlas<br/>[imgui_draw.cpp]"]
end

subgraph group_integration["Integrations"]
  node_platform["Platform Backends"]
  node_renderer["Renderer Backends"]
end

subgraph group_extensions["Extensions"]
  node_demo["Demo Tools<br/>[imgui_demo.cpp]"]
  node_stdlib["STL Input Wrappers<br/>[imgui_stdlib.cpp]"]
  node_freetype["FreeType Loader<br/>[imgui_freetype.cpp]"]
end

node_app(("Application"))
node_os(("Platform Events"))
node_gpu{{"Graphics API"}}

node_os -->|"sends events"| node_platform
node_platform -->|"feeds input"| node_context
node_app -->|"calls widgets"| node_api
node_api -->|"updates frame"| node_context
node_context -->|"dispatches UI"| node_widgets
node_widgets -->|"builds tables"| node_tables
node_context -->|"builds commands"| node_draw
node_fonts -->|"supplies glyphs"| node_draw
node_app -->|"submits frame"| node_renderer
node_draw -->|"provides draw data"| node_renderer
node_renderer -->|"renders triangles"| node_gpu
node_app -->|"shows demo"| node_demo
node_app -->|"uses strings"| node_stdlib
node_stdlib -->|"wraps input"| node_api
node_freetype -.->|"builds fonts"| node_fonts

click node_api "https://github.com/ocornut/imgui/blob/master/imgui.h"
click node_context "https://github.com/ocornut/imgui/blob/master/imgui.cpp"
click node_widgets "https://github.com/ocornut/imgui/blob/master/imgui_widgets.cpp"
click node_tables "https://github.com/ocornut/imgui/blob/master/imgui_tables.cpp"
click node_draw "https://github.com/ocornut/imgui/blob/master/imgui_draw.cpp"
click node_fonts "https://github.com/ocornut/imgui/blob/master/imgui_draw.cpp"
click node_platform "https://github.com/ocornut/imgui/tree/master/backends"
click node_renderer "https://github.com/ocornut/imgui/tree/master/backends"
click node_demo "https://github.com/ocornut/imgui/blob/master/imgui_demo.cpp"
click node_stdlib "https://github.com/ocornut/imgui/blob/master/misc/cpp/imgui_stdlib.cpp"
click node_freetype "https://github.com/ocornut/imgui/blob/master/misc/freetype/imgui_freetype.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_api,node_context,node_widgets,node_tables toneBlue
class node_draw,node_fonts toneAmber
class node_platform,node_renderer,node_gpu toneMint
class node_demo,node_stdlib,node_freetype toneRose
class node_app,node_os toneIndigo
```

## Components

### Core UI

- [ImGui API](https://github.com/ocornut/imgui/blob/master/imgui.h): `imgui.h`
- [UI Context](https://github.com/ocornut/imgui/blob/master/imgui.cpp): `imgui.cpp`
- [Widgets & Layout](https://github.com/ocornut/imgui/blob/master/imgui_widgets.cpp): `imgui_widgets.cpp`
- [Tables](https://github.com/ocornut/imgui/blob/master/imgui_tables.cpp): `imgui_tables.cpp`

### Drawing

- [Draw Lists](https://github.com/ocornut/imgui/blob/master/imgui_draw.cpp): `imgui_draw.cpp`
- [Font Atlas](https://github.com/ocornut/imgui/blob/master/imgui_draw.cpp): `imgui_draw.cpp`

### Integrations

- [Platform Backends](https://github.com/ocornut/imgui/tree/master/backends): `backends`
- [Renderer Backends](https://github.com/ocornut/imgui/tree/master/backends): `backends`

### Extensions

- [Demo Tools](https://github.com/ocornut/imgui/blob/master/imgui_demo.cpp): `imgui_demo.cpp`
- [STL Input Wrappers](https://github.com/ocornut/imgui/blob/master/misc/cpp/imgui_stdlib.cpp): `misc/cpp/imgui_stdlib.cpp`
- [FreeType Loader](https://github.com/ocornut/imgui/blob/master/misc/freetype/imgui_freetype.cpp): `misc/freetype/imgui_freetype.cpp`

### Other components

- **Application**
- **Platform Events**
- **Graphics API**

## Connections

- Platform Events → Platform Backends: sends events
- Platform Backends → UI Context: feeds input
- Application → ImGui API: calls widgets
- ImGui API → UI Context: updates frame
- UI Context → Widgets & Layout: dispatches UI
- Widgets & Layout → Tables: builds tables
- UI Context → Draw Lists: builds commands
- Font Atlas → Draw Lists: supplies glyphs
- Application → Renderer Backends: submits frame
- Draw Lists → Renderer Backends: provides draw data
- Renderer Backends → Graphics API: renders triangles
- Application → Demo Tools: shows demo
- Application → STL Input Wrappers: uses strings
- STL Input Wrappers → ImGui API: wraps input
- FreeType Loader → Font Atlas: builds fonts
