# e10e04/moodbord architecture

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

## Overview

Moodboard is a spatial design canvas delivered as an Illustrator CEP extension and a standalone Electron app, sharing the CEP client as the canonical engine. The main workflow is to add or import references, arrange and edit them on an infinite canvas, then save or export the board. The graph includes the documented element, history, library, diagnostics and Illustrator capabilities. Some unsampled modules are represented by their exact paths; their internal call relationships are not inferred.

Main entry points: [`moodboard-cep/client/js/core/storage.js`](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/storage.js) (Project storage), [`moodboard-cep/client/js/core/store.js`](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/store.js) (Board store), [`moodboard-cep/client/js/main.js`](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/main.js) (Illustrator panel), [`moodboard-cep/client/js/ui/contextmenu.js`](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/contextmenu.js) (Context menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shells"]
  node_cep_app["Illustrator panel<br/>[main.js]"]
  node_desktop_shell["Electron shell<br/>[main.js]"]
  node_desktop_preload["Desktop bridge<br/>[preload.js]"]
end

subgraph group_canvas["Canvas workspace"]
  node_interactions["Canvas interactions<br/>[interactions.js]"]
  node_camera["Canvas camera<br/>[camera.js]"]
  node_board_view["Board view<br/>[board.js]"]
  node_content["Element content<br/>[content.js]"]
  node_element_view["Element view<br/>[elementView.js]"]
  node_export["SVG and PNG export<br/>[export.js]"]
end

subgraph group_state["Board state"]
  node_store["Board store<br/>[store.js]"]
  node_history["Undo and redo<br/>[history.js]"]
  node_factory["Element factory<br/>[factory.js]"]
  node_boards["Nested boards<br/>[boards.js]"]
end

subgraph group_interface["User interface"]
  node_library["Resource library<br/>[library.js]"]
  node_inspector["Inspector<br/>[inspector.js]"]
  node_toolbar["Toolbars and controls<br/>[toolbar.js]"]
  node_contextbar["Context toolbar<br/>[contextbar.js]"]
  node_contextmenu["Context menu<br/>[contextmenu.js]"]
  node_home["Project home<br/>[home.js]"]
end

subgraph group_io["Persistence and integrations"]
  node_storage[("Project storage<br/>[storage.js]")]
  node_diagnostics["Diagnostics<br/>[diaglog.js]"]
  node_cep_bridge["Illustrator bridge<br/>[cep.js]"]
  node_host_script["Illustrator host script<br/>[host.script.jsx]"]
end

node_designer(("Designer"))

node_designer -->|"opens panel"| node_cep_app
node_designer -->|"opens app"| node_desktop_shell
node_cep_app -.->|"uses canvas"| node_interactions
node_desktop_shell -->|"exposes bridge"| node_desktop_preload
node_desktop_shell -->|"native dialogs"| node_designer
node_interactions -.->|"edits board"| node_store
node_interactions -.->|"controls view"| node_camera
node_board_view -.->|"renders elements"| node_content
node_board_view -.->|"renders elements"| node_element_view
node_store -.->|"tracks changes"| node_history
node_store -.->|"creates elements"| node_factory
node_store -.->|"stores board state"| node_boards
node_designer -->|"imports resources"| node_library
node_designer -->|"edits selection"| node_inspector
node_designer -->|"chooses actions"| node_toolbar
node_designer -->|"edits selection"| node_contextbar
node_contextbar -->|"rerenders element"| node_content
node_designer -->|"opens menu"| node_contextmenu
node_contextmenu -->|"starts editing"| node_interactions
node_contextmenu -->|"places image"| node_cep_bridge
node_contextmenu -->|"pastes clipboard"| node_store
node_designer -->|"manages projects"| node_home
node_home -.->|"opens projects"| node_storage
node_cep_app -->|"loads board"| node_store
node_cep_app -->|"resets boards"| node_boards
node_cep_app -->|"fits canvas"| node_camera
node_cep_app -->|"marks saved"| node_storage
node_storage -->|"updates save state"| node_store
node_storage -->|"serializes board"| node_boards
node_designer -->|"saves or opens"| node_storage
node_storage -.->|"uses desktop IPC"| node_desktop_preload
node_storage -->|"reads and writes files"| node_desktop_shell
node_designer -->|"exports board"| node_export
node_designer -->|"opens diagnostics"| node_diagnostics
node_cep_bridge -.->|"calls host"| node_host_script
node_host_script -->|"places assets"| node_designer

click node_cep_app "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/main.js"
click node_desktop_shell "https://github.com/e10e04/moodbord/blob/main/moodboard-desktop/main.js"
click node_desktop_preload "https://github.com/e10e04/moodbord/blob/main/moodboard-desktop/preload.js"
click node_interactions "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/interactions.js"
click node_camera "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/camera.js"
click node_board_view "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/board.js"
click node_content "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/content.js"
click node_element_view "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/elementView.js"
click node_export "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/export.js"
click node_store "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/store.js"
click node_history "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/history.js"
click node_factory "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/factory.js"
click node_boards "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/boards.js"
click node_library "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/library.js"
click node_inspector "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/inspector.js"
click node_toolbar "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/toolbar.js"
click node_contextbar "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/contextbar.js"
click node_contextmenu "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/contextmenu.js"
click node_home "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/home.js"
click node_storage "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/storage.js"
click node_diagnostics "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/diaglog.js"
click node_cep_bridge "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/adobe/cep.js"
click node_host_script "https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/adobe/host.script.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_cep_app,node_desktop_shell,node_desktop_preload toneBlue
class node_interactions,node_camera,node_board_view,node_content,node_element_view,node_export toneAmber
class node_store,node_history,node_factory,node_boards toneMint
class node_library,node_inspector,node_toolbar,node_contextbar,node_contextmenu,node_home toneRose
class node_storage,node_diagnostics,node_cep_bridge,node_host_script,node_designer toneIndigo
```

## Components

### App shells

- [Illustrator panel](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/main.js): `moodboard-cep/client/js/main.js`
- [Electron shell](https://github.com/e10e04/moodbord/blob/main/moodboard-desktop/main.js): `moodboard-desktop/main.js`
- [Desktop bridge](https://github.com/e10e04/moodbord/blob/main/moodboard-desktop/preload.js): `moodboard-desktop/preload.js`

### Canvas workspace

- [Canvas interactions](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/interactions.js): `moodboard-cep/client/js/board/interactions.js`
- [Canvas camera](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/camera.js): `moodboard-cep/client/js/core/camera.js`
- [Board view](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/board.js): `moodboard-cep/client/js/board/board.js`
- [Element content](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/content.js): `moodboard-cep/client/js/board/content.js`
- [Element view](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/elementView.js): `moodboard-cep/client/js/board/elementView.js`
- [SVG and PNG export](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/board/export.js): `moodboard-cep/client/js/board/export.js`

### Board state

- [Board store](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/store.js): `moodboard-cep/client/js/core/store.js`
- [Undo and redo](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/history.js): `moodboard-cep/client/js/core/history.js`
- [Element factory](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/factory.js): `moodboard-cep/client/js/core/factory.js`
- [Nested boards](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/boards.js): `moodboard-cep/client/js/core/boards.js`

### User interface

- [Resource library](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/library.js): `moodboard-cep/client/js/ui/library.js`
- [Inspector](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/inspector.js): `moodboard-cep/client/js/ui/inspector.js`
- [Toolbars and controls](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/toolbar.js): `moodboard-cep/client/js/ui/toolbar.js`
- [Context toolbar](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/contextbar.js): `moodboard-cep/client/js/ui/contextbar.js`
- [Context menu](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/contextmenu.js): `moodboard-cep/client/js/ui/contextmenu.js`
- [Project home](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/ui/home.js): `moodboard-cep/client/js/ui/home.js`

### Persistence and integrations

- [Project storage](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/storage.js): `moodboard-cep/client/js/core/storage.js`
- [Diagnostics](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/core/diaglog.js): `moodboard-cep/client/js/core/diaglog.js`
- [Illustrator bridge](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/adobe/cep.js): `moodboard-cep/client/js/adobe/cep.js`
- [Illustrator host script](https://github.com/e10e04/moodbord/blob/main/moodboard-cep/client/js/adobe/host.script.jsx): `moodboard-cep/client/js/adobe/host.script.jsx`

### Other components

- **Designer**

## Connections

- Designer → Illustrator panel: opens panel
- Designer → Electron shell: opens app
- Illustrator panel → Canvas interactions: uses canvas
- Electron shell → Desktop bridge: exposes bridge
- Electron shell → Designer: native dialogs (evidence: `moodboard-desktop/main.js`)
- Canvas interactions → Board store: edits board
- Canvas interactions → Canvas camera: controls view
- Board view → Element content: renders elements
- Board view → Element view: renders elements
- Board store → Undo and redo: tracks changes
- Board store → Element factory: creates elements
- Board store → Nested boards: stores board state
- Designer → Resource library: imports resources
- Designer → Inspector: edits selection
- Designer → Toolbars and controls: chooses actions
- Designer → Context toolbar: edits selection (evidence: `moodboard-cep/client/js/ui/contextbar.js`)
- Context toolbar → Element content: rerenders element (evidence: `moodboard-cep/client/js/ui/contextbar.js`)
- Designer → Context menu: opens menu
- Context menu → Canvas interactions: starts editing (evidence: `moodboard-cep/client/js/ui/contextmenu.js`)
- Context menu → Illustrator bridge: places image (evidence: `moodboard-cep/client/js/ui/contextmenu.js`)
- Context menu → Board store: pastes clipboard (evidence: `moodboard-cep/client/js/ui/contextmenu.js`)
- Designer → Project home: manages projects
- Project home → Project storage: opens projects
- Illustrator panel → Board store: loads board (evidence: `moodboard-cep/client/js/main.js`)
- Illustrator panel → Nested boards: resets boards (evidence: `moodboard-cep/client/js/main.js`)
- Illustrator panel → Canvas camera: fits canvas (evidence: `moodboard-cep/client/js/main.js`)
- Illustrator panel → Project storage: marks saved (evidence: `moodboard-cep/client/js/main.js`)
- Project storage → Board store: updates save state (evidence: `moodboard-cep/client/js/core/storage.js`)
- Project storage → Nested boards: serializes board (evidence: `moodboard-cep/client/js/core/storage.js`)
- Designer → Project storage: saves or opens
- Project storage → Desktop bridge: uses desktop IPC
- Project storage → Electron shell: reads and writes files
- Designer → SVG and PNG export: exports board
- Designer → Diagnostics: opens diagnostics
- Illustrator bridge → Illustrator host script: calls host
- Illustrator host script → Designer: places assets
