# kristianeki11/pixel-spire architecture

> Architecture diagram of the GitHub repository kristianeki11/pixel-spire, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kristianeki11/pixel-spire
- Repository: https://github.com/kristianeki11/pixel-spire

## Overview

Pixel Spire is a browser-based deck-building roguelite. The player moves through campaign encounters, battles using cards and enemy intent cycles, then earns rewards and uses progression systems such as the shop and deck editor. The UI coordinates screens and player actions; game state and combat rules live in separate modules, with content defined in data files. Edges reflect excerpted calls or README descriptions; unsampled implementation details are not inferred.

Main entry points: [`game.js`](https://github.com/kristianeki11/pixel-spire/blob/main/game.js) (Save and Game State), [`ui.js`](https://github.com/kristianeki11/pixel-spire/blob/main/ui.js) (Screens and Controls), [`engine.js`](https://github.com/kristianeki11/pixel-spire/blob/main/engine.js) (Combat Engine), [`index.html`](https://github.com/kristianeki11/pixel-spire/blob/main/index.html) (Browser App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Game Interface"]
  node_app["Browser App<br/>[index.html]"]
  node_interface["Screens and Controls<br/>[ui.js]"]
end

subgraph group_runtime["Game Runtime"]
  node_combat["Combat Engine<br/>[engine.js]"]
end

subgraph group_progression["Run Progression"]
  node_state["Save and Game State<br/>[game.js]"]
end

subgraph group_content["Game Content"]
  node_campaign["Campaign Stages<br/>[stages.js]"]
  node_cards["Card Definitions<br/>[cards.js]"]
  node_enemies["Enemy Definitions<br/>[enemies.js]"]
  node_events["Event Encounters<br/>[events.js]"]
  node_relics["Relic Definitions<br/>[relics.js]"]
  node_curses["Curse Cards<br/>[curses.js]"]
  node_jesters["Jester Modifiers<br/>[jesters.js]"]
end

node_player(("Player"))

node_player -->|"plays in"| node_app
node_app -->|"hosts screens"| node_interface
node_player -->|"chooses actions"| node_interface
node_interface -->|"checks deck"| node_state
node_interface -->|"buys healing"| node_state
node_combat -->|"fires callbacks"| node_interface
node_combat -->|"resolves cards"| node_cards
node_state -->|"selects events"| node_events
node_state -->|"looks up enemies"| node_enemies
node_campaign -->|"offers stages"| node_interface
node_interface -.->|"starts battles"| node_combat
node_state -.->|"stores progress"| node_combat
node_relics -->|"defines combat hooks"| node_combat
node_curses -->|"extends card pool"| node_cards
node_jesters -.->|"defines run modifiers"| node_state
node_state -->|"saves progress"| node_player

click node_app "https://github.com/kristianeki11/pixel-spire/blob/main/index.html"
click node_interface "https://github.com/kristianeki11/pixel-spire/blob/main/ui.js"
click node_combat "https://github.com/kristianeki11/pixel-spire/blob/main/engine.js"
click node_state "https://github.com/kristianeki11/pixel-spire/blob/main/game.js"
click node_campaign "https://github.com/kristianeki11/pixel-spire/blob/main/data/stages.js"
click node_cards "https://github.com/kristianeki11/pixel-spire/blob/main/data/cards.js"
click node_enemies "https://github.com/kristianeki11/pixel-spire/blob/main/data/enemies.js"
click node_events "https://github.com/kristianeki11/pixel-spire/blob/main/data/events.js"
click node_relics "https://github.com/kristianeki11/pixel-spire/blob/main/data/relics.js"
click node_curses "https://github.com/kristianeki11/pixel-spire/blob/main/data/curses.js"
click node_jesters "https://github.com/kristianeki11/pixel-spire/blob/main/data/jesters.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_interface toneBlue
class node_combat toneAmber
class node_state toneMint
class node_campaign,node_cards,node_enemies,node_events,node_relics,node_curses,node_jesters toneRose
class node_player toneIndigo
```

## Components

### Game Interface

- [Browser App](https://github.com/kristianeki11/pixel-spire/blob/main/index.html): `index.html`
- [Screens and Controls](https://github.com/kristianeki11/pixel-spire/blob/main/ui.js): `ui.js`

### Game Runtime

- [Combat Engine](https://github.com/kristianeki11/pixel-spire/blob/main/engine.js): `engine.js`

### Run Progression

- [Save and Game State](https://github.com/kristianeki11/pixel-spire/blob/main/game.js): `game.js`

### Game Content

- [Campaign Stages](https://github.com/kristianeki11/pixel-spire/blob/main/data/stages.js): `data/stages.js`
- [Card Definitions](https://github.com/kristianeki11/pixel-spire/blob/main/data/cards.js): `data/cards.js`
- [Enemy Definitions](https://github.com/kristianeki11/pixel-spire/blob/main/data/enemies.js): `data/enemies.js`
- [Event Encounters](https://github.com/kristianeki11/pixel-spire/blob/main/data/events.js): `data/events.js`
- [Relic Definitions](https://github.com/kristianeki11/pixel-spire/blob/main/data/relics.js): `data/relics.js`
- [Curse Cards](https://github.com/kristianeki11/pixel-spire/blob/main/data/curses.js): `data/curses.js`
- [Jester Modifiers](https://github.com/kristianeki11/pixel-spire/blob/main/data/jesters.js): `data/jesters.js`

### Other components

- **Player**

## Connections

- Player → Browser App: plays in (evidence: `README.md`)
- Browser App → Screens and Controls: hosts screens (evidence: `README.md`)
- Player → Screens and Controls: chooses actions (evidence: `README.md`)
- Screens and Controls → Save and Game State: checks deck (evidence: `ui.js`)
- Screens and Controls → Save and Game State: buys healing (evidence: `ui.js`)
- Combat Engine → Screens and Controls: fires callbacks (evidence: `engine.js`)
- Combat Engine → Card Definitions: resolves cards (evidence: `engine.js`)
- Save and Game State → Event Encounters: selects events (evidence: `game.js`)
- Save and Game State → Enemy Definitions: looks up enemies (evidence: `game.js`)
- Campaign Stages → Screens and Controls: offers stages (evidence: `README.md`)
- Screens and Controls → Combat Engine: starts battles
- Save and Game State → Combat Engine: stores progress
- Relic Definitions → Combat Engine: defines combat hooks (evidence: `data/relics.js`)
- Curse Cards → Card Definitions: extends card pool (evidence: `data/curses.js`)
- Jester Modifiers → Save and Game State: defines run modifiers
- Save and Game State → Player: saves progress (evidence: `README.md`)
