# elixir-lang/elixir architecture

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

- Interactive diagram: https://gitdiagram.com/elixir-lang/elixir
- Repository: https://github.com/elixir-lang/elixir

## Overview

Elixir is a language and runtime ecosystem for building scalable, maintainable applications. The repository includes the language/runtime, template engine, interactive shell, test framework, logging system, and Mix project tooling. A typical developer workflow uses Mix to compile and start an application, then runs it or interacts with it through IEx; ExUnit and Logger provide testing and diagnostics. The tree and excerpts identify these major areas, but many implementation links are not shown, so uncertain relationships are omitted.

Main entry points: [`lib/iex/lib/iex/server.ex`](https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/server.ex) (Shell server), [`lib/mix/lib/mix/tasks/app.start.ex`](https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix/tasks/app.start.ex) (App start task), [`lib/logger/lib/logger/app.ex`](https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/app.ex) (Logger startup), [`lib/logger/lib/logger/backends/handler.ex`](https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/backends/handler.ex) (Log handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lang["Language and runtime"]
  node_application["Application lifecycle<br/>[application.ex]"]
  node_code_fragment["Code fragments<br/>[fragment.ex]"]
  node_tokenizer["Unicode tokenizer<br/>[tokenizer.ex]"]
  node_type_descriptions["Type descriptions<br/>[descr.ex]"]
  node_inspect_algebra["Inspect formatting<br/>[algebra.ex]"]
  node_option_parser["Option parsing<br/>[option_parser.ex]"]
  node_task_supervised["Supervised tasks<br/>[supervised.ex]"]
end

subgraph group_templates["Template engine"]
  node_eex_api["EEx templates<br/>[eex.ex]"]
  node_eex_compiler["Template compiler<br/>[compiler.ex]"]
  node_eex_engine["Template engine<br/>[engine.ex]"]
  node_smart_engine["Smart engine<br/>[smart_engine.ex]"]
end

subgraph group_shell["Interactive shell"]
  node_iex_api["IEx interface<br/>[iex.ex]"]
  node_iex_server["Shell server<br/>[server.ex]"]
  node_iex_evaluator["Shell evaluator<br/>[evaluator.ex]"]
  node_iex_autocomplete["Autocomplete<br/>[autocomplete.ex]"]
  node_iex_introspection["Introspection<br/>[introspection.ex]"]
end

subgraph group_quality["Testing and logging"]
  node_exunit_api["ExUnit framework<br/>[ex_unit.ex]"]
  node_exunit_server["Test coordination<br/>[server.ex]"]
  node_exunit_events["Test events<br/>[event_manager.ex]"]
  node_logger_api["Logger API<br/>[logger.ex]"]
  node_logger_app["Logger startup<br/>[app.ex]"]
  node_logger_handler["Log handler<br/>[handler.ex]"]
  node_logger_formatter["Log formatter<br/>[formatter.ex]"]
  node_logger_translator["Log translator<br/>[translator.ex]"]
end

subgraph group_mix["Project tooling"]
  node_mix_cli["Mix CLI<br/>[mix.ex]"]
  node_mix_compile["Elixir compiler<br/>[elixir.ex]"]
  node_mix_app_start["App start task<br/>[app.start.ex]"]
  node_mix_app_tree["App tree task<br/>[app.tree.ex]"]
end

node_developer(("Developer"))

node_developer -.->|"invokes"| node_mix_cli
node_mix_app_start -->|"starts apps"| node_application
node_mix_app_start -->|"parses options"| node_option_parser
node_mix_app_start -->|"runs config task"| node_mix_cli
node_mix_app_tree -->|"parses options"| node_option_parser
node_smart_engine -->|"delegates callbacks"| node_eex_engine
node_iex_server -->|"starts evaluator"| node_iex_evaluator
node_iex_server -->|"selects expansion"| node_iex_autocomplete
node_iex_server -->|"registers broker"| node_iex_api
node_logger_app -->|"configures handlers"| node_logger_handler
node_logger_app -->|"registers filter"| node_logger_translator
node_logger_handler -->|"formats events"| node_logger_formatter
node_exunit_events -->|"dispatches handlers"| node_exunit_server

click node_mix_cli "https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix.ex"
click node_mix_compile "https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix/compilers/elixir.ex"
click node_mix_app_start "https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix/tasks/app.start.ex"
click node_mix_app_tree "https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix/tasks/app.tree.ex"
click node_application "https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/application.ex"
click node_code_fragment "https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/code/fragment.ex"
click node_tokenizer "https://github.com/elixir-lang/elixir/blob/main/lib/elixir/unicode/tokenizer.ex"
click node_type_descriptions "https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/module/types/descr.ex"
click node_inspect_algebra "https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/inspect/algebra.ex"
click node_option_parser "https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/option_parser.ex"
click node_task_supervised "https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/task/supervised.ex"
click node_eex_api "https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex.ex"
click node_eex_compiler "https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex/compiler.ex"
click node_eex_engine "https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex/engine.ex"
click node_smart_engine "https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex/smart_engine.ex"
click node_iex_api "https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex.ex"
click node_iex_server "https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/server.ex"
click node_iex_evaluator "https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/evaluator.ex"
click node_iex_autocomplete "https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/autocomplete.ex"
click node_iex_introspection "https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/introspection.ex"
click node_exunit_api "https://github.com/elixir-lang/elixir/blob/main/lib/ex_unit/lib/ex_unit.ex"
click node_exunit_server "https://github.com/elixir-lang/elixir/blob/main/lib/ex_unit/lib/ex_unit/server.ex"
click node_exunit_events "https://github.com/elixir-lang/elixir/blob/main/lib/ex_unit/lib/ex_unit/event_manager.ex"
click node_logger_api "https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger.ex"
click node_logger_app "https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/app.ex"
click node_logger_handler "https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/backends/handler.ex"
click node_logger_formatter "https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/formatter.ex"
click node_logger_translator "https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/translator.ex"

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_application,node_code_fragment,node_tokenizer,node_type_descriptions,node_inspect_algebra,node_option_parser,node_task_supervised toneBlue
class node_eex_api,node_eex_compiler,node_eex_engine,node_smart_engine toneAmber
class node_iex_api,node_iex_server,node_iex_evaluator,node_iex_autocomplete,node_iex_introspection toneMint
class node_exunit_api,node_exunit_server,node_exunit_events,node_logger_api,node_logger_app,node_logger_handler,node_logger_formatter,node_logger_translator toneRose
class node_mix_cli,node_mix_compile,node_mix_app_start,node_mix_app_tree,node_developer toneIndigo
```

## Components

### Language and runtime

- [Application lifecycle](https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/application.ex): `lib/elixir/lib/application.ex`
- [Code fragments](https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/code/fragment.ex): `lib/elixir/lib/code/fragment.ex`
- [Unicode tokenizer](https://github.com/elixir-lang/elixir/blob/main/lib/elixir/unicode/tokenizer.ex): `lib/elixir/unicode/tokenizer.ex`
- [Type descriptions](https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/module/types/descr.ex): `lib/elixir/lib/module/types/descr.ex`
- [Inspect formatting](https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/inspect/algebra.ex): `lib/elixir/lib/inspect/algebra.ex`
- [Option parsing](https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/option_parser.ex): `lib/elixir/lib/option_parser.ex`
- [Supervised tasks](https://github.com/elixir-lang/elixir/blob/main/lib/elixir/lib/task/supervised.ex): `lib/elixir/lib/task/supervised.ex`

### Template engine

- [EEx templates](https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex.ex): `lib/eex/lib/eex.ex`
- [Template compiler](https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex/compiler.ex): `lib/eex/lib/eex/compiler.ex`
- [Template engine](https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex/engine.ex): `lib/eex/lib/eex/engine.ex`
- [Smart engine](https://github.com/elixir-lang/elixir/blob/main/lib/eex/lib/eex/smart_engine.ex): `lib/eex/lib/eex/smart_engine.ex`

### Interactive shell

- [IEx interface](https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex.ex): `lib/iex/lib/iex.ex`
- [Shell server](https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/server.ex): `lib/iex/lib/iex/server.ex`
- [Shell evaluator](https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/evaluator.ex): `lib/iex/lib/iex/evaluator.ex`
- [Autocomplete](https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/autocomplete.ex): `lib/iex/lib/iex/autocomplete.ex`
- [Introspection](https://github.com/elixir-lang/elixir/blob/main/lib/iex/lib/iex/introspection.ex): `lib/iex/lib/iex/introspection.ex`

### Testing and logging

- [ExUnit framework](https://github.com/elixir-lang/elixir/blob/main/lib/ex_unit/lib/ex_unit.ex): `lib/ex_unit/lib/ex_unit.ex`
- [Test coordination](https://github.com/elixir-lang/elixir/blob/main/lib/ex_unit/lib/ex_unit/server.ex): `lib/ex_unit/lib/ex_unit/server.ex`
- [Test events](https://github.com/elixir-lang/elixir/blob/main/lib/ex_unit/lib/ex_unit/event_manager.ex): `lib/ex_unit/lib/ex_unit/event_manager.ex`
- [Logger API](https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger.ex): `lib/logger/lib/logger.ex`
- [Logger startup](https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/app.ex): `lib/logger/lib/logger/app.ex`
- [Log handler](https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/backends/handler.ex): `lib/logger/lib/logger/backends/handler.ex`
- [Log formatter](https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/formatter.ex): `lib/logger/lib/logger/formatter.ex`
- [Log translator](https://github.com/elixir-lang/elixir/blob/main/lib/logger/lib/logger/translator.ex): `lib/logger/lib/logger/translator.ex`

### Project tooling

- [Mix CLI](https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix.ex): `lib/mix/lib/mix.ex`
- [Elixir compiler](https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix/compilers/elixir.ex): `lib/mix/lib/mix/compilers/elixir.ex`
- [App start task](https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix/tasks/app.start.ex): `lib/mix/lib/mix/tasks/app.start.ex`
- [App tree task](https://github.com/elixir-lang/elixir/blob/main/lib/mix/lib/mix/tasks/app.tree.ex): `lib/mix/lib/mix/tasks/app.tree.ex`

### Other components

- **Developer**

## Connections

- Developer → Mix CLI: invokes
- App start task → Application lifecycle: starts apps (evidence: `lib/mix/lib/mix/tasks/app.start.ex`)
- App start task → Option parsing: parses options (evidence: `lib/mix/lib/mix/tasks/app.start.ex`)
- App start task → Mix CLI: runs config task (evidence: `lib/mix/lib/mix/tasks/app.start.ex`)
- App tree task → Option parsing: parses options (evidence: `lib/mix/lib/mix/tasks/app.tree.ex`)
- Smart engine → Template engine: delegates callbacks (evidence: `lib/eex/lib/eex/smart_engine.ex`)
- Shell server → Shell evaluator: starts evaluator (evidence: `lib/iex/lib/iex/server.ex`)
- Shell server → Autocomplete: selects expansion (evidence: `lib/iex/lib/iex/server.ex`)
- Shell server → IEx interface: registers broker (evidence: `lib/iex/lib/iex/server.ex`)
- Logger startup → Log handler: configures handlers (evidence: `lib/logger/lib/logger/app.ex`)
- Logger startup → Log translator: registers filter (evidence: `lib/logger/lib/logger/app.ex`)
- Log handler → Log formatter: formats events (evidence: `lib/logger/lib/logger/backends/handler.ex`)
- Test events → Test coordination: dispatches handlers (evidence: `lib/ex_unit/lib/ex_unit/event_manager.ex`)
