# elastic/eui architecture

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

- Interactive diagram: https://gitdiagram.com/elastic/eui
- Repository: https://github.com/elastic/eui

## Overview

EUI is Elastic’s React design system: application teams consume reusable components and styling/theme utilities to build branded interfaces. The main runtime path runs from a product developer supplying component props, through EUI components and their interaction/data helpers, to rendered UI; the search-bar query API additionally parses and converts queries. The repository also provides theme packages, accessibility lint rules, documentation-site components, and Playwright component-object helpers. Edges are limited to README claims and sampled imports/calls; many tree-listed subsystems are not excerpted.

Main entry points: [`packages/eui/src/components`](https://github.com/elastic/eui/tree/main/packages/eui/src/components) (UI components), [`packages/eui/src/components/search_bar/query/query.ts`](https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/query.ts) (Query API), [`packages/eui-theme-borealis/src/variables/_components.ts`](https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/_components.ts) (Component tokens), [`packages/eui-theme-borealis/src/variables/_buttons.ts`](https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/_buttons.ts) (Button tokens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["React UI"]
  node_components["UI components"]
  node_datagrid_rows["Grid row manager"]
end

subgraph group_query["Search Queries"]
  node_query_api["Query API<br/>[query.ts]"]
  node_query_ast["Query AST<br/>[ast.ts]"]
  node_es_dsl["ES DSL builder"]
  node_es_string["ES string builder"]
end

subgraph group_themes["Themes"]
  node_theme_common["Theme utilities"]
  node_borealis_colors["Semantic colors"]
  node_borealis_components["Component tokens<br/>[_components.ts]"]
  node_borealis_buttons["Button tokens<br/>[_buttons.ts]"]
end

subgraph group_tooling["Developer Tools"]
  node_eslint_rules["ESLint rules"]
  node_eslint_config["Plugin config<br/>[index.ts]"]
  node_docgen["Prop doc generator<br/>[main.ts]"]
  node_playwright_objects["Component objects"]
  node_playwright_base["Object base<br/>[base_object.ts]"]
end

subgraph group_docs["Documentation"]
  node_docs_theme["Docs theme"]
  node_paragraph["MDX paragraph<br/>[Paragraph.tsx]"]
  node_icon_search["Icon search<br/>[icon_search.tsx]"]
end

node_consumer(("Product developer"))
node_docs_author(("Documentation author"))

node_consumer -->|"supplies props"| node_components
node_components -->|"renders UI"| node_consumer
node_datagrid_rows -.->|"manages grid rows"| node_components
node_query_api -->|"parses and edits"| node_query_ast
node_query_api -->|"builds DSL"| node_es_dsl
node_query_api -->|"builds query string"| node_es_string
node_es_dsl -->|"reads AST"| node_query_ast
node_borealis_components -->|"uses computed tokens"| node_theme_common
node_borealis_components -->|"uses semantic colors"| node_borealis_colors
node_borealis_buttons -->|"uses computed tokens"| node_theme_common
node_borealis_buttons -->|"uses semantic colors"| node_borealis_colors
node_eslint_config -->|"registers rules"| node_eslint_rules
node_docgen -->|"generates component metadata"| node_consumer
node_playwright_objects -->|"exports base object"| node_playwright_base
node_playwright_objects -.->|"wraps component behavior"| node_components
node_docs_author -.->|"authors content"| node_docs_theme
node_paragraph -->|"renders EuiText"| node_components
node_icon_search -->|"uses EUI widgets"| node_components

click node_components "https://github.com/elastic/eui/tree/main/packages/eui/src/components"
click node_datagrid_rows "https://github.com/elastic/eui/blob/main/packages/eui/src/components/datagrid/body/data_grid_row_manager.ts"
click node_query_api "https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/query.ts"
click node_query_ast "https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/ast.ts"
click node_es_dsl "https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/ast_to_es_query_dsl.ts"
click node_es_string "https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/ast_to_es_query_string.ts"
click node_theme_common "https://github.com/elastic/eui/tree/main/packages/eui-theme-common/src"
click node_borealis_colors "https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/colors/_semantic_colors.ts"
click node_borealis_components "https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/_components.ts"
click node_borealis_buttons "https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/_buttons.ts"
click node_eslint_rules "https://github.com/elastic/eui/tree/main/packages/eslint-plugin/src/rules"
click node_eslint_config "https://github.com/elastic/eui/blob/main/packages/eslint-plugin/src/index.ts"
click node_docgen "https://github.com/elastic/eui/blob/main/packages/eui-docgen/src/main.ts"
click node_playwright_objects "https://github.com/elastic/eui/tree/main/packages/test-helpers/src/playwright"
click node_playwright_base "https://github.com/elastic/eui/blob/main/packages/test-helpers/src/playwright/base_object.ts"
click node_docs_theme "https://github.com/elastic/eui/tree/main/packages/docusaurus-theme/src"
click node_paragraph "https://github.com/elastic/eui/blob/main/packages/docusaurus-theme/src/theme/MDXComponents/Paragraph.tsx"
click node_icon_search "https://github.com/elastic/eui/blob/main/packages/website/src/components/display/icons/icon_search.tsx"

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_components,node_datagrid_rows toneBlue
class node_query_api,node_query_ast,node_es_dsl,node_es_string toneAmber
class node_theme_common,node_borealis_colors,node_borealis_components,node_borealis_buttons toneMint
class node_eslint_rules,node_eslint_config,node_docgen,node_playwright_objects,node_playwright_base toneRose
class node_docs_theme,node_paragraph,node_icon_search,node_consumer,node_docs_author toneIndigo
```

## Components

### React UI

- [UI components](https://github.com/elastic/eui/tree/main/packages/eui/src/components): `packages/eui/src/components`
- [Grid row manager](https://github.com/elastic/eui/blob/main/packages/eui/src/components/datagrid/body/data_grid_row_manager.ts): `packages/eui/src/components/datagrid/body/data_grid_row_manager.ts`

### Search Queries

- [Query API](https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/query.ts): `packages/eui/src/components/search_bar/query/query.ts`
- [Query AST](https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/ast.ts): `packages/eui/src/components/search_bar/query/ast.ts`
- [ES DSL builder](https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/ast_to_es_query_dsl.ts): `packages/eui/src/components/search_bar/query/ast_to_es_query_dsl.ts`
- [ES string builder](https://github.com/elastic/eui/blob/main/packages/eui/src/components/search_bar/query/ast_to_es_query_string.ts): `packages/eui/src/components/search_bar/query/ast_to_es_query_string.ts`

### Themes

- [Theme utilities](https://github.com/elastic/eui/tree/main/packages/eui-theme-common/src): `packages/eui-theme-common/src`
- [Semantic colors](https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/colors/_semantic_colors.ts): `packages/eui-theme-borealis/src/variables/colors/_semantic_colors.ts`
- [Component tokens](https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/_components.ts): `packages/eui-theme-borealis/src/variables/_components.ts`
- [Button tokens](https://github.com/elastic/eui/blob/main/packages/eui-theme-borealis/src/variables/_buttons.ts): `packages/eui-theme-borealis/src/variables/_buttons.ts`

### Developer Tools

- [ESLint rules](https://github.com/elastic/eui/tree/main/packages/eslint-plugin/src/rules): `packages/eslint-plugin/src/rules`
- [Plugin config](https://github.com/elastic/eui/blob/main/packages/eslint-plugin/src/index.ts): `packages/eslint-plugin/src/index.ts`
- [Prop doc generator](https://github.com/elastic/eui/blob/main/packages/eui-docgen/src/main.ts): `packages/eui-docgen/src/main.ts`
- [Component objects](https://github.com/elastic/eui/tree/main/packages/test-helpers/src/playwright): `packages/test-helpers/src/playwright`
- [Object base](https://github.com/elastic/eui/blob/main/packages/test-helpers/src/playwright/base_object.ts): `packages/test-helpers/src/playwright/base_object.ts`

### Documentation

- [Docs theme](https://github.com/elastic/eui/tree/main/packages/docusaurus-theme/src): `packages/docusaurus-theme/src`
- [MDX paragraph](https://github.com/elastic/eui/blob/main/packages/docusaurus-theme/src/theme/MDXComponents/Paragraph.tsx): `packages/docusaurus-theme/src/theme/MDXComponents/Paragraph.tsx`
- [Icon search](https://github.com/elastic/eui/blob/main/packages/website/src/components/display/icons/icon_search.tsx): `packages/website/src/components/display/icons/icon_search.tsx`

### Other components

- **Product developer**
- **Documentation author**

## Connections

- Product developer → UI components: supplies props
- UI components → Product developer: renders UI
- Grid row manager → UI components: manages grid rows (evidence: `packages/eui/src/components/datagrid/body/data_grid_row_manager.ts`)
- Query API → Query AST: parses and edits (evidence: `packages/eui/src/components/search_bar/query/query.ts`)
- Query API → ES DSL builder: builds DSL (evidence: `packages/eui/src/components/search_bar/query/query.ts`)
- Query API → ES string builder: builds query string (evidence: `packages/eui/src/components/search_bar/query/query.ts`)
- ES DSL builder → Query AST: reads AST (evidence: `packages/eui/src/components/search_bar/query/ast_to_es_query_dsl.ts`)
- Component tokens → Theme utilities: uses computed tokens (evidence: `packages/eui-theme-borealis/src/variables/_components.ts`)
- Component tokens → Semantic colors: uses semantic colors (evidence: `packages/eui-theme-borealis/src/variables/_components.ts`)
- Button tokens → Theme utilities: uses computed tokens (evidence: `packages/eui-theme-borealis/src/variables/_buttons.ts`)
- Button tokens → Semantic colors: uses semantic colors (evidence: `packages/eui-theme-borealis/src/variables/_buttons.ts`)
- Plugin config → ESLint rules: registers rules (evidence: `packages/eslint-plugin/src/index.ts`)
- Prop doc generator → Product developer: generates component metadata (evidence: `packages/eui-docgen/src/main.ts`)
- Component objects → Object base: exports base object (evidence: `packages/test-helpers/src/index.ts`)
- Component objects → UI components: wraps component behavior
- Documentation author → Docs theme: authors content
- MDX paragraph → UI components: renders EuiText (evidence: `packages/docusaurus-theme/src/theme/MDXComponents/Paragraph.tsx`)
- Icon search → UI components: uses EUI widgets (evidence: `packages/website/src/components/display/icons/icon_search.tsx`)
