# bloodorca/hollow architecture

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

## Overview

Hollow is a browser-based Hollow Knight save editor. Users select or drag in a PC save, or choose Nintendo Switch mode for plain-text saves; the app loads JSON into an editor, lets users modify or reset it, and downloads an encrypted PC save or plain Switch save. Recent edits are kept in browser storage and can be reopened. The main control flow is visible in `src/index.js`; codec internals and history persistence are also sampled. Other UI and persistence details are represented only where documented or directly evidenced.

Main entry points: [`src/index.js`](https://github.com/bloodorca/hollow/blob/master/src/index.js) (App controller), [`src/functions.js`](https://github.com/bloodorca/hollow/blob/master/src/functions.js) (Save codec), [`src/history.js`](https://github.com/bloodorca/hollow/blob/master/src/history.js) (History manager), [`src/windowDrag.js`](https://github.com/bloodorca/hollow/blob/master/src/windowDrag.js) (Drag handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Editing workflow"]
  node_app["App controller<br/>[index.js]"]
  node_drag["Drag handler<br/>[windowDrag.js]"]
  node_editor["JSON editor<br/>[index.js]"]
end

subgraph group_codec["Save conversion"]
  node_codec["Save codec<br/>[functions.js]"]
  node_base64["Base64 codec<br/>[base64.js]"]
end

subgraph group_history["Recent history"]
  node_history["History manager<br/>[history.js]"]
  node_storage[("Browser storage")]
end

node_user(("User"))
node_savefile["Save file"]
node_download["Downloaded save"]

node_user -->|"selects save"| node_app
node_user -->|"drops save"| node_drag
node_drag -->|"dispatches drop"| node_app
node_app -->|"reads file"| node_savefile
node_app -->|"decodes PC save"| node_codec
node_codec -->|"decodes bytes"| node_base64
node_app -->|"renders JSON"| node_editor
node_editor -->|"edits JSON"| node_app
node_app -->|"updates history"| node_history
node_history -->|"reads and writes"| node_storage
node_app -->|"reopens entry"| node_history
node_app -->|"encodes PC save"| node_codec
node_codec -->|"encodes bytes"| node_base64
node_app -->|"downloads save"| node_download

click node_app "https://github.com/bloodorca/hollow/blob/master/src/index.js"
click node_drag "https://github.com/bloodorca/hollow/blob/master/src/windowDrag.js"
click node_editor "https://github.com/bloodorca/hollow/blob/master/src/index.js"
click node_codec "https://github.com/bloodorca/hollow/blob/master/src/functions.js"
click node_base64 "https://github.com/bloodorca/hollow/blob/master/src/base64.js"
click node_history "https://github.com/bloodorca/hollow/blob/master/src/history.js"

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_drag,node_editor,node_user toneBlue
class node_codec,node_base64 toneAmber
class node_history,node_storage toneMint
class node_savefile,node_download toneIndigo
```

## Components

### Editing workflow

- [App controller](https://github.com/bloodorca/hollow/blob/master/src/index.js): `src/index.js`
- [Drag handler](https://github.com/bloodorca/hollow/blob/master/src/windowDrag.js): `src/windowDrag.js`
- [JSON editor](https://github.com/bloodorca/hollow/blob/master/src/index.js): `src/index.js`

### Save conversion

- [Save codec](https://github.com/bloodorca/hollow/blob/master/src/functions.js): `src/functions.js`
- [Base64 codec](https://github.com/bloodorca/hollow/blob/master/src/base64.js): `src/base64.js`

### Recent history

- [History manager](https://github.com/bloodorca/hollow/blob/master/src/history.js): `src/history.js`
- **Browser storage**

### Other components

- **User**
- **Save file**
- **Downloaded save**

## Connections

- User → App controller: selects save (evidence: `README.md`)
- User → Drag handler: drops save (evidence: `README.md`)
- Drag handler → App controller: dispatches drop (evidence: `src/index.js`)
- App controller → Save file: reads file (evidence: `src/index.js`)
- App controller → Save codec: decodes PC save (evidence: `src/index.js`)
- Save codec → Base64 codec: decodes bytes (evidence: `src/functions.js`)
- App controller → JSON editor: renders JSON (evidence: `src/index.js`)
- JSON editor → App controller: edits JSON (evidence: `src/index.js`)
- App controller → History manager: updates history (evidence: `src/index.js`)
- History manager → Browser storage: reads and writes (evidence: `src/history.js`)
- App controller → History manager: reopens entry (evidence: `src/index.js`)
- App controller → Save codec: encodes PC save (evidence: `src/index.js`)
- Save codec → Base64 codec: encodes bytes (evidence: `src/functions.js`)
- App controller → Downloaded save: downloads save (evidence: `src/index.js`)
