# tasssinclair/diagram-chat architecture

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

- Interactive diagram: https://gitdiagram.com/tasssinclair/diagram-chat
- Repository: https://github.com/tasssinclair/diagram-chat

## Overview

Diagram Chat accepts text and image prompts, streams model responses into a conversation, renders Markdown and supported diagram formats, and displays token metrics. The frontend owns conversation state and submits requests to an Express endpoint; the backend streams OpenRouter output and usage events. Diagram rendering is a distinct presentation stage, with Mermaid, D2, reladraw, and inline SVG support. The API route’s internal details are not excerpted, so its link to the OpenRouter adapter is supported by the source index; other uncertain wiring is omitted.

Main entry points: [`src/components/MarkdownRenderer.tsx`](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MarkdownRenderer.tsx) (Markdown renderer), [`src/App.tsx`](https://github.com/tasssinclair/diagram-chat/blob/main/src/App.tsx) (Conversation app), [`src/components/ChatInput.tsx`](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/ChatInput.tsx) (Chat input), [`src/components/MessageBubble.tsx`](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MessageBubble.tsx) (Message bubbles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversation["Chat experience"]
  node_app["Conversation app<br/>[App.tsx]"]
  node_input["Chat input<br/>[ChatInput.tsx]"]
  node_messages["Message bubbles<br/>[MessageBubble.tsx]"]
  node_metrics["Token metrics<br/>[MetricsPanel.tsx]"]
  node_types["Conversation types<br/>[types.ts]"]
end

subgraph group_rendering["Response rendering"]
  node_markdown["Markdown renderer"]
  node_mermaid["Mermaid renderer<br/>[MermaidBlock.tsx]"]
  node_d2["D2 renderer<br/>[D2Block.tsx]"]
  node_reladraw["Reladraw renderer<br/>[ReladrawBlock.tsx]"]
  node_svg["Inline SVG"]
end

subgraph group_backend["Model service"]
  node_api["Chat API route<br/>[index.ts]"]
  node_adapter["OpenRouter adapter<br/>[openrouter.ts]"]
end

subgraph group_integrations["External services"]
  node_openrouter["OpenRouter"]
end

node_user(("Chat user"))

node_user -->|"enters prompt"| node_input
node_input -->|"submits text/images"| node_app
node_app -->|"posts chat"| node_api
node_api -->|"dispatches request"| node_adapter
node_adapter -->|"streams completion"| node_openrouter
node_app -->|"renders messages"| node_messages
node_app -->|"renders usage"| node_metrics
node_messages -->|"renders content"| node_markdown
node_markdown -->|"renders Mermaid"| node_mermaid
node_markdown -->|"renders D2"| node_d2
node_markdown -->|"renders reladraw"| node_reladraw
node_markdown -->|"embeds SVG"| node_svg

click node_app "https://github.com/tasssinclair/diagram-chat/blob/main/src/App.tsx"
click node_input "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/ChatInput.tsx"
click node_messages "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MessageBubble.tsx"
click node_metrics "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MetricsPanel.tsx"
click node_types "https://github.com/tasssinclair/diagram-chat/blob/main/src/types.ts"
click node_markdown "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MarkdownRenderer.tsx"
click node_mermaid "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MermaidBlock.tsx"
click node_d2 "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/D2Block.tsx"
click node_reladraw "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/ReladrawBlock.tsx"
click node_svg "https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MarkdownRenderer.tsx"
click node_api "https://github.com/tasssinclair/diagram-chat/blob/main/server/index.ts"
click node_adapter "https://github.com/tasssinclair/diagram-chat/blob/main/server/openrouter.ts"

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_input,node_messages,node_metrics,node_types,node_user toneBlue
class node_markdown,node_mermaid,node_d2,node_reladraw,node_svg toneAmber
class node_api,node_adapter toneMint
class node_openrouter toneRose
```

## Components

### Chat experience

- [Conversation app](https://github.com/tasssinclair/diagram-chat/blob/main/src/App.tsx): `src/App.tsx`
- [Chat input](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/ChatInput.tsx): `src/components/ChatInput.tsx`
- [Message bubbles](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MessageBubble.tsx): `src/components/MessageBubble.tsx`
- [Token metrics](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MetricsPanel.tsx): `src/components/MetricsPanel.tsx`
- [Conversation types](https://github.com/tasssinclair/diagram-chat/blob/main/src/types.ts): `src/types.ts`

### Response rendering

- [Markdown renderer](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MarkdownRenderer.tsx): `src/components/MarkdownRenderer.tsx`
- [Mermaid renderer](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MermaidBlock.tsx): `src/components/MermaidBlock.tsx`
- [D2 renderer](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/D2Block.tsx): `src/components/D2Block.tsx`
- [Reladraw renderer](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/ReladrawBlock.tsx): `src/components/ReladrawBlock.tsx`
- [Inline SVG](https://github.com/tasssinclair/diagram-chat/blob/main/src/components/MarkdownRenderer.tsx): `src/components/MarkdownRenderer.tsx`

### Model service

- [Chat API route](https://github.com/tasssinclair/diagram-chat/blob/main/server/index.ts): `server/index.ts`
- [OpenRouter adapter](https://github.com/tasssinclair/diagram-chat/blob/main/server/openrouter.ts): `server/openrouter.ts`

### External services

- **OpenRouter**

### Other components

- **Chat user**

## Connections

- Chat user → Chat input: enters prompt (evidence: `README.md`)
- Chat input → Conversation app: submits text/images (evidence: `src/components/ChatInput.tsx`)
- Conversation app → Chat API route: posts chat (evidence: `src/App.tsx`)
- Chat API route → OpenRouter adapter: dispatches request (evidence: `server/index.ts`)
- OpenRouter adapter → OpenRouter: streams completion (evidence: `server/openrouter.ts`)
- Conversation app → Message bubbles: renders messages (evidence: `src/App.tsx`)
- Conversation app → Token metrics: renders usage (evidence: `src/App.tsx`)
- Message bubbles → Markdown renderer: renders content (evidence: `src/components/MessageBubble.tsx`)
- Markdown renderer → Mermaid renderer: renders Mermaid (evidence: `src/components/MarkdownRenderer.tsx`)
- Markdown renderer → D2 renderer: renders D2 (evidence: `src/components/MarkdownRenderer.tsx`)
- Markdown renderer → Reladraw renderer: renders reladraw (evidence: `src/components/MarkdownRenderer.tsx`)
- Markdown renderer → Inline SVG: embeds SVG (evidence: `src/components/MarkdownRenderer.tsx`)
