# flutter-team-archive/engine architecture

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

- Interactive diagram: https://gitdiagram.com/flutter-team-archive/engine
- Repository: https://github.com/flutter-team-archive/engine

## Overview

Flutter Engine is a portable runtime that hosts Flutter applications across platforms. The principal workflow is an embedding or host application starting the engine, which runs Dart code and produces graphics for a platform surface. The repository also contains display-list recording, Impeller rendering, platform integration, I/O, accessibility, plugins, and shader-compilation support. The README establishes these capabilities; sampled source confirms Android multi-engine creation and GPU-pipeline construction. Many subsystem links are dashed because their implementation was not sampled.

Main entry points: [`shell/common/engine.cc`](https://github.com/flutter-team-archive/engine/blob/main/shell/common/engine.cc) (Engine Core), [`impeller/renderer/pipeline_descriptor.cc`](https://github.com/flutter-team-archive/engine/blob/main/impeller/renderer/pipeline_descriptor.cc) (GPU Pipelines), [`shell/platform`](https://github.com/flutter-team-archive/engine/tree/main/shell/platform) (Platform Embedders), [`flow/layers/layer_tree.cc`](https://github.com/flutter-team-archive/engine/blob/main/flow/layers/layer_tree.cc) (Layer Compositor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hosting["Hosting and Runtime"]
  node_embed["Platform Embedders"]
  node_engine["Engine Core<br/>[engine.cc]"]
  node_dart["Dart Runtime"]
  node_isolate["Isolate Manager"]
end

subgraph group_graphics["Graphics and Rendering"]
  node_display["Display Lists<br/>[display_list.cc]"]
  node_layers["Layer Compositor<br/>[layer_tree.cc]"]
  node_compositor["Compositor Context"]
  node_surface["Render Surfaces<br/>[surface.cc]"]
  node_impeller_dl["Impeller Display Lists"]
  node_pipeline["GPU Pipelines"]
  node_backend["Graphics Backends"]
  node_gpu_api["GPU API<br/>[render_pipeline.cc]"]
end

subgraph group_platform["Platform Services"]
  node_plugins["Plugin Architecture"]
  node_accessibility["Accessibility"]
  node_io["File and Network I/O<br/>[io_manager.cc]"]
  node_platform_views["Platform Views"]
end

subgraph group_toolchain["Runtime Toolchain"]
  node_shader_compiler["Shader Compiler<br/>[compiler.cc]"]
  node_font_subset["Font Subsetting<br/>[main.cc]"]
end

subgraph group_foundation["Runtime Foundation"]
  node_tasking["Task Runners<br/>[task_runners.cc]"]
  node_cache[("Persistent Cache")]
end

node_host(("Host Application"))

node_host -.->|"starts"| node_embed
node_embed -.->|"hosts"| node_engine
node_engine -.->|"runs Dart"| node_dart
node_engine -.->|"manages isolates"| node_isolate
node_engine -.->|"composes graphics"| node_display
node_display -.->|"feeds composition"| node_layers
node_layers -.->|"composes layers"| node_compositor
node_compositor -.->|"renders to"| node_surface
node_impeller_dl -.->|"uses pipeline"| node_pipeline
node_gpu_api -->|"configures"| node_pipeline
node_pipeline -.->|"creates pipelines"| node_backend
node_embed -.->|"provides plugins"| node_plugins
node_engine -.->|"supports"| node_accessibility
node_engine -.->|"provides I/O"| node_io
node_layers -.->|"represents views"| node_platform_views
node_shader_compiler -.->|"compiles shaders"| node_pipeline
node_engine -.->|"uses task runners"| node_tasking
node_engine -.->|"uses cache"| node_cache

click node_embed "https://github.com/flutter-team-archive/engine/tree/main/shell/platform"
click node_engine "https://github.com/flutter-team-archive/engine/blob/main/shell/common/engine.cc"
click node_dart "https://github.com/flutter-team-archive/engine/tree/main/runtime"
click node_isolate "https://github.com/flutter-team-archive/engine/blob/main/runtime/platform_isolate_manager.cc"
click node_display "https://github.com/flutter-team-archive/engine/blob/main/display_list/display_list.cc"
click node_layers "https://github.com/flutter-team-archive/engine/blob/main/flow/layers/layer_tree.cc"
click node_compositor "https://github.com/flutter-team-archive/engine/blob/main/flow/compositor_context.cc"
click node_surface "https://github.com/flutter-team-archive/engine/blob/main/flow/surface.cc"
click node_impeller_dl "https://github.com/flutter-team-archive/engine/tree/main/impeller/display_list"
click node_pipeline "https://github.com/flutter-team-archive/engine/blob/main/impeller/renderer/pipeline_descriptor.cc"
click node_backend "https://github.com/flutter-team-archive/engine/tree/main/impeller/renderer/backend"
click node_gpu_api "https://github.com/flutter-team-archive/engine/blob/main/lib/gpu/render_pipeline.cc"
click node_plugins "https://github.com/flutter-team-archive/engine/blob/main/shell/platform/android/io/flutter/embedding/engine/FlutterEngineConnectionRegistry.java"
click node_accessibility "https://github.com/flutter-team-archive/engine/tree/main/shell/platform"
click node_io "https://github.com/flutter-team-archive/engine/blob/main/lib/ui/io_manager.cc"
click node_platform_views "https://github.com/flutter-team-archive/engine/blob/main/flow/layers/platform_view_layer.cc"
click node_shader_compiler "https://github.com/flutter-team-archive/engine/blob/main/impeller/compiler/compiler.cc"
click node_font_subset "https://github.com/flutter-team-archive/engine/blob/main/tools/font_subset/main.cc"
click node_tasking "https://github.com/flutter-team-archive/engine/blob/main/common/task_runners.cc"
click node_cache "https://github.com/flutter-team-archive/engine/blob/main/common/graphics/persistent_cache.cc"

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_embed,node_engine,node_dart,node_isolate toneBlue
class node_display,node_layers,node_compositor,node_surface,node_impeller_dl,node_pipeline,node_backend,node_gpu_api toneAmber
class node_plugins,node_accessibility,node_io,node_platform_views toneMint
class node_shader_compiler,node_font_subset toneRose
class node_tasking,node_cache,node_host toneIndigo
```

## Components

### Hosting and Runtime

- [Platform Embedders](https://github.com/flutter-team-archive/engine/tree/main/shell/platform): `shell/platform`
- [Engine Core](https://github.com/flutter-team-archive/engine/blob/main/shell/common/engine.cc): `shell/common/engine.cc`
- [Dart Runtime](https://github.com/flutter-team-archive/engine/tree/main/runtime): `runtime`
- [Isolate Manager](https://github.com/flutter-team-archive/engine/blob/main/runtime/platform_isolate_manager.cc): `runtime/platform_isolate_manager.cc`

### Graphics and Rendering

- [Display Lists](https://github.com/flutter-team-archive/engine/blob/main/display_list/display_list.cc): `display_list/display_list.cc`
- [Layer Compositor](https://github.com/flutter-team-archive/engine/blob/main/flow/layers/layer_tree.cc): `flow/layers/layer_tree.cc`
- [Compositor Context](https://github.com/flutter-team-archive/engine/blob/main/flow/compositor_context.cc): `flow/compositor_context.cc`
- [Render Surfaces](https://github.com/flutter-team-archive/engine/blob/main/flow/surface.cc): `flow/surface.cc`
- [Impeller Display Lists](https://github.com/flutter-team-archive/engine/tree/main/impeller/display_list): `impeller/display_list`
- [GPU Pipelines](https://github.com/flutter-team-archive/engine/blob/main/impeller/renderer/pipeline_descriptor.cc): `impeller/renderer/pipeline_descriptor.cc`
- [Graphics Backends](https://github.com/flutter-team-archive/engine/tree/main/impeller/renderer/backend): `impeller/renderer/backend`
- [GPU API](https://github.com/flutter-team-archive/engine/blob/main/lib/gpu/render_pipeline.cc): `lib/gpu/render_pipeline.cc`

### Platform Services

- [Plugin Architecture](https://github.com/flutter-team-archive/engine/blob/main/shell/platform/android/io/flutter/embedding/engine/FlutterEngineConnectionRegistry.java): `shell/platform/android/io/flutter/embedding/engine/FlutterEngineConnectionRegistry.java`
- [Accessibility](https://github.com/flutter-team-archive/engine/tree/main/shell/platform): `shell/platform`
- [File and Network I/O](https://github.com/flutter-team-archive/engine/blob/main/lib/ui/io_manager.cc): `lib/ui/io_manager.cc`
- [Platform Views](https://github.com/flutter-team-archive/engine/blob/main/flow/layers/platform_view_layer.cc): `flow/layers/platform_view_layer.cc`

### Runtime Toolchain

- [Shader Compiler](https://github.com/flutter-team-archive/engine/blob/main/impeller/compiler/compiler.cc): `impeller/compiler/compiler.cc`
- [Font Subsetting](https://github.com/flutter-team-archive/engine/blob/main/tools/font_subset/main.cc): `tools/font_subset/main.cc`

### Runtime Foundation

- [Task Runners](https://github.com/flutter-team-archive/engine/blob/main/common/task_runners.cc): `common/task_runners.cc`
- [Persistent Cache](https://github.com/flutter-team-archive/engine/blob/main/common/graphics/persistent_cache.cc): `common/graphics/persistent_cache.cc`

### Other components

- **Host Application**

## Connections

- Host Application → Platform Embedders: starts
- Platform Embedders → Engine Core: hosts
- Engine Core → Dart Runtime: runs Dart
- Engine Core → Isolate Manager: manages isolates
- Engine Core → Display Lists: composes graphics
- Display Lists → Layer Compositor: feeds composition
- Layer Compositor → Compositor Context: composes layers
- Compositor Context → Render Surfaces: renders to
- Impeller Display Lists → GPU Pipelines: uses pipeline
- GPU API → GPU Pipelines: configures (evidence: `lib/gpu/render_pipeline.cc`)
- GPU Pipelines → Graphics Backends: creates pipelines
- Platform Embedders → Plugin Architecture: provides plugins (evidence: `shell/platform/android/io/flutter/embedding/engine/FlutterEngine.java`)
- Engine Core → Accessibility: supports
- Engine Core → File and Network I/O: provides I/O
- Layer Compositor → Platform Views: represents views
- Shader Compiler → GPU Pipelines: compiles shaders
- Engine Core → Task Runners: uses task runners
- Engine Core → Persistent Cache: uses cache
