# davidfernandodev/obsignals architecture

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

## Overview

Obsignals is a browser-based trading-signals dashboard. Users view incoming signals and a countdown, choose a signal timeframe and timezone, and can open help content or visit broker links. The sampled source shows the WebSocket-backed signal state and its UI consumers; the README provides no additional product capabilities. Some implementation details are omitted because several source excerpts are partial.

Main entry points: [`src/App.js`](https://github.com/davidfernandodev/obsignals/blob/main/src/App.js) (App Shell), [`src/components/Menu.js`](https://github.com/davidfernandodev/obsignals/blob/main/src/components/Menu.js) (Settings Menu), [`src/context/webSocketContext.jsx`](https://github.com/davidfernandodev/obsignals/blob/main/src/context/webSocketContext.jsx) (Signal State And Feed), [`src/context/modalContext.jsx`](https://github.com/davidfernandodev/obsignals/blob/main/src/context/modalContext.jsx) (Help Modal State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Dashboard"]
  node_app["App Shell<br/>[App.js]"]
end

subgraph group_signals["Signal Feed"]
  node_signal_context["Signal State And Feed"]
  node_signal_service["Signal WebSocket"]
  node_card_list["Signal List<br/>[ListCards.js]"]
  node_signal_card["Signal Card<br/>[Card.js]"]
  node_countdown["Next Signal Clock<br/>[DigitalClock.js]"]
end

subgraph group_settings["Time Settings"]
  node_menu["Settings Menu<br/>[Menu.js]"]
  node_timezone_options["Timezone Options<br/>[utcs.js]"]
  node_date_format["Date Formatter<br/>[useFormatDate.js]"]
  node_timezone_default["Timezone Default"]
  node_utc_default["UTC Default<br/>[setUtcDefault.js]"]
end

subgraph group_support["Help And Brokers"]
  node_modal_state["Help Modal State<br/>[modalContext.jsx]"]
  node_modal["Help Modal<br/>[Modal.js]"]
  node_brokers["Broker Links<br/>[App.js]"]
end

node_user(("Dashboard User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_card_list
node_app -->|"renders"| node_countdown
node_app -->|"renders"| node_menu
node_app -->|"renders"| node_modal
node_app -->|"reads"| node_modal_state
node_app -->|"sets default"| node_timezone_default
node_app -->|"sets default"| node_utc_default
node_app -->|"displays"| node_brokers
node_signal_context -->|"connects to"| node_signal_service
node_card_list -->|"renders"| node_signal_card
node_signal_card -->|"reads state"| node_signal_context
node_countdown -->|"reads state"| node_signal_context
node_menu -->|"changes timeframe"| node_signal_context
node_menu -->|"lists options"| node_timezone_options
node_menu -->|"formats time"| node_date_format
node_signal_context -->|"formats time"| node_date_format
node_modal -->|"closes via"| node_modal_state
node_user -->|"configures"| node_menu
node_user -->|"opens help"| node_modal_state

click node_app "https://github.com/davidfernandodev/obsignals/blob/main/src/App.js"
click node_signal_context "https://github.com/davidfernandodev/obsignals/blob/main/src/context/webSocketContext.jsx"
click node_card_list "https://github.com/davidfernandodev/obsignals/blob/main/src/components/ListCards.js"
click node_signal_card "https://github.com/davidfernandodev/obsignals/blob/main/src/components/Card.js"
click node_countdown "https://github.com/davidfernandodev/obsignals/blob/main/src/components/DigitalClock.js"
click node_menu "https://github.com/davidfernandodev/obsignals/blob/main/src/components/Menu.js"
click node_timezone_options "https://github.com/davidfernandodev/obsignals/blob/main/src/utils/utcs.js"
click node_date_format "https://github.com/davidfernandodev/obsignals/blob/main/src/hooks/useFormatDate.js"
click node_timezone_default "https://github.com/davidfernandodev/obsignals/blob/main/src/utils/setTimezoneDefault.js"
click node_utc_default "https://github.com/davidfernandodev/obsignals/blob/main/src/utils/setUtcDefault.js"
click node_modal_state "https://github.com/davidfernandodev/obsignals/blob/main/src/context/modalContext.jsx"
click node_modal "https://github.com/davidfernandodev/obsignals/blob/main/src/components/Modal.js"
click node_brokers "https://github.com/davidfernandodev/obsignals/blob/main/src/App.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_app,node_user toneBlue
class node_signal_context,node_signal_service,node_card_list,node_signal_card,node_countdown toneAmber
class node_menu,node_timezone_options,node_date_format,node_timezone_default,node_utc_default toneMint
class node_modal_state,node_modal,node_brokers toneRose
```

## Components

### Dashboard

- [App Shell](https://github.com/davidfernandodev/obsignals/blob/main/src/App.js): `src/App.js`

### Signal Feed

- [Signal State And Feed](https://github.com/davidfernandodev/obsignals/blob/main/src/context/webSocketContext.jsx): `src/context/webSocketContext.jsx`
- **Signal WebSocket**
- [Signal List](https://github.com/davidfernandodev/obsignals/blob/main/src/components/ListCards.js): `src/components/ListCards.js`
- [Signal Card](https://github.com/davidfernandodev/obsignals/blob/main/src/components/Card.js): `src/components/Card.js`
- [Next Signal Clock](https://github.com/davidfernandodev/obsignals/blob/main/src/components/DigitalClock.js): `src/components/DigitalClock.js`

### Time Settings

- [Settings Menu](https://github.com/davidfernandodev/obsignals/blob/main/src/components/Menu.js): `src/components/Menu.js`
- [Timezone Options](https://github.com/davidfernandodev/obsignals/blob/main/src/utils/utcs.js): `src/utils/utcs.js`
- [Date Formatter](https://github.com/davidfernandodev/obsignals/blob/main/src/hooks/useFormatDate.js): `src/hooks/useFormatDate.js`
- [Timezone Default](https://github.com/davidfernandodev/obsignals/blob/main/src/utils/setTimezoneDefault.js): `src/utils/setTimezoneDefault.js`
- [UTC Default](https://github.com/davidfernandodev/obsignals/blob/main/src/utils/setUtcDefault.js): `src/utils/setUtcDefault.js`

### Help And Brokers

- [Help Modal State](https://github.com/davidfernandodev/obsignals/blob/main/src/context/modalContext.jsx): `src/context/modalContext.jsx`
- [Help Modal](https://github.com/davidfernandodev/obsignals/blob/main/src/components/Modal.js): `src/components/Modal.js`
- [Broker Links](https://github.com/davidfernandodev/obsignals/blob/main/src/App.js): `src/App.js`

### Other components

- **Dashboard User**

## Connections

- Dashboard User → App Shell: uses (evidence: `src/App.js`)
- App Shell → Signal List: renders (evidence: `src/App.js`)
- App Shell → Next Signal Clock: renders (evidence: `src/App.js`)
- App Shell → Settings Menu: renders (evidence: `src/App.js`)
- App Shell → Help Modal: renders (evidence: `src/App.js`)
- App Shell → Help Modal State: reads (evidence: `src/App.js`)
- App Shell → Timezone Default: sets default (evidence: `src/App.js`)
- App Shell → UTC Default: sets default (evidence: `src/App.js`)
- App Shell → Broker Links: displays (evidence: `src/App.js`)
- Signal State And Feed → Signal WebSocket: connects to (evidence: `src/context/webSocketContext.jsx`)
- Signal List → Signal Card: renders (evidence: `src/components/ListCards.js`)
- Signal Card → Signal State And Feed: reads state (evidence: `src/components/Card.js`)
- Next Signal Clock → Signal State And Feed: reads state (evidence: `src/components/DigitalClock.js`)
- Settings Menu → Signal State And Feed: changes timeframe (evidence: `src/components/Menu.js`)
- Settings Menu → Timezone Options: lists options (evidence: `src/components/Menu.js`)
- Settings Menu → Date Formatter: formats time (evidence: `src/components/Menu.js`)
- Signal State And Feed → Date Formatter: formats time (evidence: `src/context/webSocketContext.jsx`)
- Help Modal → Help Modal State: closes via (evidence: `src/components/Modal.js`)
- Dashboard User → Settings Menu: configures (evidence: `src/components/Menu.js`)
- Dashboard User → Help Modal State: opens help
