# chasingimagines/eventboaard architecture

> Architecture diagram of the GitHub repository chasingimagines/eventboaard, 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/chasingimagines/eventboaard
- Repository: https://github.com/chasingimagines/eventboaard

## Overview

EventBoard is a Unity ScriptableObject event bus and in-memory blackboard. Users define typed channels in EventBoardGroup assets, select them through Inspector tooling, and access them with EventKey<T>; at runtime, EventBoardManager loads groups into the central EventBoard, which dispatches events and retains channel state. The editor also provides channel authoring, selection, and a live Hub. Edges are limited to README statements and shown source references/calls; unsampled implementation details are not inferred.

Main entry points: [`Runtime/EventBoardGroup.cs`](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoardGroup.cs) (Channel Groups), [`Runtime/EventBoard.cs`](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoard.cs) (EventBoard Engine), [`Runtime/EventKey.cs`](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventKey.cs) (Typed Event Key), [`Editor/EventBoardGroupEditor.cs`](https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventBoardGroupEditor.cs) (Group Editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Channel Authoring"]
  node_group_assets[("Channel Groups<br/>[EventBoardGroup.cs]")]
  node_payloads["Typed Payloads"]
end

subgraph group_editor["Editor Tools"]
  node_group_editor["Group Editor"]
  node_key_drawer["Key Inspector<br/>[EventKeyDrawer.cs]"]
  node_key_dropdown["Channel Dropdown"]
  node_hub["Hub Window"]
end

subgraph group_runtime["Runtime Channels"]
  node_manager["Runtime Manager"]
  node_event_key["Typed Event Key<br/>[EventKey.cs]"]
  node_void_signal["Void Signal<br/>[VoidSignal.cs]"]
end

subgraph group_engine["Event Engine"]
  node_event_board["EventBoard Engine<br/>[EventBoard.cs]"]
  node_channel_slot["Channel State"]
end

node_developer(("Unity Developer"))
node_gameplay["Gameplay Code"]

node_developer -->|"authors channels"| node_group_editor
node_group_editor -->|"edits groups"| node_group_assets
node_group_editor -->|"hydrates changes"| node_event_board
node_developer -->|"selects channels"| node_key_drawer
node_key_drawer -->|"lists groups"| node_group_assets
node_key_drawer -->|"opens selector"| node_key_dropdown
node_key_dropdown -->|"filters channels"| node_group_assets
node_developer -->|"inspects channels"| node_hub
node_hub -->|"reads and publishes"| node_event_board
node_hub -->|"finds channel metadata"| node_group_assets
node_manager -->|"loads groups"| node_group_assets
node_manager -->|"hydrates groups"| node_event_board
node_group_assets -->|"defines channel types"| node_payloads
node_payloads -->|"configures channels"| node_event_board
node_gameplay -->|"publishes and subscribes"| node_event_key
node_event_key -->|"resolves channel"| node_event_board
node_event_key -->|"uses cached slot"| node_channel_slot
node_void_signal -->|"publishes signal"| node_event_key
node_event_board -->|"creates and dispatches"| node_channel_slot

click node_group_assets "https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoardGroup.cs"
click node_payloads "https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoardPayload.cs"
click node_group_editor "https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventBoardGroupEditor.cs"
click node_key_drawer "https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventKeyDrawer.cs"
click node_key_dropdown "https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventKeyDropdown.cs"
click node_hub "https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventBoardWindow.cs"
click node_manager "https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoardManager.cs"
click node_event_key "https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventKey.cs"
click node_void_signal "https://github.com/chasingimagines/eventboaard/blob/master/Runtime/VoidSignal.cs"
click node_event_board "https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoard.cs"
click node_channel_slot "https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventChannelSlot.cs"

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_group_assets,node_payloads toneBlue
class node_group_editor,node_key_drawer,node_key_dropdown,node_hub toneAmber
class node_manager,node_event_key,node_void_signal toneMint
class node_event_board,node_channel_slot toneRose
class node_developer,node_gameplay toneIndigo
```

## Components

### Channel Authoring

- [Channel Groups](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoardGroup.cs): `Runtime/EventBoardGroup.cs`
- [Typed Payloads](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoardPayload.cs): `Runtime/EventBoardPayload.cs`

### Editor Tools

- [Group Editor](https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventBoardGroupEditor.cs): `Editor/EventBoardGroupEditor.cs`
- [Key Inspector](https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventKeyDrawer.cs): `Editor/EventKeyDrawer.cs`
- [Channel Dropdown](https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventKeyDropdown.cs): `Editor/EventKeyDropdown.cs`
- [Hub Window](https://github.com/chasingimagines/eventboaard/blob/master/Editor/EventBoardWindow.cs): `Editor/EventBoardWindow.cs`

### Runtime Channels

- [Runtime Manager](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoardManager.cs): `Runtime/EventBoardManager.cs`
- [Typed Event Key](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventKey.cs): `Runtime/EventKey.cs`
- [Void Signal](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/VoidSignal.cs): `Runtime/VoidSignal.cs`

### Event Engine

- [EventBoard Engine](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventBoard.cs): `Runtime/EventBoard.cs`
- [Channel State](https://github.com/chasingimagines/eventboaard/blob/master/Runtime/EventChannelSlot.cs): `Runtime/EventChannelSlot.cs`

### Other components

- **Unity Developer**
- **Gameplay Code**

## Connections

- Unity Developer → Group Editor: authors channels (evidence: `README.md`)
- Group Editor → Channel Groups: edits groups (evidence: `Editor/EventBoardGroupEditor.cs`)
- Group Editor → EventBoard Engine: hydrates changes (evidence: `Editor/EventBoardGroupEditor.cs`)
- Unity Developer → Key Inspector: selects channels (evidence: `README.md`)
- Key Inspector → Channel Groups: lists groups (evidence: `Editor/EventKeyDrawer.cs`)
- Key Inspector → Channel Dropdown: opens selector (evidence: `Editor/EventKeyDrawer.cs`)
- Channel Dropdown → Channel Groups: filters channels (evidence: `Editor/EventKeyDropdown.cs`)
- Unity Developer → Hub Window: inspects channels (evidence: `README.md`)
- Hub Window → EventBoard Engine: reads and publishes (evidence: `Editor/EventBoardWindow.cs`)
- Hub Window → Channel Groups: finds channel metadata (evidence: `Editor/EventBoardWindow.cs`)
- Runtime Manager → Channel Groups: loads groups (evidence: `Runtime/EventBoardManager.cs`)
- Runtime Manager → EventBoard Engine: hydrates groups (evidence: `Runtime/EventBoardManager.cs`)
- Channel Groups → Typed Payloads: defines channel types (evidence: `README.md`)
- Typed Payloads → EventBoard Engine: configures channels (evidence: `Runtime/EventBoardPayload.cs`)
- Gameplay Code → Typed Event Key: publishes and subscribes (evidence: `README.md`)
- Typed Event Key → EventBoard Engine: resolves channel (evidence: `Runtime/EventKey.cs`)
- Typed Event Key → Channel State: uses cached slot (evidence: `Runtime/EventKey.cs`)
- Void Signal → Typed Event Key: publishes signal (evidence: `Runtime/VoidSignal.cs`)
- EventBoard Engine → Channel State: creates and dispatches (evidence: `Runtime/EventBoard.cs`)
