# 1j01/jspaint architecture

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

- Interactive diagram: https://gitdiagram.com/1j01/jspaint
- Repository: https://github.com/1j01/jspaint

## Overview

JS Paint is a browser-based MS Paint remake, also packaged for desktop and Discord Activity use. Users open or create an image, edit it with canvas tools and menus, then save or export it; the app also offers history, format conversion, themes, accessibility controls, and collaboration. The graph highlights that workflow and major documented features. Several feature modules are unsampled, so their documented capabilities are included, but uncertain internal links are omitted.

Main entry points: [`src/menus.js`](https://github.com/1j01/jspaint/blob/master/src/menus.js) (Menus), [`src/app.js`](https://github.com/1j01/jspaint/blob/master/src/app.js) (App shell), [`src/speech-recognition.js`](https://github.com/1j01/jspaint/blob/master/src/speech-recognition.js) (Speech control), [`src/functions.js`](https://github.com/1j01/jspaint/blob/master/src/functions.js) (File and history actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Paint interface"]
  node_app["App shell<br/>[app.js]"]
  node_menus["Menus<br/>[menus.js]"]
  node_widgets["Paint widgets<br/>[$ToolBox.js]"]
  node_localization["Localization"]
end

subgraph group_editing["Image editing"]
  node_canvas["Canvas tools<br/>[tools.js]"]
  node_imageops["Image operations"]
  node_text["Canvas text<br/>[OnCanvasTextBox.js]"]
  node_colors["Color editing<br/>[edit-colors.js]"]
end

subgraph group_files["Files and history"]
  node_formatdata["File formats"]
  node_fileops["File and history actions<br/>[functions.js]"]
  node_storage[("Local backups<br/>[storage.js]")]
  node_storageui["Backup manager<br/>[manage-storage.js]"]
  node_gif["History GIF export<br/>[functions.js]"]
end

subgraph group_extras["Accessibility and extras"]
  node_themes["Themes<br/>[theme.js]"]
  node_speech["Speech control"]
  node_gestures["Gesture simulation"]
  node_headtracking["Head tracking<br/>[tracky-mouse.js]"]
end

subgraph group_platform["Platform integrations"]
  node_imgur["Imgur upload<br/>[imgur.js]"]
  node_sessions["Shared sessions<br/>[sessions.js]"]
  node_discord["Discord activity client"]
  node_server["Activity server<br/>[app.ts]"]
end

node_user(("Artist"))
node_actor(("Discord user"))
node_discordapi["Discord OAuth API"]

node_user -->|"opens and edits"| node_app
node_app -->|"initializes"| node_menus
node_app -->|"creates"| node_widgets
node_app -->|"invokes"| node_fileops
node_menus -->|"dispatches actions"| node_fileops
node_menus -.->|"selects tools"| node_canvas
node_menus -->|"opens editor"| node_colors
node_menus -->|"uses text tool"| node_text
node_app -->|"initializes"| node_imageops
node_app -->|"loads formats"| node_formatdata
node_app -->|"loads language"| node_localization
node_menus -->|"offers themes"| node_themes
node_app -->|"loads backup storage"| node_storage
node_fileops -.->|"persists backups"| node_storage
node_menus -->|"opens manager"| node_storageui
node_menus -->|"exports history"| node_gif
node_user -->|"speaks commands"| node_speech
node_speech -->|"activates items"| node_menus
node_speech -->|"simulates gestures"| node_gestures
node_user -->|"uses head tracking"| node_headtracking
node_menus -->|"uploads image"| node_imgur
node_user -->|"joins session"| node_sessions
node_app -.->|"supports activity"| node_discord
node_actor -.->|"uses activity"| node_server
node_server -->|"exchanges token"| node_discordapi

click node_app "https://github.com/1j01/jspaint/blob/master/src/app.js"
click node_menus "https://github.com/1j01/jspaint/blob/master/src/menus.js"
click node_widgets "https://github.com/1j01/jspaint/blob/master/src/%24ToolBox.js"
click node_localization "https://github.com/1j01/jspaint/blob/master/src/app-localization.js"
click node_canvas "https://github.com/1j01/jspaint/blob/master/src/tools.js"
click node_imageops "https://github.com/1j01/jspaint/blob/master/src/image-manipulation.js"
click node_text "https://github.com/1j01/jspaint/blob/master/src/OnCanvasTextBox.js"
click node_colors "https://github.com/1j01/jspaint/blob/master/src/edit-colors.js"
click node_formatdata "https://github.com/1j01/jspaint/blob/master/src/file-format-data.js"
click node_fileops "https://github.com/1j01/jspaint/blob/master/src/functions.js"
click node_storage "https://github.com/1j01/jspaint/blob/master/src/storage.js"
click node_storageui "https://github.com/1j01/jspaint/blob/master/src/manage-storage.js"
click node_gif "https://github.com/1j01/jspaint/blob/master/src/functions.js"
click node_themes "https://github.com/1j01/jspaint/blob/master/src/theme.js"
click node_speech "https://github.com/1j01/jspaint/blob/master/src/speech-recognition.js"
click node_gestures "https://github.com/1j01/jspaint/blob/master/src/simulate-random-gestures.js"
click node_headtracking "https://github.com/1j01/jspaint/blob/master/lib/tracky-mouse/core/tracky-mouse.js"
click node_imgur "https://github.com/1j01/jspaint/blob/master/src/imgur.js"
click node_sessions "https://github.com/1j01/jspaint/blob/master/src/sessions.js"
click node_discord "https://github.com/1j01/jspaint/blob/master/src/discord-activity-client.js"
click node_server "https://github.com/1j01/jspaint/blob/master/discord-activity/packages/server/src/app.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_menus,node_widgets,node_localization,node_actor toneBlue
class node_canvas,node_imageops,node_text,node_colors toneAmber
class node_formatdata,node_fileops,node_storage,node_storageui,node_gif,node_discordapi toneMint
class node_themes,node_speech,node_gestures,node_headtracking toneRose
class node_imgur,node_sessions,node_discord,node_server,node_user toneIndigo
```

## Components

### Paint interface

- [App shell](https://github.com/1j01/jspaint/blob/master/src/app.js): `src/app.js`
- [Menus](https://github.com/1j01/jspaint/blob/master/src/menus.js): `src/menus.js`
- [Paint widgets](https://github.com/1j01/jspaint/blob/master/src/%24ToolBox.js): `src/$ToolBox.js`
- [Localization](https://github.com/1j01/jspaint/blob/master/src/app-localization.js): `src/app-localization.js`

### Image editing

- [Canvas tools](https://github.com/1j01/jspaint/blob/master/src/tools.js): `src/tools.js`
- [Image operations](https://github.com/1j01/jspaint/blob/master/src/image-manipulation.js): `src/image-manipulation.js`
- [Canvas text](https://github.com/1j01/jspaint/blob/master/src/OnCanvasTextBox.js): `src/OnCanvasTextBox.js`
- [Color editing](https://github.com/1j01/jspaint/blob/master/src/edit-colors.js): `src/edit-colors.js`

### Files and history

- [File formats](https://github.com/1j01/jspaint/blob/master/src/file-format-data.js): `src/file-format-data.js`
- [File and history actions](https://github.com/1j01/jspaint/blob/master/src/functions.js): `src/functions.js`
- [Local backups](https://github.com/1j01/jspaint/blob/master/src/storage.js): `src/storage.js`
- [Backup manager](https://github.com/1j01/jspaint/blob/master/src/manage-storage.js): `src/manage-storage.js`
- [History GIF export](https://github.com/1j01/jspaint/blob/master/src/functions.js): `src/functions.js`

### Accessibility and extras

- [Themes](https://github.com/1j01/jspaint/blob/master/src/theme.js): `src/theme.js`
- [Speech control](https://github.com/1j01/jspaint/blob/master/src/speech-recognition.js): `src/speech-recognition.js`
- [Gesture simulation](https://github.com/1j01/jspaint/blob/master/src/simulate-random-gestures.js): `src/simulate-random-gestures.js`
- [Head tracking](https://github.com/1j01/jspaint/blob/master/lib/tracky-mouse/core/tracky-mouse.js): `lib/tracky-mouse/core/tracky-mouse.js`

### Platform integrations

- [Imgur upload](https://github.com/1j01/jspaint/blob/master/src/imgur.js): `src/imgur.js`
- [Shared sessions](https://github.com/1j01/jspaint/blob/master/src/sessions.js): `src/sessions.js`
- [Discord activity client](https://github.com/1j01/jspaint/blob/master/src/discord-activity-client.js): `src/discord-activity-client.js`
- [Activity server](https://github.com/1j01/jspaint/blob/master/discord-activity/packages/server/src/app.ts): `discord-activity/packages/server/src/app.ts`

### Other components

- **Artist**
- **Discord user**
- **Discord OAuth API**

## Connections

- Artist → App shell: opens and edits (evidence: `README.md`)
- App shell → Menus: initializes (evidence: `src/app.js`)
- App shell → Paint widgets: creates (evidence: `src/app.js`)
- App shell → File and history actions: invokes (evidence: `src/app.js`)
- Menus → File and history actions: dispatches actions (evidence: `src/menus.js`)
- Menus → Canvas tools: selects tools
- Menus → Color editing: opens editor (evidence: `src/menus.js`)
- Menus → Canvas text: uses text tool (evidence: `src/menus.js`)
- App shell → Image operations: initializes (evidence: `src/app.js`)
- App shell → File formats: loads formats (evidence: `src/app.js`)
- App shell → Localization: loads language (evidence: `src/app.js`)
- Menus → Themes: offers themes (evidence: `src/menus.js`)
- App shell → Local backups: loads backup storage (evidence: `src/app.js`)
- File and history actions → Local backups: persists backups (evidence: `src/functions.js`)
- Menus → Backup manager: opens manager (evidence: `src/menus.js`)
- Menus → History GIF export: exports history (evidence: `src/menus.js`)
- Artist → Speech control: speaks commands (evidence: `README.md`)
- Speech control → Menus: activates items (evidence: `src/speech-recognition.js`)
- Speech control → Gesture simulation: simulates gestures (evidence: `src/speech-recognition.js`)
- Artist → Head tracking: uses head tracking (evidence: `README.md`)
- Menus → Imgur upload: uploads image (evidence: `src/menus.js`)
- Artist → Shared sessions: joins session (evidence: `README.md`)
- App shell → Discord activity client: supports activity
- Discord user → Activity server: uses activity
- Activity server → Discord OAuth API: exchanges token (evidence: `discord-activity/packages/server/src/app.ts`)
