# awesomefreak327/chrona architecture

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

- Interactive diagram: https://gitdiagram.com/awesomefreak327/chrona
- Repository: https://github.com/awesomefreak327/chrona

## Overview

Chrona is a vanilla browser-based institutional display: an operator configures a presentation, previews it, and opens a projector display; a separate stage monitor can synchronize over BroadcastChannel. The README documents configuration, persistence, themes, fonts, timer, announcements, watermark animation, and weather as major capabilities. Source excerpts were unavailable, so relationships below are limited to those explicitly documented in the README.

Main entry points: [`assets/js/settings.js`](https://github.com/awesomefreak327/chrona/blob/main/assets/js/settings.js) (Settings Logic), [`assets/js/display.js`](https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js) (Display Runtime), [`assets/js/config.js`](https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js) (Configuration), [`index.html`](https://github.com/awesomefreak327/chrona/blob/main/index.html) (Settings Panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control and Configuration"]
  node_settings_page["Settings Panel<br/>[index.html]"]
  node_settings_logic["Settings Logic<br/>[settings.js]"]
  node_settings_style["Settings Styling<br/>[settings.css]"]
  node_preview["Preview Frame<br/>[index.html]"]
end

subgraph group_presentation["Display Presentation"]
  node_display_page["Projector Display<br/>[display.html]"]
  node_display_logic["Display Runtime<br/>[display.js]"]
  node_display_style["Display Styling<br/>[display.css]"]
  node_watermark["Watermark Animation<br/>[watermark.js]"]
  node_clock["Clock<br/>[display.js]"]
  node_timer["Timer<br/>[display.js]"]
  node_announcement["Announcement Overlay<br/>[display.js]"]
  node_weather["Weather"]
end

subgraph group_stage["Stage Monitoring"]
  node_presenter_page["Stage Monitor<br/>[presenter.html]"]
  node_presenter_logic["Stage Monitor Runtime<br/>[presenter.html]"]
end

subgraph group_shared["Shared Services"]
  node_config["Configuration<br/>[config.js]"]
  node_history["History<br/>[config.js]"]
  node_announcements["Announcement Library<br/>[config.js]"]
  node_themes_fonts["Themes and Fonts<br/>[config.js]"]
  node_local_storage[("Browser Storage")]
  node_broadcast["BroadcastChannel"]
end

node_operator(("Operator"))
node_weather_services["Weather APIs"]

node_operator -->|"configures"| node_settings_page
node_settings_page -->|"runs"| node_settings_logic
node_settings_page -->|"embeds"| node_preview
node_preview -->|"loads"| node_display_page
node_settings_page -->|"opens popup"| node_display_page
node_settings_logic -->|"sends preview"| node_display_logic
node_settings_logic -->|"broadcasts"| node_broadcast
node_display_logic -->|"receives"| node_broadcast
node_presenter_logic -->|"synchronizes"| node_broadcast
node_settings_logic -->|"updates"| node_config
node_config -->|"persists"| node_local_storage
node_config -->|"provides"| node_history
node_config -->|"provides"| node_announcements
node_config -->|"provides"| node_themes_fonts
node_display_logic -->|"renders"| node_clock
node_display_logic -->|"updates"| node_timer
node_display_logic -->|"shows"| node_announcement
node_display_logic -->|"controls"| node_watermark
node_settings_logic -->|"configures"| node_weather
node_weather -->|"requests data"| node_weather_services
node_settings_logic -->|"opens"| node_presenter_page
node_settings_logic -->|"sends timer state"| node_display_logic

click node_settings_page "https://github.com/awesomefreak327/chrona/blob/main/index.html"
click node_settings_logic "https://github.com/awesomefreak327/chrona/blob/main/assets/js/settings.js"
click node_settings_style "https://github.com/awesomefreak327/chrona/blob/main/assets/css/settings.css"
click node_preview "https://github.com/awesomefreak327/chrona/blob/main/index.html"
click node_display_page "https://github.com/awesomefreak327/chrona/blob/main/display.html"
click node_display_logic "https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js"
click node_display_style "https://github.com/awesomefreak327/chrona/blob/main/assets/css/display.css"
click node_watermark "https://github.com/awesomefreak327/chrona/blob/main/assets/js/watermark.js"
click node_clock "https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js"
click node_timer "https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js"
click node_announcement "https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js"
click node_weather "https://github.com/awesomefreak327/chrona/tree/main/assets/js"
click node_presenter_page "https://github.com/awesomefreak327/chrona/blob/main/presenter.html"
click node_presenter_logic "https://github.com/awesomefreak327/chrona/blob/main/presenter.html"
click node_config "https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js"
click node_history "https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js"
click node_announcements "https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js"
click node_themes_fonts "https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js"

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_settings_page,node_settings_logic,node_settings_style,node_preview toneBlue
class node_display_page,node_display_logic,node_display_style,node_watermark,node_clock,node_timer,node_announcement,node_weather toneAmber
class node_presenter_page,node_presenter_logic,node_weather_services toneMint
class node_config,node_history,node_announcements,node_themes_fonts,node_local_storage,node_broadcast toneRose
class node_operator toneIndigo
```

## Components

### Control and Configuration

- [Settings Panel](https://github.com/awesomefreak327/chrona/blob/main/index.html): `index.html`
- [Settings Logic](https://github.com/awesomefreak327/chrona/blob/main/assets/js/settings.js): `assets/js/settings.js`
- [Settings Styling](https://github.com/awesomefreak327/chrona/blob/main/assets/css/settings.css): `assets/css/settings.css`
- [Preview Frame](https://github.com/awesomefreak327/chrona/blob/main/index.html): `index.html`

### Display Presentation

- [Projector Display](https://github.com/awesomefreak327/chrona/blob/main/display.html): `display.html`
- [Display Runtime](https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js): `assets/js/display.js`
- [Display Styling](https://github.com/awesomefreak327/chrona/blob/main/assets/css/display.css): `assets/css/display.css`
- [Watermark Animation](https://github.com/awesomefreak327/chrona/blob/main/assets/js/watermark.js): `assets/js/watermark.js`
- [Clock](https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js): `assets/js/display.js`
- [Timer](https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js): `assets/js/display.js`
- [Announcement Overlay](https://github.com/awesomefreak327/chrona/blob/main/assets/js/display.js): `assets/js/display.js`
- [Weather](https://github.com/awesomefreak327/chrona/tree/main/assets/js): `assets/js`

### Stage Monitoring

- [Stage Monitor](https://github.com/awesomefreak327/chrona/blob/main/presenter.html): `presenter.html`
- [Stage Monitor Runtime](https://github.com/awesomefreak327/chrona/blob/main/presenter.html): `presenter.html`

### Shared Services

- [Configuration](https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js): `assets/js/config.js`
- [History](https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js): `assets/js/config.js`
- [Announcement Library](https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js): `assets/js/config.js`
- [Themes and Fonts](https://github.com/awesomefreak327/chrona/blob/main/assets/js/config.js): `assets/js/config.js`
- **Browser Storage**
- **BroadcastChannel**

### Other components

- **Operator**
- **Weather APIs**

## Connections

- Operator → Settings Panel: configures (evidence: `README.md`)
- Settings Panel → Settings Logic: runs (evidence: `README.md`)
- Settings Panel → Preview Frame: embeds (evidence: `README.md`)
- Preview Frame → Projector Display: loads (evidence: `README.md`)
- Settings Panel → Projector Display: opens popup (evidence: `README.md`)
- Settings Logic → Display Runtime: sends preview (evidence: `README.md`)
- Settings Logic → BroadcastChannel: broadcasts (evidence: `README.md`)
- Display Runtime → BroadcastChannel: receives (evidence: `README.md`)
- Stage Monitor Runtime → BroadcastChannel: synchronizes (evidence: `README.md`)
- Settings Logic → Configuration: updates (evidence: `README.md`)
- Configuration → Browser Storage: persists (evidence: `README.md`)
- Configuration → History: provides (evidence: `README.md`)
- Configuration → Announcement Library: provides (evidence: `README.md`)
- Configuration → Themes and Fonts: provides (evidence: `README.md`)
- Display Runtime → Clock: renders (evidence: `README.md`)
- Display Runtime → Timer: updates (evidence: `README.md`)
- Display Runtime → Announcement Overlay: shows (evidence: `README.md`)
- Display Runtime → Watermark Animation: controls (evidence: `README.md`)
- Settings Logic → Weather: configures (evidence: `README.md`)
- Weather → Weather APIs: requests data (evidence: `README.md`)
- Settings Logic → Stage Monitor: opens (evidence: `README.md`)
- Settings Logic → Display Runtime: sends timer state (evidence: `README.md`)
