# ramanathanapa/my-mind-map architecture

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

- Interactive diagram: https://gitdiagram.com/ramanathanapa/my-mind-map
- Repository: https://github.com/ramanathanapa/my-mind-map

## Overview

My Mind Map is a local, browser-based mind-map editor backed by DuckDB. A user opens the served UI, edits a map, and changes auto-save through the server to the database; maps can later be reopened or exported. The frontend is a single substantial JavaScript module, so editing, navigation, map management, and import/export are represented as responsibilities within that module rather than as separate services. The README documents the major UI capabilities; the excerpts do not show all frontend wiring.

Main entry points: [`static/app.js`](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js) (Mind map editor), [`server.py`](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/server.py) (Map API routes), [`static/index.html`](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/index.html) (Web UI assets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser editor"]
  node_editor["Mind map editor<br/>[app.js]"]
  node_editing["Node editing<br/>[app.js]"]
  node_navigation["Layout and navigation<br/>[app.js]"]
  node_maps["Map management<br/>[app.js]"]
  node_interchange["Import and export<br/>[app.js]"]
  node_ui_assets["Web UI assets<br/>[index.html]"]
end

subgraph group_server["Local server"]
  node_http_server["HTTP server<br/>[server.py]"]
  node_map_api["Map API routes<br/>[server.py]"]
end

subgraph group_storage["Map storage"]
  node_store["Map persistence<br/>[server.py]"]
  node_duckdb[("DuckDB database")]
end

node_user(("Map user"))

node_user -->|"uses"| node_editor
node_editor -->|"provides"| node_editing
node_editor -->|"provides"| node_navigation
node_editor -->|"provides"| node_maps
node_editor -->|"provides"| node_interchange
node_http_server -->|"serves"| node_ui_assets
node_editor -->|"requests maps"| node_map_api
node_map_api -->|"dispatches map operations"| node_store
node_store -->|"reads and writes"| node_duckdb

click node_editor "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js"
click node_editing "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js"
click node_navigation "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js"
click node_maps "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js"
click node_interchange "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js"
click node_ui_assets "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/index.html"
click node_http_server "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/server.py"
click node_map_api "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/server.py"
click node_store "https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/server.py"

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_editor,node_editing,node_navigation,node_maps,node_interchange,node_ui_assets,node_user toneBlue
class node_http_server,node_map_api toneAmber
class node_store,node_duckdb toneMint
```

## Components

### Browser editor

- [Mind map editor](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js): `static/app.js`
- [Node editing](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js): `static/app.js`
- [Layout and navigation](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js): `static/app.js`
- [Map management](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js): `static/app.js`
- [Import and export](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/app.js): `static/app.js`
- [Web UI assets](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/static/index.html): `static/index.html`

### Local server

- [HTTP server](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/server.py): `server.py`
- [Map API routes](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/server.py): `server.py`

### Map storage

- [Map persistence](https://github.com/ramanathanapa/my-mind-map/blob/claude/inspiring-gates-8h0qfw/server.py): `server.py`
- **DuckDB database**

### Other components

- **Map user**

## Connections

- Map user → Mind map editor: uses (evidence: `README.md`)
- Mind map editor → Node editing: provides (evidence: `README.md`)
- Mind map editor → Layout and navigation: provides (evidence: `README.md`)
- Mind map editor → Map management: provides (evidence: `README.md`)
- Mind map editor → Import and export: provides (evidence: `README.md`)
- HTTP server → Web UI assets: serves (evidence: `server.py`)
- Mind map editor → Map API routes: requests maps (evidence: `README.md`)
- Map API routes → Map persistence: dispatches map operations (evidence: `server.py`)
- Map persistence → DuckDB database: reads and writes (evidence: `server.py`)
