# rileyfrancis/bag-of-holding architecture

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

## Overview

Bag of Holding is a browser-based tabletop-RPG inventory and character manager. Players restore or create a character, arrange shaped items in a grid, equip them, and view character-sheet details; GMs and players can also use shared party sessions, shops, dice/chat, and battle maps. The graph preserves those documented product areas and the optional Firebase account/cloud-save path. Main boot calls are evidenced by the entry-point excerpt; most feature-level connections are documented capabilities rather than inspected call paths.

Main entry points: [`src/js/main.js`](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/main.js) (Application boot), [`src/js/auth.js`](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/auth.js) (Account sign-in), [`src/js/characters.js`](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/characters.js) (Character roster), [`src/js/character-sheet.js`](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/character-sheet.js) (Character sheet)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inventory["Inventory"]
  node_app["Application boot<br/>[main.js]"]
  node_items["Item catalog<br/>[items.js]"]
  node_grid["Grid inventory<br/>[render-grid.js]"]
  node_item_interaction["Item interactions"]
  node_equipment["Equipment slots<br/>[equipment.js]"]
end

subgraph group_characters["Characters"]
  node_characters["Character roster<br/>[characters.js]"]
  node_sheet["Character sheet<br/>[character-sheet.js]"]
  node_sheet_layout["Sheet layout<br/>[sheet-layout.js]"]
  node_class_features["Class features<br/>[class-features.js]"]
  node_spells["Spells<br/>[spells.js]"]
end

subgraph group_tabletop["Tabletop play"]
  node_battlemap["Battle map<br/>[battlemap-view.js]"]
  node_map_library["Map library"]
  node_initiative["Initiative"]
  node_shop["Party shops<br/>[shop.js]"]
  node_dice["Dice rolls<br/>[dice.js]"]
  node_chat["Party chat<br/>[chat.js]"]
end

subgraph group_sharing["Accounts and sharing"]
  node_party["Party sessions<br/>[party.js]"]
  node_auth["Account sign-in<br/>[auth.js]"]
  node_cloud_save["Cloud save<br/>[cloud-save.js]"]
  node_persistence[("Local persistence<br/>[persistence.js]")]
end

subgraph group_customization["Customization"]
  node_homebrew["Custom items<br/>[homebrew.js]"]
  node_homebrew_editor["Item editor<br/>[homebrew-editor.js]"]
  node_appearance["Appearance<br/>[appearance.js]"]
end

node_player(("Player or GM"))

node_player -->|"opens"| node_app
node_app -->|"loads defaults"| node_items
node_app -->|"restores session"| node_persistence
node_app -->|"initializes theme"| node_appearance
node_app -->|"initializes auth"| node_auth
node_player -->|"manages items"| node_grid
node_player -->|"drags items"| node_item_interaction
node_player -->|"equips items"| node_equipment
node_player -->|"manages characters"| node_characters
node_characters -->|"views sheet"| node_sheet
node_sheet -->|"rearranges sections"| node_sheet_layout
node_player -->|"views features"| node_class_features
node_player -.->|"manages spells"| node_spells
node_player -->|"imports maps"| node_map_library
node_player -->|"places creatures"| node_battlemap
node_player -.->|"tracks turns"| node_initiative
node_player -->|"uses shop"| node_shop
node_player -.->|"rolls dice"| node_dice
node_player -.->|"chats"| node_chat
node_player -->|"joins session"| node_party
node_party -->|"requires account"| node_auth
node_auth -->|"enables sync"| node_cloud_save
node_cloud_save -.->|"mirrors characters"| node_persistence
node_player -->|"edits items"| node_homebrew_editor
node_homebrew_editor -.->|"customizes catalog"| node_homebrew
node_player -->|"sets theme"| node_appearance

click node_app "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/main.js"
click node_items "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/items.js"
click node_grid "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/render-grid.js"
click node_item_interaction "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/interaction-drag.js"
click node_equipment "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/equipment.js"
click node_characters "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/characters.js"
click node_sheet "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/character-sheet.js"
click node_sheet_layout "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/sheet-layout.js"
click node_class_features "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/class-features.js"
click node_spells "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/spells.js"
click node_battlemap "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/battlemap-view.js"
click node_map_library "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/battlemap-library.js"
click node_initiative "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/battlemap-initiative.js"
click node_shop "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/shop.js"
click node_dice "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/dice.js"
click node_chat "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/chat.js"
click node_party "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/party.js"
click node_auth "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/auth.js"
click node_cloud_save "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/cloud-save.js"
click node_persistence "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/persistence.js"
click node_homebrew "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/homebrew.js"
click node_homebrew_editor "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/homebrew-editor.js"
click node_appearance "https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/appearance.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_items,node_grid,node_item_interaction,node_equipment toneBlue
class node_characters,node_sheet,node_sheet_layout,node_class_features,node_spells toneAmber
class node_battlemap,node_map_library,node_initiative,node_shop,node_dice,node_chat toneMint
class node_party,node_auth,node_cloud_save,node_persistence toneRose
class node_homebrew,node_homebrew_editor,node_appearance,node_player toneIndigo
```

## Components

### Inventory

- [Application boot](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/main.js): `src/js/main.js`
- [Item catalog](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/items.js): `src/js/items.js`
- [Grid inventory](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/render-grid.js): `src/js/render-grid.js`
- [Item interactions](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/interaction-drag.js): `src/js/interaction-drag.js`
- [Equipment slots](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/equipment.js): `src/js/equipment.js`

### Characters

- [Character roster](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/characters.js): `src/js/characters.js`
- [Character sheet](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/character-sheet.js): `src/js/character-sheet.js`
- [Sheet layout](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/sheet-layout.js): `src/js/sheet-layout.js`
- [Class features](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/class-features.js): `src/js/class-features.js`
- [Spells](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/spells.js): `src/js/spells.js`

### Tabletop play

- [Battle map](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/battlemap-view.js): `src/js/battlemap-view.js`
- [Map library](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/battlemap-library.js): `src/js/battlemap-library.js`
- [Initiative](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/battlemap-initiative.js): `src/js/battlemap-initiative.js`
- [Party shops](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/shop.js): `src/js/shop.js`
- [Dice rolls](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/dice.js): `src/js/dice.js`
- [Party chat](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/chat.js): `src/js/chat.js`

### Accounts and sharing

- [Party sessions](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/party.js): `src/js/party.js`
- [Account sign-in](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/auth.js): `src/js/auth.js`
- [Cloud save](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/cloud-save.js): `src/js/cloud-save.js`
- [Local persistence](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/persistence.js): `src/js/persistence.js`

### Customization

- [Custom items](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/homebrew.js): `src/js/homebrew.js`
- [Item editor](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/homebrew-editor.js): `src/js/homebrew-editor.js`
- [Appearance](https://github.com/rileyfrancis/bag-of-holding/blob/main/src/js/appearance.js): `src/js/appearance.js`

### Other components

- **Player or GM**

## Connections

- Player or GM → Application boot: opens (evidence: `README.md`)
- Application boot → Item catalog: loads defaults (evidence: `src/js/main.js`)
- Application boot → Local persistence: restores session (evidence: `src/js/main.js`)
- Application boot → Appearance: initializes theme (evidence: `src/js/main.js`)
- Application boot → Account sign-in: initializes auth (evidence: `src/js/main.js`)
- Player or GM → Grid inventory: manages items (evidence: `README.md`)
- Player or GM → Item interactions: drags items (evidence: `README.md`)
- Player or GM → Equipment slots: equips items (evidence: `README.md`)
- Player or GM → Character roster: manages characters (evidence: `README.md`)
- Character roster → Character sheet: views sheet (evidence: `README.md`)
- Character sheet → Sheet layout: rearranges sections (evidence: `README.md`)
- Player or GM → Class features: views features (evidence: `README.md`)
- Player or GM → Spells: manages spells
- Player or GM → Map library: imports maps (evidence: `README.md`)
- Player or GM → Battle map: places creatures (evidence: `README.md`)
- Player or GM → Initiative: tracks turns
- Player or GM → Party shops: uses shop (evidence: `README.md`)
- Player or GM → Dice rolls: rolls dice
- Player or GM → Party chat: chats
- Player or GM → Party sessions: joins session (evidence: `README.md`)
- Party sessions → Account sign-in: requires account (evidence: `README.md`)
- Account sign-in → Cloud save: enables sync (evidence: `README.md`)
- Cloud save → Local persistence: mirrors characters
- Player or GM → Item editor: edits items (evidence: `README.md`)
- Item editor → Custom items: customizes catalog
- Player or GM → Appearance: sets theme (evidence: `README.md`)
