# luoluo-121/neural-creator-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/luoluo-121/neural-creator-dashboard
- Repository: https://github.com/luoluo-121/neural-creator-dashboard

## Overview

Neural Creator Dashboard is a browser-based creator workspace. Users bring in Markdown/Obsidian notes or use sample data, then browse works, methods, concepts, ideas, and drafts as a derived graph; they can inspect links and metrics, ask local rule-based questions, and turn ideas into drafts. The graph also powers the animated workspace and analysis views. The source index and excerpts establish the main UI and graph dependencies; import and browser-storage behavior are included from README documentation, not inferred from unsampled implementation.

Main entry points: [`src/neural/main.jsx`](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/main.jsx) (App shell), [`src/neural/graph.js`](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/graph.js) (Graph engine), [`src/data/index.js`](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/data/index.js) (Data selection), [`src/neural/Home.jsx`](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/Home.jsx) (Interactive workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data and graph"]
  node_importer["Note importer<br/>[import-notes.mjs]"]
  node_dataentry["Data selection<br/>[index.js]"]
  node_sample["Sample content<br/>[sample.js]"]
  node_workdata["Works data<br/>[works.js]"]
  node_graph["Graph engine<br/>[graph.js]"]
  node_config["Workspace config<br/>[config.js]"]
end

subgraph group_workspace["Graph workspace"]
  node_home["Interactive workspace<br/>[Home.jsx]"]
  node_canvas["Network canvas<br/>[NetworkCanvas.jsx]"]
  node_analysis["Content analysis<br/>[Analysis.jsx]"]
end

subgraph group_creator["Creator tools"]
  node_works["Works library<br/>[pages.jsx]"]
  node_drafts["Draft editor<br/>[pages.jsx]"]
  node_ideas["Ideas pool<br/>[pages.jsx]"]
end

subgraph group_platform["Presentation"]
  node_app["App shell<br/>[main.jsx]"]
  node_theme["Theme and media<br/>[theme.js]"]
  node_icons["Interface icons<br/>[icons.jsx]"]
end

node_creator(("Creator"))
node_vault[("Markdown vault")]
node_browser[("Browser localStorage")]

node_creator -->|"supplies notes"| node_vault
node_vault -->|"imports from"| node_importer
node_importer -->|"writes imported data"| node_dataentry
node_dataentry -->|"selects sample"| node_sample
node_workdata -->|"reads works"| node_dataentry
node_graph -->|"reads works"| node_workdata
node_graph -->|"reads graph data"| node_dataentry
node_graph -->|"reads settings"| node_config
node_graph -->|"uses colors"| node_theme
node_app -->|"loads data"| node_dataentry
node_app -->|"loads works"| node_workdata
node_app -->|"builds graph"| node_graph
node_app -->|"renders workspace"| node_home
node_app -->|"renders library"| node_works
node_app -->|"renders editor"| node_drafts
node_app -->|"renders idea pool"| node_ideas
node_app -->|"opens analysis"| node_analysis
node_app -->|"uses icons"| node_icons
node_home -->|"queries graph"| node_graph
node_home -->|"renders network"| node_canvas
node_home -->|"shows analysis"| node_analysis
node_canvas -->|"draws graph"| node_graph
node_analysis -->|"analyzes links"| node_graph
node_works -->|"shows details"| node_analysis
node_drafts -->|"persists drafts"| node_browser
node_ideas -->|"persists ideas"| node_browser
node_app -->|"stores goals"| node_browser
node_app -->|"uses theme"| node_theme

click node_importer "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/scripts/import-notes.mjs"
click node_dataentry "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/data/index.js"
click node_sample "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/data/sample.js"
click node_workdata "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/works.js"
click node_graph "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/graph.js"
click node_config "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/config.js"
click node_home "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/Home.jsx"
click node_canvas "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/NetworkCanvas.jsx"
click node_analysis "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/Analysis.jsx"
click node_works "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/pages.jsx"
click node_drafts "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/pages.jsx"
click node_ideas "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/pages.jsx"
click node_app "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/main.jsx"
click node_theme "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/theme.js"
click node_icons "https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/icons.jsx"

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_importer,node_dataentry,node_sample,node_workdata,node_graph,node_config toneBlue
class node_home,node_canvas,node_analysis,node_vault,node_browser toneAmber
class node_works,node_drafts,node_ideas toneMint
class node_app,node_theme,node_icons toneRose
class node_creator toneIndigo
```

## Components

### Data and graph

- [Note importer](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/scripts/import-notes.mjs): `scripts/import-notes.mjs`
- [Data selection](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/data/index.js): `src/data/index.js`
- [Sample content](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/data/sample.js): `src/data/sample.js`
- [Works data](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/works.js): `src/neural/works.js`
- [Graph engine](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/graph.js): `src/neural/graph.js`
- [Workspace config](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/config.js): `src/config.js`

### Graph workspace

- [Interactive workspace](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/Home.jsx): `src/neural/Home.jsx`
- [Network canvas](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/NetworkCanvas.jsx): `src/neural/NetworkCanvas.jsx`
- [Content analysis](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/Analysis.jsx): `src/neural/Analysis.jsx`

### Creator tools

- [Works library](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/pages.jsx): `src/neural/pages.jsx`
- [Draft editor](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/pages.jsx): `src/neural/pages.jsx`
- [Ideas pool](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/pages.jsx): `src/neural/pages.jsx`

### Presentation

- [App shell](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/main.jsx): `src/neural/main.jsx`
- [Theme and media](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/theme.js): `src/neural/theme.js`
- [Interface icons](https://github.com/luoluo-121/neural-creator-dashboard/blob/main/src/neural/icons.jsx): `src/neural/icons.jsx`

### Other components

- **Creator**
- **Markdown vault**
- **Browser localStorage**

## Connections

- Creator → Markdown vault: supplies notes (evidence: `README.md`)
- Markdown vault → Note importer: imports from (evidence: `README.md`)
- Note importer → Data selection: writes imported data (evidence: `README.md`)
- Data selection → Sample content: selects sample (evidence: `src/data/index.js`)
- Works data → Data selection: reads works (evidence: `src/neural/works.js`)
- Graph engine → Works data: reads works (evidence: `src/neural/graph.js`)
- Graph engine → Data selection: reads graph data (evidence: `src/neural/graph.js`)
- Graph engine → Workspace config: reads settings (evidence: `src/neural/graph.js`)
- Graph engine → Theme and media: uses colors (evidence: `src/neural/graph.js`)
- App shell → Data selection: loads data (evidence: `src/neural/main.jsx`)
- App shell → Works data: loads works (evidence: `src/neural/main.jsx`)
- App shell → Graph engine: builds graph (evidence: `src/neural/main.jsx`)
- App shell → Interactive workspace: renders workspace (evidence: `README.md`)
- App shell → Works library: renders library (evidence: `README.md`)
- App shell → Draft editor: renders editor (evidence: `README.md`)
- App shell → Ideas pool: renders idea pool (evidence: `README.md`)
- App shell → Content analysis: opens analysis (evidence: `src/neural/main.jsx`)
- App shell → Interface icons: uses icons (evidence: `src/neural/main.jsx`)
- Interactive workspace → Graph engine: queries graph (evidence: `src/neural/Home.jsx`)
- Interactive workspace → Network canvas: renders network (evidence: `src/neural/Home.jsx`)
- Interactive workspace → Content analysis: shows analysis (evidence: `src/neural/Home.jsx`)
- Network canvas → Graph engine: draws graph (evidence: `src/neural/NetworkCanvas.jsx`)
- Content analysis → Graph engine: analyzes links (evidence: `src/neural/Analysis.jsx`)
- Works library → Content analysis: shows details (evidence: `src/neural/pages.jsx`)
- Draft editor → Browser localStorage: persists drafts (evidence: `README.md`)
- Ideas pool → Browser localStorage: persists ideas (evidence: `README.md`)
- App shell → Browser localStorage: stores goals (evidence: `README.md`)
- App shell → Theme and media: uses theme (evidence: `src/neural/main.jsx`)
