# thebevyflock/bevy_new_2d architecture

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

- Interactive diagram: https://gitdiagram.com/thebevyflock/bevy_new_2d
- Repository: https://github.com/thebevyflock/bevy_new_2d

## Overview

Bevy New 2D is a starter game template. Its runtime starts the Bevy app, presents a splash and title/menu flow, waits for tracked assets before gameplay, and provides example game mechanics. The graph includes documented template capabilities even where their implementation was not excerpted; those connections are omitted or marked unverified rather than inferred from module names. Evidence is limited to the README and sampled source files.

Main entry points: [`src/main.rs`](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/main.rs) (Bevy app setup), [`src/menus/mod.rs`](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/mod.rs) (Menu states), [`src/screens/mod.rs`](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/mod.rs) (Screen states), [`src/asset_tracking.rs`](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/asset_tracking.rs) (Asset tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_app["Bevy app setup<br/>[main.rs]"]
  node_devtools["Dev tools<br/>[dev_tools.rs]"]
end

subgraph group_screens["Screens and menus"]
  node_screens["Screen states<br/>[mod.rs]"]
  node_splash["Splash screen<br/>[splash.rs]"]
  node_title["Title screen<br/>[title.rs]"]
  node_loading["Loading screen<br/>[loading.rs]"]
  node_gameplay["Gameplay screen<br/>[gameplay.rs]"]
  node_menus["Menu states<br/>[mod.rs]"]
  node_mainmenu["Main menu<br/>[main.rs]"]
  node_pause["Pause menu<br/>[pause.rs]"]
  node_settings["Settings menu<br/>[settings.rs]"]
  node_credits["Credits menu<br/>[credits.rs]"]
end

subgraph group_game["Demo gameplay"]
  node_demo["Demo mechanics"]
end

subgraph group_ui["UI and theme"]
  node_widgets["UI widgets<br/>[widget.rs]"]
  node_interaction["Widget interactions<br/>[interaction.rs]"]
  node_palette["UI palette<br/>[palette.rs]"]
end

subgraph group_services["Assets and audio"]
  node_assettracking["Asset tracking<br/>[asset_tracking.rs]"]
  node_audio["Audio helpers<br/>[audio.rs]"]
end

node_player(("Player"))
node_assetserver[("Bevy asset server")]

node_player -->|"starts"| node_app
node_app -->|"registers"| node_screens
node_app -->|"registers"| node_menus
node_app -->|"registers"| node_demo
node_app -->|"registers"| node_assettracking
node_app -->|"registers"| node_audio
node_app -->|"registers"| node_devtools
node_app -->|"initializes"| node_screens
node_app -->|"initializes"| node_menus
node_screens -->|"registers"| node_splash
node_screens -->|"registers"| node_title
node_screens -->|"registers"| node_loading
node_screens -->|"registers"| node_gameplay
node_menus -->|"registers"| node_mainmenu
node_menus -->|"registers"| node_pause
node_menus -->|"registers"| node_settings
node_menus -->|"registers"| node_credits
node_splash -->|"advances state"| node_screens
node_mainmenu -->|"chooses screen"| node_screens
node_mainmenu -->|"checks readiness"| node_assettracking
node_mainmenu -->|"opens menus"| node_menus
node_title -->|"uses menu state"| node_menus
node_gameplay -->|"uses level"| node_demo
node_loading -->|"uses handles"| node_assettracking
node_menus -.->|"uses widgets"| node_widgets
node_settings -->|"sets volume"| node_audio
node_credits -->|"starts music"| node_audio
node_credits -->|"loads music"| node_assettracking
node_widgets -->|"adds palette"| node_interaction
node_widgets -->|"uses colors"| node_palette
node_interaction -->|"loads sound assets"| node_assettracking
node_interaction -->|"spawns effects"| node_audio
node_assettracking -->|"loads assets"| node_assetserver
node_devtools -->|"uses screen state"| node_screens

click node_app "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/main.rs"
click node_screens "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/mod.rs"
click node_splash "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/splash.rs"
click node_title "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/title.rs"
click node_loading "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/loading.rs"
click node_gameplay "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/gameplay.rs"
click node_menus "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/mod.rs"
click node_mainmenu "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/main.rs"
click node_pause "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/pause.rs"
click node_settings "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/settings.rs"
click node_credits "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/credits.rs"
click node_demo "https://github.com/thebevyflock/bevy_new_2d/tree/main/src/demo"
click node_widgets "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/theme/widget.rs"
click node_interaction "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/theme/interaction.rs"
click node_palette "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/theme/palette.rs"
click node_assettracking "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/asset_tracking.rs"
click node_audio "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/audio.rs"
click node_devtools "https://github.com/thebevyflock/bevy_new_2d/blob/main/src/dev_tools.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_devtools toneBlue
class node_screens,node_splash,node_title,node_loading,node_gameplay,node_menus,node_mainmenu,node_pause,node_settings,node_credits,node_assetserver toneAmber
class node_demo toneMint
class node_widgets,node_interaction,node_palette toneRose
class node_assettracking,node_audio,node_player toneIndigo
```

## Components

### App runtime

- [Bevy app setup](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/main.rs): `src/main.rs`
- [Dev tools](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/dev_tools.rs): `src/dev_tools.rs`

### Screens and menus

- [Screen states](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/mod.rs): `src/screens/mod.rs`
- [Splash screen](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/splash.rs): `src/screens/splash.rs`
- [Title screen](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/title.rs): `src/screens/title.rs`
- [Loading screen](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/loading.rs): `src/screens/loading.rs`
- [Gameplay screen](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/screens/gameplay.rs): `src/screens/gameplay.rs`
- [Menu states](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/mod.rs): `src/menus/mod.rs`
- [Main menu](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/main.rs): `src/menus/main.rs`
- [Pause menu](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/pause.rs): `src/menus/pause.rs`
- [Settings menu](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/settings.rs): `src/menus/settings.rs`
- [Credits menu](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/menus/credits.rs): `src/menus/credits.rs`

### Demo gameplay

- [Demo mechanics](https://github.com/thebevyflock/bevy_new_2d/tree/main/src/demo): `src/demo`

### UI and theme

- [UI widgets](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/theme/widget.rs): `src/theme/widget.rs`
- [Widget interactions](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/theme/interaction.rs): `src/theme/interaction.rs`
- [UI palette](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/theme/palette.rs): `src/theme/palette.rs`

### Assets and audio

- [Asset tracking](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/asset_tracking.rs): `src/asset_tracking.rs`
- [Audio helpers](https://github.com/thebevyflock/bevy_new_2d/blob/main/src/audio.rs): `src/audio.rs`

### Other components

- **Player**
- **Bevy asset server**

## Connections

- Player → Bevy app setup: starts (evidence: `README.md`)
- Bevy app setup → Screen states: registers (evidence: `src/main.rs`)
- Bevy app setup → Menu states: registers (evidence: `src/main.rs`)
- Bevy app setup → Demo mechanics: registers (evidence: `src/main.rs`)
- Bevy app setup → Asset tracking: registers (evidence: `src/main.rs`)
- Bevy app setup → Audio helpers: registers (evidence: `src/main.rs`)
- Bevy app setup → Dev tools: registers (evidence: `src/main.rs`)
- Bevy app setup → Screen states: initializes (evidence: `src/screens/mod.rs`)
- Bevy app setup → Menu states: initializes (evidence: `src/menus/mod.rs`)
- Screen states → Splash screen: registers (evidence: `src/screens/mod.rs`)
- Screen states → Title screen: registers (evidence: `src/screens/mod.rs`)
- Screen states → Loading screen: registers (evidence: `src/screens/mod.rs`)
- Screen states → Gameplay screen: registers (evidence: `src/screens/mod.rs`)
- Menu states → Main menu: registers (evidence: `src/menus/mod.rs`)
- Menu states → Pause menu: registers (evidence: `src/menus/mod.rs`)
- Menu states → Settings menu: registers (evidence: `src/menus/mod.rs`)
- Menu states → Credits menu: registers (evidence: `src/menus/mod.rs`)
- Splash screen → Screen states: advances state (evidence: `src/screens/splash.rs`)
- Main menu → Screen states: chooses screen (evidence: `src/menus/main.rs`)
- Main menu → Asset tracking: checks readiness (evidence: `src/menus/main.rs`)
- Main menu → Menu states: opens menus (evidence: `src/menus/main.rs`)
- Title screen → Menu states: uses menu state (evidence: `src/screens/title.rs`)
- Gameplay screen → Demo mechanics: uses level (evidence: `src/screens/gameplay.rs`)
- Loading screen → Asset tracking: uses handles (evidence: `src/screens/loading.rs`)
- Menu states → UI widgets: uses widgets
- Settings menu → Audio helpers: sets volume (evidence: `src/menus/settings.rs`)
- Credits menu → Audio helpers: starts music (evidence: `src/menus/credits.rs`)
- Credits menu → Asset tracking: loads music (evidence: `src/menus/credits.rs`)
- UI widgets → Widget interactions: adds palette (evidence: `src/theme/widget.rs`)
- UI widgets → UI palette: uses colors (evidence: `src/theme/widget.rs`)
- Widget interactions → Asset tracking: loads sound assets (evidence: `src/theme/interaction.rs`)
- Widget interactions → Audio helpers: spawns effects (evidence: `src/theme/interaction.rs`)
- Asset tracking → Bevy asset server: loads assets (evidence: `src/asset_tracking.rs`)
- Dev tools → Screen states: uses screen state (evidence: `src/dev_tools.rs`)
