# ziglang/zig architecture

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

- Interactive diagram: https://gitdiagram.com/ziglang/zig
- Repository: https://github.com/ziglang/zig

## Overview

This is the Zig compiler/toolchain repository, with compiler sources, target support, runtime libraries, and bundled LLVM-family components. The likely user workflow is to compile Zig source through semantic analysis and intermediate representation toward a selected target. The excerpts do not show the compiler’s runtime call chain, and the README only announces a move, so those workflow links are marked unverified. The graph also preserves substantial bundled exception, unwinding, and sanitizer components indicated by the source index; their internal links reflect only documented or excerpted references.

Main entry points: [`src/Compilation.zig`](https://github.com/ziglang/zig/blob/master/src/Compilation.zig) (Compilation), [`lib/libtsan/sanitizer_common/sanitizer_flag_parser.h`](https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_flag_parser.h) (Flag parser), [`src/Sema.zig`](https://github.com/ziglang/zig/blob/master/src/Sema.zig) (Semantic analysis), [`lib/libtsan/sanitizer_common/sanitizer_common.h`](https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_common.h) (Sanitizer common)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_compiler["Zig compiler"]
  node_compilation["Compilation<br/>[Compilation.zig]"]
  node_sema["Semantic analysis<br/>[Sema.zig]"]
  node_air["AIR representation<br/>[Air.zig]"]
  node_internpool[("Intern pool<br/>[InternPool.zig]")]
  node_package["Package management<br/>[Package.zig]"]
  node_fetch["Package fetching<br/>[Fetch.zig]"]
end

subgraph group_target["Targets and runtime"]
  node_targetquery["Target selection<br/>[Query.zig]"]
  node_targetmodels["Target definitions<br/>[Target.zig]"]
  node_zigheader["C ABI support<br/>[zig.h]"]
end

subgraph group_cppabi["C++ ABI support"]
  node_cxxabi["C++ ABI interface<br/>[cxxabi.h]"]
  node_exceptionstorage["Exception storage"]
  node_handlers["Exception handlers<br/>[cxa_handlers.cpp]"]
  node_unwindapi["Unwind interface<br/>[libunwind.h]"]
  node_dwarfparser["DWARF parser<br/>[DwarfParser.hpp]"]
  node_registers["Register state<br/>[Registers.hpp]"]
end

subgraph group_sanitizer["Sanitizer runtime"]
  node_flagparser["Flag parser"]
  node_sanitizercommon["Sanitizer common<br/>[sanitizer_common.h]"]
  node_sanitizerdefs["Sanitizer definitions"]
  node_sanitizerlibc["Sanitizer libc<br/>[sanitizer_libc.h]"]
end

node_user(("Compiler user"))

node_user -.->|"submits source"| node_compilation
node_compilation -.->|"uses packages"| node_package
node_compilation -.->|"analyzes source"| node_sema
node_sema -.->|"uses interned data"| node_internpool
node_sema -.->|"produces AIR"| node_air
node_compilation -.->|"selects target"| node_targetquery
node_targetquery -.->|"queries target"| node_targetmodels
node_compilation -.->|"uses ABI support"| node_zigheader
node_fetch -.->|"supports fetching"| node_package
node_exceptionstorage -->|"includes interface"| node_cxxabi
node_handlers -->|"includes interface"| node_cxxabi
node_dwarfparser -->|"uses unwind API"| node_unwindapi
node_dwarfparser -->|"uses registers"| node_registers
node_flagparser -->|"includes common"| node_sanitizercommon
node_flagparser -->|"includes definitions"| node_sanitizerdefs
node_flagparser -->|"includes libc"| node_sanitizerlibc
node_sanitizercommon -->|"includes definitions"| node_sanitizerdefs
node_sanitizercommon -->|"includes libc"| node_sanitizerlibc

click node_compilation "https://github.com/ziglang/zig/blob/master/src/Compilation.zig"
click node_sema "https://github.com/ziglang/zig/blob/master/src/Sema.zig"
click node_air "https://github.com/ziglang/zig/blob/master/src/Air.zig"
click node_internpool "https://github.com/ziglang/zig/blob/master/src/InternPool.zig"
click node_package "https://github.com/ziglang/zig/blob/master/src/Package.zig"
click node_fetch "https://github.com/ziglang/zig/blob/master/src/Package/Fetch.zig"
click node_targetquery "https://github.com/ziglang/zig/blob/master/lib/std/Target/Query.zig"
click node_targetmodels "https://github.com/ziglang/zig/blob/master/lib/std/Target.zig"
click node_zigheader "https://github.com/ziglang/zig/blob/master/lib/zig.h"
click node_cxxabi "https://github.com/ziglang/zig/blob/master/lib/libcxxabi/include/cxxabi.h"
click node_exceptionstorage "https://github.com/ziglang/zig/blob/master/lib/libcxxabi/src/cxa_exception_storage.cpp"
click node_handlers "https://github.com/ziglang/zig/blob/master/lib/libcxxabi/src/cxa_handlers.cpp"
click node_unwindapi "https://github.com/ziglang/zig/blob/master/lib/libunwind/include/libunwind.h"
click node_dwarfparser "https://github.com/ziglang/zig/blob/master/lib/libunwind/src/DwarfParser.hpp"
click node_registers "https://github.com/ziglang/zig/blob/master/lib/libunwind/src/Registers.hpp"
click node_flagparser "https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_flag_parser.h"
click node_sanitizercommon "https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_common.h"
click node_sanitizerdefs "https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_internal_defs.h"
click node_sanitizerlibc "https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_libc.h"

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_compilation,node_sema,node_air,node_internpool,node_package,node_fetch,node_user toneBlue
class node_targetquery,node_targetmodels,node_zigheader toneAmber
class node_cxxabi,node_exceptionstorage,node_handlers,node_unwindapi,node_dwarfparser,node_registers toneMint
class node_flagparser,node_sanitizercommon,node_sanitizerdefs,node_sanitizerlibc toneRose
```

## Components

### Zig compiler

- [Compilation](https://github.com/ziglang/zig/blob/master/src/Compilation.zig): `src/Compilation.zig`
- [Semantic analysis](https://github.com/ziglang/zig/blob/master/src/Sema.zig): `src/Sema.zig`
- [AIR representation](https://github.com/ziglang/zig/blob/master/src/Air.zig): `src/Air.zig`
- [Intern pool](https://github.com/ziglang/zig/blob/master/src/InternPool.zig): `src/InternPool.zig`
- [Package management](https://github.com/ziglang/zig/blob/master/src/Package.zig): `src/Package.zig`
- [Package fetching](https://github.com/ziglang/zig/blob/master/src/Package/Fetch.zig): `src/Package/Fetch.zig`

### Targets and runtime

- [Target selection](https://github.com/ziglang/zig/blob/master/lib/std/Target/Query.zig): `lib/std/Target/Query.zig`
- [Target definitions](https://github.com/ziglang/zig/blob/master/lib/std/Target.zig): `lib/std/Target.zig`
- [C ABI support](https://github.com/ziglang/zig/blob/master/lib/zig.h): `lib/zig.h`

### C++ ABI support

- [C++ ABI interface](https://github.com/ziglang/zig/blob/master/lib/libcxxabi/include/cxxabi.h): `lib/libcxxabi/include/cxxabi.h`
- [Exception storage](https://github.com/ziglang/zig/blob/master/lib/libcxxabi/src/cxa_exception_storage.cpp): `lib/libcxxabi/src/cxa_exception_storage.cpp`
- [Exception handlers](https://github.com/ziglang/zig/blob/master/lib/libcxxabi/src/cxa_handlers.cpp): `lib/libcxxabi/src/cxa_handlers.cpp`
- [Unwind interface](https://github.com/ziglang/zig/blob/master/lib/libunwind/include/libunwind.h): `lib/libunwind/include/libunwind.h`
- [DWARF parser](https://github.com/ziglang/zig/blob/master/lib/libunwind/src/DwarfParser.hpp): `lib/libunwind/src/DwarfParser.hpp`
- [Register state](https://github.com/ziglang/zig/blob/master/lib/libunwind/src/Registers.hpp): `lib/libunwind/src/Registers.hpp`

### Sanitizer runtime

- [Flag parser](https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_flag_parser.h): `lib/libtsan/sanitizer_common/sanitizer_flag_parser.h`
- [Sanitizer common](https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_common.h): `lib/libtsan/sanitizer_common/sanitizer_common.h`
- [Sanitizer definitions](https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_internal_defs.h): `lib/libtsan/sanitizer_common/sanitizer_internal_defs.h`
- [Sanitizer libc](https://github.com/ziglang/zig/blob/master/lib/libtsan/sanitizer_common/sanitizer_libc.h): `lib/libtsan/sanitizer_common/sanitizer_libc.h`

### Other components

- **Compiler user**

## Connections

- Compiler user → Compilation: submits source
- Compilation → Package management: uses packages
- Compilation → Semantic analysis: analyzes source
- Semantic analysis → Intern pool: uses interned data
- Semantic analysis → AIR representation: produces AIR
- Compilation → Target selection: selects target
- Target selection → Target definitions: queries target
- Compilation → C ABI support: uses ABI support
- Package fetching → Package management: supports fetching
- Exception storage → C++ ABI interface: includes interface (evidence: `lib/libcxxabi/src/cxa_exception_storage.cpp`)
- Exception handlers → C++ ABI interface: includes interface (evidence: `lib/libcxxabi/src/cxa_handlers.cpp`)
- DWARF parser → Unwind interface: uses unwind API (evidence: `lib/libunwind/src/DwarfParser.hpp`)
- DWARF parser → Register state: uses registers (evidence: `lib/libunwind/src/DwarfParser.hpp`)
- Flag parser → Sanitizer common: includes common (evidence: `lib/libtsan/sanitizer_common/sanitizer_flag_parser.h`)
- Flag parser → Sanitizer definitions: includes definitions (evidence: `lib/libtsan/sanitizer_common/sanitizer_flag_parser.h`)
- Flag parser → Sanitizer libc: includes libc (evidence: `lib/libtsan/sanitizer_common/sanitizer_flag_parser.h`)
- Sanitizer common → Sanitizer definitions: includes definitions (evidence: `lib/libtsan/sanitizer_common/sanitizer_common.h`)
- Sanitizer common → Sanitizer libc: includes libc (evidence: `lib/libtsan/sanitizer_common/sanitizer_common.h`)
