# hanhan758/talos-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/hanhan758/talos-dashboard
- Repository: https://github.com/hanhan758/talos-dashboard

## Overview

TALOS Dashboard is a static, single-file Obsidian knowledge-work dashboard with an optional Python refresh script. The main workflow is to open its Homepage note in Obsidian, render the dashboard in an iframe, and browse dashboard sections; clicks are bridged back to Obsidian for note or file opening. The refresh script scans a vault and writes summary data into the dashboard HTML. Dashboard internals are documented in the README, but its source was not sampled, so finer-grained implementation links are omitted.

Main entry points: [`dashboard.html`](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html) (Dashboard UI), [`homepage.md`](https://github.com/hanhan758/talos-dashboard/blob/main/homepage.md) (Homepage note), [`refresh-dashboard.py`](https://github.com/hanhan758/talos-dashboard/blob/main/refresh-dashboard.py) (Vault scanner), [`talos-dashboard-home.css`](https://github.com/hanhan758/talos-dashboard/blob/main/talos-dashboard-home.css) (Dashboard styling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Obsidian integration"]
  node_homepage["Homepage note<br/>[homepage.md]"]
end

subgraph group_dashboard["Dashboard experience"]
  node_dashboard["Dashboard UI<br/>[dashboard.html]"]
  node_theme["Dashboard styling"]
  node_overview["Stats overview<br/>[dashboard.html]"]
  node_projects["Project cards<br/>[dashboard.html]"]
  node_commands["Commands and memo<br/>[dashboard.html]"]
  node_sidebar["Sidebar tools<br/>[dashboard.html]"]
  node_visuals["Motion and theming<br/>[dashboard.html]"]
end

subgraph group_refresh["Vault data refresh"]
  node_scanner["Vault scanner"]
  node_stats["Stats block<br/>[dashboard.html]"]
end

node_user(("Vault user"))
node_obsidian["Obsidian"]
node_dataview["Dataview plugin"]
node_vault[("Vault files")]

node_user -->|"opens dashboard"| node_obsidian
node_obsidian -->|"opens note"| node_homepage
node_homepage -->|"runs DataviewJS"| node_dataview
node_homepage -->|"embeds srcdoc"| node_dashboard
node_dashboard -->|"uses styles"| node_theme
node_dashboard -->|"renders"| node_overview
node_dashboard -->|"renders"| node_projects
node_dashboard -->|"renders"| node_commands
node_dashboard -->|"renders"| node_sidebar
node_dashboard -->|"uses effects"| node_visuals
node_dashboard -->|"posts click message"| node_homepage
node_homepage -->|"opens linked files"| node_obsidian
node_user -->|"runs refresh"| node_scanner
node_scanner -->|"scans files"| node_vault
node_scanner -->|"writes stats"| node_stats
node_stats -->|"supplies metrics"| node_dashboard

click node_homepage "https://github.com/hanhan758/talos-dashboard/blob/main/homepage.md"
click node_dashboard "https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html"
click node_theme "https://github.com/hanhan758/talos-dashboard/blob/main/talos-dashboard-home.css"
click node_overview "https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html"
click node_projects "https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html"
click node_commands "https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html"
click node_sidebar "https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html"
click node_visuals "https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html"
click node_scanner "https://github.com/hanhan758/talos-dashboard/blob/main/refresh-dashboard.py"
click node_stats "https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html"

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_homepage,node_user,node_dataview toneBlue
class node_dashboard,node_theme,node_overview,node_projects,node_commands,node_sidebar,node_visuals,node_vault toneAmber
class node_scanner,node_stats toneMint
class node_obsidian toneIndigo
```

## Components

### Obsidian integration

- [Homepage note](https://github.com/hanhan758/talos-dashboard/blob/main/homepage.md): `homepage.md`

### Dashboard experience

- [Dashboard UI](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html): `dashboard.html`
- [Dashboard styling](https://github.com/hanhan758/talos-dashboard/blob/main/talos-dashboard-home.css): `talos-dashboard-home.css`
- [Stats overview](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html): `dashboard.html`
- [Project cards](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html): `dashboard.html`
- [Commands and memo](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html): `dashboard.html`
- [Sidebar tools](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html): `dashboard.html`
- [Motion and theming](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html): `dashboard.html`

### Vault data refresh

- [Vault scanner](https://github.com/hanhan758/talos-dashboard/blob/main/refresh-dashboard.py): `refresh-dashboard.py`
- [Stats block](https://github.com/hanhan758/talos-dashboard/blob/main/dashboard.html): `dashboard.html`

### Other components

- **Vault user**
- **Obsidian**
- **Dataview plugin**
- **Vault files**

## Connections

- Vault user → Obsidian: opens dashboard
- Obsidian → Homepage note: opens note
- Homepage note → Dataview plugin: runs DataviewJS
- Homepage note → Dashboard UI: embeds srcdoc
- Dashboard UI → Dashboard styling: uses styles
- Dashboard UI → Stats overview: renders
- Dashboard UI → Project cards: renders
- Dashboard UI → Commands and memo: renders
- Dashboard UI → Sidebar tools: renders
- Dashboard UI → Motion and theming: uses effects
- Dashboard UI → Homepage note: posts click message
- Homepage note → Obsidian: opens linked files
- Vault user → Vault scanner: runs refresh
- Vault scanner → Vault files: scans files
- Vault scanner → Stats block: writes stats
- Stats block → Dashboard UI: supplies metrics