# aetherbrowser/aether architecture

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

- Interactive diagram: https://gitdiagram.com/aetherbrowser/aether
- Repository: https://github.com/aetherbrowser/aether

## Overview

Servo is a prototype web browser engine. Its principal runtime path is web content handled by script and DOM services, coordinated as browsing-context pipelines, laid out into display data, then painted and presented. The repository also includes networking, media, storage, fonts, debugging, automation, and WebGPU capabilities. The graph preserves these distinct product areas; many cross-subsystem links are omitted because the supplied excerpts do not show their runtime wiring. Layout links are supported by the SOURCE INDEX references, not a full inspection of those implementations.

Main entry points: [`components/layout/layout_impl.rs`](https://github.com/aetherbrowser/aether/blob/master/components/layout/layout_impl.rs) (Layout engine), [`components/constellation/pipeline.rs`](https://github.com/aetherbrowser/aether/blob/master/components/constellation/pipeline.rs) (Page pipelines), [`components/script/dom`](https://github.com/aetherbrowser/aether/tree/master/components/script/dom) (Script and DOM), [`components/script_webgpu/traits.rs`](https://github.com/aetherbrowser/aether/blob/master/components/script_webgpu/traits.rs) (WebGPU interfaces)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordination["Browser coordination"]
  node_pipeline["Page pipelines<br/>[pipeline.rs]"]
  node_event_loop["Constellation loop<br/>[event_loop.rs]"]
  node_script_dom["Script and DOM"]
end

subgraph group_rendering["Rendering"]
  node_layout_impl["Layout engine<br/>[layout_impl.rs]"]
  node_layout_dom["Layout DOM<br/>[dom.rs]"]
  node_dom_traversal["DOM traversal<br/>[dom_traversal.rs]"]
  node_style_ext["Style extensions<br/>[style_ext.rs]"]
  node_layout_query["Layout queries<br/>[query.rs]"]
  node_stacking_context["Stacking contexts"]
  node_painter["Painter<br/>[painter.rs]"]
end

subgraph group_platform["Platform services"]
  node_network["Fetch and networking<br/>[methods.rs]"]
  node_storage[("Web storage")]
  node_fonts["Font service"]
  node_media["Media engine"]
end

subgraph group_web_features["Web capabilities"]
  node_bluetooth["Bluetooth<br/>[bluetooth.rs]"]
  node_bluetooth_adapter["Bluetooth adapter<br/>[adapter.rs]"]
  node_webgpu_compute["Compute pipelines"]
  node_webgpu_render["Render pipelines"]
  node_webgpu_traits["WebGPU interfaces<br/>[traits.rs]"]
end

subgraph group_tools["Inspection and automation"]
  node_devtools["Developer tools<br/>[lib.rs]"]
  node_webdriver["WebDriver server<br/>[lib.rs]"]
end

node_web_content["Web content"]

node_web_content -.->|"handled by"| node_script_dom
node_script_dom -.->|"runs in"| node_pipeline
node_pipeline -->|"spawns through"| node_event_loop
node_layout_impl -->|"uses"| node_layout_dom
node_layout_impl -->|"uses"| node_dom_traversal
node_layout_impl -->|"uses"| node_style_ext
node_layout_impl -->|"uses"| node_layout_query
node_layout_impl -->|"builds"| node_stacking_context
node_layout_impl -.->|"produces paint data"| node_painter
node_bluetooth -.->|"uses"| node_bluetooth_adapter
node_webgpu_compute -->|"implements interfaces"| node_webgpu_traits
node_webgpu_render -->|"implements interfaces"| node_webgpu_traits

click node_pipeline "https://github.com/aetherbrowser/aether/blob/master/components/constellation/pipeline.rs"
click node_event_loop "https://github.com/aetherbrowser/aether/blob/master/components/constellation/event_loop.rs"
click node_script_dom "https://github.com/aetherbrowser/aether/tree/master/components/script/dom"
click node_layout_impl "https://github.com/aetherbrowser/aether/blob/master/components/layout/layout_impl.rs"
click node_layout_dom "https://github.com/aetherbrowser/aether/blob/master/components/layout/dom.rs"
click node_dom_traversal "https://github.com/aetherbrowser/aether/blob/master/components/layout/dom_traversal.rs"
click node_style_ext "https://github.com/aetherbrowser/aether/blob/master/components/layout/style_ext.rs"
click node_layout_query "https://github.com/aetherbrowser/aether/blob/master/components/layout/query.rs"
click node_stacking_context "https://github.com/aetherbrowser/aether/blob/master/components/layout/display_list/stacking_context.rs"
click node_painter "https://github.com/aetherbrowser/aether/blob/master/components/paint/painter.rs"
click node_network "https://github.com/aetherbrowser/aether/blob/master/components/net/fetch/methods.rs"
click node_storage "https://github.com/aetherbrowser/aether/tree/master/components/storage"
click node_fonts "https://github.com/aetherbrowser/aether/blob/master/components/fonts/system_font_service.rs"
click node_media "https://github.com/aetherbrowser/aether/tree/master/components/media"
click node_bluetooth "https://github.com/aetherbrowser/aether/blob/master/components/bluetooth/bluetooth.rs"
click node_bluetooth_adapter "https://github.com/aetherbrowser/aether/blob/master/components/bluetooth/adapter.rs"
click node_webgpu_compute "https://github.com/aetherbrowser/aether/blob/master/components/script_webgpu/gpucomputepipeline.rs"
click node_webgpu_render "https://github.com/aetherbrowser/aether/blob/master/components/script_webgpu/gpurenderpipeline.rs"
click node_webgpu_traits "https://github.com/aetherbrowser/aether/blob/master/components/script_webgpu/traits.rs"
click node_devtools "https://github.com/aetherbrowser/aether/blob/master/components/devtools/lib.rs"
click node_webdriver "https://github.com/aetherbrowser/aether/blob/master/components/webdriver_server/lib.rs"

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_pipeline,node_event_loop,node_script_dom toneBlue
class node_layout_impl,node_layout_dom,node_dom_traversal,node_style_ext,node_layout_query,node_stacking_context,node_painter toneAmber
class node_network,node_storage,node_fonts,node_media toneMint
class node_bluetooth,node_bluetooth_adapter,node_webgpu_compute,node_webgpu_render,node_webgpu_traits toneRose
class node_devtools,node_webdriver,node_web_content toneIndigo
```

## Components

### Browser coordination

- [Page pipelines](https://github.com/aetherbrowser/aether/blob/master/components/constellation/pipeline.rs): `components/constellation/pipeline.rs`
- [Constellation loop](https://github.com/aetherbrowser/aether/blob/master/components/constellation/event_loop.rs): `components/constellation/event_loop.rs`
- [Script and DOM](https://github.com/aetherbrowser/aether/tree/master/components/script/dom): `components/script/dom`

### Rendering

- [Layout engine](https://github.com/aetherbrowser/aether/blob/master/components/layout/layout_impl.rs): `components/layout/layout_impl.rs`
- [Layout DOM](https://github.com/aetherbrowser/aether/blob/master/components/layout/dom.rs): `components/layout/dom.rs`
- [DOM traversal](https://github.com/aetherbrowser/aether/blob/master/components/layout/dom_traversal.rs): `components/layout/dom_traversal.rs`
- [Style extensions](https://github.com/aetherbrowser/aether/blob/master/components/layout/style_ext.rs): `components/layout/style_ext.rs`
- [Layout queries](https://github.com/aetherbrowser/aether/blob/master/components/layout/query.rs): `components/layout/query.rs`
- [Stacking contexts](https://github.com/aetherbrowser/aether/blob/master/components/layout/display_list/stacking_context.rs): `components/layout/display_list/stacking_context.rs`
- [Painter](https://github.com/aetherbrowser/aether/blob/master/components/paint/painter.rs): `components/paint/painter.rs`

### Platform services

- [Fetch and networking](https://github.com/aetherbrowser/aether/blob/master/components/net/fetch/methods.rs): `components/net/fetch/methods.rs`
- [Web storage](https://github.com/aetherbrowser/aether/tree/master/components/storage): `components/storage`
- [Font service](https://github.com/aetherbrowser/aether/blob/master/components/fonts/system_font_service.rs): `components/fonts/system_font_service.rs`
- [Media engine](https://github.com/aetherbrowser/aether/tree/master/components/media): `components/media`

### Web capabilities

- [Bluetooth](https://github.com/aetherbrowser/aether/blob/master/components/bluetooth/bluetooth.rs): `components/bluetooth/bluetooth.rs`
- [Bluetooth adapter](https://github.com/aetherbrowser/aether/blob/master/components/bluetooth/adapter.rs): `components/bluetooth/adapter.rs`
- [Compute pipelines](https://github.com/aetherbrowser/aether/blob/master/components/script_webgpu/gpucomputepipeline.rs): `components/script_webgpu/gpucomputepipeline.rs`
- [Render pipelines](https://github.com/aetherbrowser/aether/blob/master/components/script_webgpu/gpurenderpipeline.rs): `components/script_webgpu/gpurenderpipeline.rs`
- [WebGPU interfaces](https://github.com/aetherbrowser/aether/blob/master/components/script_webgpu/traits.rs): `components/script_webgpu/traits.rs`

### Inspection and automation

- [Developer tools](https://github.com/aetherbrowser/aether/blob/master/components/devtools/lib.rs): `components/devtools/lib.rs`
- [WebDriver server](https://github.com/aetherbrowser/aether/blob/master/components/webdriver_server/lib.rs): `components/webdriver_server/lib.rs`

### Other components

- **Web content**

## Connections

- Web content → Script and DOM: handled by
- Script and DOM → Page pipelines: runs in
- Page pipelines → Constellation loop: spawns through (evidence: `components/constellation/pipeline.rs`)
- Layout engine → Layout DOM: uses (evidence: `components/layout/layout_impl.rs`)
- Layout engine → DOM traversal: uses (evidence: `components/layout/layout_impl.rs`)
- Layout engine → Style extensions: uses
- Layout engine → Layout queries: uses (evidence: `components/layout/layout_impl.rs`)
- Layout engine → Stacking contexts: builds
- Layout engine → Painter: produces paint data
- Bluetooth → Bluetooth adapter: uses (evidence: `components/bluetooth/bluetooth.rs`)
- Compute pipelines → WebGPU interfaces: implements interfaces (evidence: `components/script_webgpu/gpucomputepipeline.rs`)
- Render pipelines → WebGPU interfaces: implements interfaces (evidence: `components/script_webgpu/gpurenderpipeline.rs`)
