# bevyengine/bevy architecture

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

- Interactive diagram: https://gitdiagram.com/bevyengine/bevy
- Repository: https://github.com/bevyengine/bevy

## Overview

Bevy is a modular Rust game engine. A game developer configures an App with plugins and systems; the scheduler dispatches those systems over an ECS World, where queries, resources, events, observers, assets, animation, and input update game state. Extraction transfers relevant state into the render app, which specializes GPU pipelines, prepares UI and 2D/3D rendering, applies post-processing, and presents frames. The tree and excerpts directly support the ECS, asset, extraction, pipeline, UI, text, gizmo, meshlet, and post-process branches; some subsystem links remain intentionally coarse.

Main entry points: [`crates/bevy_render/src/render_resource/pipeline_cache.rs`](https://github.com/bevyengine/bevy/blob/main/crates/bevy_render/src/render_resource/pipeline_cache.rs) (Pipeline Cache), [`crates/bevy_ecs/src/system/system.rs`](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/system/system.rs) (Game Systems), [`crates/bevy_ecs/src/world/mod.rs`](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/world/mod.rs) (ECS World), [`crates/bevy_extract/src/lib.rs`](https://github.com/bevyengine/bevy/blob/main/crates/bevy_extract/src/lib.rs) (Render Extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_runtime["App Runtime"]
  node_app["App<br/>[app.rs]"]
  node_plugins["Plugin System<br/>[plugin.rs]"]
  node_scheduler["Schedule Runner<br/>[schedule.rs]"]
  node_systems["Game Systems<br/>[system.rs]"]
end

subgraph group_ecs_state["ECS State"]
  node_world[("ECS World<br/>[mod.rs]")]
  node_queries["Queries Commands<br/>[mod.rs]"]
  node_events["Events Observers<br/>[mod.rs]"]
end

subgraph group_content_input["Content Input"]
  node_input["Input Resources<br/>[input.rs]"]
  node_asset_server["Asset Server<br/>[mod.rs]"]
  node_asset_io["Asset Sources<br/>[mod.rs]"]
  node_animation["Animation Runtime<br/>[lib.rs]"]
end

subgraph group_rendering["Rendering"]
  node_camera["Camera Visibility<br/>[lib.rs]"]
  node_extract["Render Extraction<br/>[lib.rs]"]
  node_pipeline_cache["Pipeline Cache<br/>[pipeline_cache.rs]"]
  node_pbr_meshlets["3D Meshlets<br/>[pipelines.rs]"]
  node_gizmos["Gizmo Renderer<br/>[pipeline_3d.rs]"]
end

subgraph group_presentation["Presentation"]
  node_ui_renderer["UI Renderer"]
  node_ui_slices["UI Texture Slices"]
  node_text_layout["Text Layout<br/>[pipeline.rs]"]
  node_post_process["Post Processing<br/>[pipeline.rs]"]
  node_audio["Audio Output<br/>[audio_output.rs]"]
end

node_developer(("Game Developer"))
node_gpu_display["GPU Display"]
node_operating_system["Operating System"]

node_developer -->|"configures"| node_app
node_app -->|"adds plugins"| node_plugins
node_app -->|"runs schedules"| node_scheduler
node_scheduler -->|"dispatches"| node_systems
node_systems -->|"executes queries"| node_queries
node_queries -->|"reads writes"| node_world
node_world -->|"triggers observers"| node_events
node_operating_system -.->|"provides input"| node_input
node_input -->|"feeds systems"| node_systems
node_asset_server -->|"loads assets"| node_asset_io
node_systems -->|"requests assets"| node_asset_server
node_animation -->|"updates components"| node_world
node_asset_server -->|"supplies assets"| node_animation
node_world -->|"extracts state"| node_extract
node_camera -->|"extracts views"| node_extract
node_extract -->|"transfers UI"| node_ui_renderer
node_extract -->|"transfers scene"| node_pbr_meshlets
node_ui_renderer -->|"specializes pipelines"| node_pipeline_cache
node_ui_slices -->|"specializes pipelines"| node_pipeline_cache
node_text_layout -->|"provides glyphs"| node_ui_renderer
node_gizmos -->|"queues pipelines"| node_pipeline_cache
node_pbr_meshlets -->|"queues compute"| node_pipeline_cache
node_post_process -->|"specializes passes"| node_pipeline_cache
node_pipeline_cache -->|"creates GPU pipelines"| node_gpu_display
node_ui_renderer -->|"renders UI"| node_gpu_display
node_pbr_meshlets -->|"renders 3D"| node_gpu_display
node_post_process -->|"composites effects"| node_gpu_display
node_audio -.->|"outputs sound"| node_operating_system
node_gpu_display -->|"presents frames"| node_operating_system

click node_app "https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/app.rs"
click node_plugins "https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/plugin.rs"
click node_scheduler "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/schedule/schedule.rs"
click node_systems "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/system/system.rs"
click node_world "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/world/mod.rs"
click node_queries "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/query/mod.rs"
click node_events "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/observer/mod.rs"
click node_input "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/system/input.rs"
click node_asset_server "https://github.com/bevyengine/bevy/blob/main/crates/bevy_asset/src/server/mod.rs"
click node_asset_io "https://github.com/bevyengine/bevy/blob/main/crates/bevy_asset/src/io/mod.rs"
click node_animation "https://github.com/bevyengine/bevy/blob/main/crates/bevy_animation/src/lib.rs"
click node_camera "https://github.com/bevyengine/bevy/blob/main/crates/bevy_camera/src/lib.rs"
click node_extract "https://github.com/bevyengine/bevy/blob/main/crates/bevy_extract/src/lib.rs"
click node_pipeline_cache "https://github.com/bevyengine/bevy/blob/main/crates/bevy_render/src/render_resource/pipeline_cache.rs"
click node_pbr_meshlets "https://github.com/bevyengine/bevy/blob/main/crates/bevy_pbr/src/meshlet/pipelines.rs"
click node_gizmos "https://github.com/bevyengine/bevy/blob/main/crates/bevy_gizmos_render/src/pipeline_3d.rs"
click node_ui_renderer "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ui_render/src/ui_material_pipeline.rs"
click node_ui_slices "https://github.com/bevyengine/bevy/blob/main/crates/bevy_ui_render/src/ui_texture_slice_pipeline.rs"
click node_text_layout "https://github.com/bevyengine/bevy/blob/main/crates/bevy_text/src/pipeline.rs"
click node_post_process "https://github.com/bevyengine/bevy/blob/main/crates/bevy_post_process/src/motion_blur/pipeline.rs"
click node_audio "https://github.com/bevyengine/bevy/blob/main/crates/bevy_audio/src/audio_output.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_app,node_plugins,node_scheduler,node_systems toneBlue
class node_world,node_queries,node_events toneAmber
class node_input,node_asset_server,node_asset_io,node_animation toneMint
class node_camera,node_extract,node_pipeline_cache,node_pbr_meshlets,node_gizmos toneRose
class node_ui_renderer,node_ui_slices,node_text_layout,node_post_process,node_audio,node_developer,node_gpu_display,node_operating_system toneIndigo
```

## Components

### App Runtime

- [App](https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/app.rs): `crates/bevy_app/src/app.rs`
- [Plugin System](https://github.com/bevyengine/bevy/blob/main/crates/bevy_app/src/plugin.rs): `crates/bevy_app/src/plugin.rs`
- [Schedule Runner](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/schedule/schedule.rs): `crates/bevy_ecs/src/schedule/schedule.rs`
- [Game Systems](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/system/system.rs): `crates/bevy_ecs/src/system/system.rs`

### ECS State

- [ECS World](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/world/mod.rs): `crates/bevy_ecs/src/world/mod.rs`
- [Queries Commands](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/query/mod.rs): `crates/bevy_ecs/src/query/mod.rs`
- [Events Observers](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/observer/mod.rs): `crates/bevy_ecs/src/observer/mod.rs`

### Content Input

- [Input Resources](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ecs/src/system/input.rs): `crates/bevy_ecs/src/system/input.rs`
- [Asset Server](https://github.com/bevyengine/bevy/blob/main/crates/bevy_asset/src/server/mod.rs): `crates/bevy_asset/src/server/mod.rs`
- [Asset Sources](https://github.com/bevyengine/bevy/blob/main/crates/bevy_asset/src/io/mod.rs): `crates/bevy_asset/src/io/mod.rs`
- [Animation Runtime](https://github.com/bevyengine/bevy/blob/main/crates/bevy_animation/src/lib.rs): `crates/bevy_animation/src/lib.rs`

### Rendering

- [Camera Visibility](https://github.com/bevyengine/bevy/blob/main/crates/bevy_camera/src/lib.rs): `crates/bevy_camera/src/lib.rs`
- [Render Extraction](https://github.com/bevyengine/bevy/blob/main/crates/bevy_extract/src/lib.rs): `crates/bevy_extract/src/lib.rs`
- [Pipeline Cache](https://github.com/bevyengine/bevy/blob/main/crates/bevy_render/src/render_resource/pipeline_cache.rs): `crates/bevy_render/src/render_resource/pipeline_cache.rs`
- [3D Meshlets](https://github.com/bevyengine/bevy/blob/main/crates/bevy_pbr/src/meshlet/pipelines.rs): `crates/bevy_pbr/src/meshlet/pipelines.rs`
- [Gizmo Renderer](https://github.com/bevyengine/bevy/blob/main/crates/bevy_gizmos_render/src/pipeline_3d.rs): `crates/bevy_gizmos_render/src/pipeline_3d.rs`

### Presentation

- [UI Renderer](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ui_render/src/ui_material_pipeline.rs): `crates/bevy_ui_render/src/ui_material_pipeline.rs`
- [UI Texture Slices](https://github.com/bevyengine/bevy/blob/main/crates/bevy_ui_render/src/ui_texture_slice_pipeline.rs): `crates/bevy_ui_render/src/ui_texture_slice_pipeline.rs`
- [Text Layout](https://github.com/bevyengine/bevy/blob/main/crates/bevy_text/src/pipeline.rs): `crates/bevy_text/src/pipeline.rs`
- [Post Processing](https://github.com/bevyengine/bevy/blob/main/crates/bevy_post_process/src/motion_blur/pipeline.rs): `crates/bevy_post_process/src/motion_blur/pipeline.rs`
- [Audio Output](https://github.com/bevyengine/bevy/blob/main/crates/bevy_audio/src/audio_output.rs): `crates/bevy_audio/src/audio_output.rs`

### Other components

- **Game Developer**
- **GPU Display**
- **Operating System**

## Connections

- Game Developer → App: configures
- App → Plugin System: adds plugins
- App → Schedule Runner: runs schedules
- Schedule Runner → Game Systems: dispatches
- Game Systems → Queries Commands: executes queries
- Queries Commands → ECS World: reads writes
- ECS World → Events Observers: triggers observers
- Operating System → Input Resources: provides input
- Input Resources → Game Systems: feeds systems
- Asset Server → Asset Sources: loads assets
- Game Systems → Asset Server: requests assets
- Animation Runtime → ECS World: updates components
- Asset Server → Animation Runtime: supplies assets
- ECS World → Render Extraction: extracts state
- Camera Visibility → Render Extraction: extracts views
- Render Extraction → UI Renderer: transfers UI
- Render Extraction → 3D Meshlets: transfers scene
- UI Renderer → Pipeline Cache: specializes pipelines
- UI Texture Slices → Pipeline Cache: specializes pipelines
- Text Layout → UI Renderer: provides glyphs
- Gizmo Renderer → Pipeline Cache: queues pipelines
- 3D Meshlets → Pipeline Cache: queues compute
- Post Processing → Pipeline Cache: specializes passes
- Pipeline Cache → GPU Display: creates GPU pipelines
- UI Renderer → GPU Display: renders UI
- 3D Meshlets → GPU Display: renders 3D
- Post Processing → GPU Display: composites effects
- Audio Output → Operating System: outputs sound
- GPU Display → Operating System: presents frames
