# marchbeta2087/ordinal-pringles architecture

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

## Overview

Ordinal Pringles is a browser incremental game: players grow ordinals, convert progress through successive prestige layers, and spend each layer’s currencies on upgrades and automation. The graph follows browser startup into the recurring game loop and save handling, then shows the principal progression systems, ordinal representation, and major endgame stages documented in the README. Cloud saving is a separate optional integration. Source excerpts and the index establish only some calls; unsampled subsystem relationships are omitted rather than inferred.

Main entry points: [`src/main.js`](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/main.js) (Startup and loop), [`src/boosters/boosters.js`](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/boosters.js) (Boosters), [`src/obliterate/obliterate.js`](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/obliterate.js) (Obliteration), [`src/ordinal/ordinalDisplay.js`](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/ordinalDisplay.js) (Ordinal display)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_main["Startup and loop<br/>[main.js]"]
  node_ticks["Tick processing<br/>[tick.js]"]
  node_update["UI updates<br/>[update.js]"]
  node_tabs["Navigation<br/>[tabs.js]"]
  node_achievements["Achievements<br/>[achievements.js]"]
end

subgraph group_ordinal["Ordinal engine"]
  node_ordinal_math["Ordinal calculations<br/>[ordinal.js]"]
  node_ordinal_display["Ordinal display<br/>[ordinalDisplay.js]"]
  node_ordinary_marks["Ordinal marks<br/>[ordMarks.js]"]
  node_bms_marks["BMS marks<br/>[bmsOrdMarks.js]"]
  node_veblen_marks["Veblen marks<br/>[veblenOrdMarks.js]"]
  node_hardy["Hardy calculations<br/>[hardy.js]"]
  node_decimal["Large-number arithmetic<br/>[BreakEternity.js]"]
  node_expanta["Hyper-number arithmetic<br/>[ExpantaNum.js]"]
  node_number_format["Number formatting"]
end

subgraph group_progression["Progression layers"]
  node_markup["Markup and factors<br/>[markup.js]"]
  node_factor_ui["Factor upgrades<br/>[factors.js]"]
  node_boosters["Boosters<br/>[boosters.js]"]
  node_challenges["Challenges<br/>[challenges.js]"]
  node_incrementy["Incrementy<br/>[incrementy.js]"]
  node_hierarchies["Hierarchies<br/>[hierarchies.js]"]
  node_automation["Automation<br/>[automation.js]"]
  node_overflow["Overflow<br/>[overflow.js]"]
  node_collapse["Collapse<br/>[collapse.js]"]
  node_darkness["Darkness<br/>[darkness.js]"]
end

subgraph group_endgame["Endgame systems"]
  node_obliteration["Obliteration<br/>[obliterate.js]"]
  node_energy["Energy upgrades<br/>[energyUpgrades.js]"]
  node_energy_tree["Energy tree<br/>[energyTree.js]"]
  node_pringles["Pringles<br/>[pringles.js]"]
  node_purity["Purity<br/>[purity.js]"]
  node_instability["Instability<br/>[instability.js]"]
  node_passive_energy["Passive energy<br/>[passiveEnergy.js]"]
  node_singularity["Singularity<br/>[singularity.js]"]
end

subgraph group_persistence["Progress and saves"]
end

node_player(("Player"))
node_browser(("Browser"))

node_player -->|"plays in"| node_browser
node_browser -.->|"starts"| node_main
node_main -->|"runs"| node_ticks
node_main -.->|"refreshes"| node_update
node_main -.->|"initializes UI"| node_tabs
node_main -.->|"updates"| node_achievements
node_main -->|"loads progress"| node_player
node_player -->|"grows ordinals"| node_markup
node_markup -.->|"offers upgrades"| node_factor_ui
node_ticks -->|"dispatches unlocks"| node_boosters
node_boosters -.->|"unlocks features"| node_challenges
node_boosters -.->|"unlocks features"| node_incrementy
node_boosters -.->|"unlocks features"| node_hierarchies
node_boosters -.->|"unlocks features"| node_automation
node_boosters -.->|"unlocks features"| node_overflow
node_player -->|"prestiges at"| node_collapse
node_collapse -->|"unlocks"| node_darkness
node_player -->|"prestiges at"| node_obliteration
node_obliteration -.->|"spends energy on"| node_energy
node_energy -.->|"organizes upgrades"| node_energy_tree
node_obliteration -.->|"unlocks"| node_pringles
node_obliteration -.->|"unlocks"| node_purity
node_obliteration -.->|"unlocks"| node_instability
node_obliteration -.->|"supports"| node_passive_energy
node_player -->|"progresses to"| node_singularity
node_markup -->|"calculates gains"| node_ordinal_math
node_markup -->|"renders ordinal"| node_ordinal_display
node_ordinal_display -.->|"uses marks"| node_ordinary_marks
node_ordinal_display -.->|"uses marks"| node_bms_marks
node_ordinal_display -.->|"uses marks"| node_veblen_marks
node_ordinal_math -.->|"calculates with"| node_hardy
node_markup -.->|"uses arithmetic"| node_decimal
node_ordinal_math -.->|"uses arithmetic"| node_expanta
node_ordinal_display -.->|"formats values"| node_number_format
node_player -->|"saves locally"| node_browser
node_browser -.->|"syncs optional cloud save"| node_player

click node_main "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/main.js"
click node_ticks "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/update/tick.js"
click node_update "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/update/update.js"
click node_tabs "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/helpers/tabs.js"
click node_achievements "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/minor/achievements.js"
click node_markup "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/markup/markup.js"
click node_factor_ui "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/markup/factors.js"
click node_boosters "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/boosters.js"
click node_challenges "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/challenges.js"
click node_incrementy "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/incrementy.js"
click node_hierarchies "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/hierarchies.js"
click node_automation "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/automation.js"
click node_overflow "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/overflow.js"
click node_collapse "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/collapse/collapse.js"
click node_darkness "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/collapse/darkness.js"
click node_ordinal_math "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/ordinal.js"
click node_ordinal_display "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/ordinalDisplay.js"
click node_ordinary_marks "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/ordMarks.js"
click node_bms_marks "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/bmsOrdMarks.js"
click node_veblen_marks "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/veblenOrdMarks.js"
click node_hardy "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/hardy.js"
click node_decimal "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/lib/BreakEternity.js"
click node_expanta "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/lib/ExpantaNum.js"
click node_number_format "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/lib/FormatExpantanum.js"
click node_obliteration "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/obliterate.js"
click node_energy "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/energyUpgrades.js"
click node_energy_tree "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/energyTree.js"
click node_pringles "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/pringles.js"
click node_purity "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/purity.js"
click node_instability "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/instability.js"
click node_passive_energy "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/passiveEnergy.js"
click node_singularity "https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/collapse/singularity.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_main,node_ticks,node_update,node_tabs,node_achievements,node_browser toneBlue
class node_ordinal_math,node_ordinal_display,node_ordinary_marks,node_bms_marks,node_veblen_marks,node_hardy,node_decimal,node_expanta,node_number_format toneAmber
class node_markup,node_factor_ui,node_boosters,node_challenges,node_incrementy,node_hierarchies,node_automation,node_overflow,node_collapse,node_darkness toneMint
class node_obliteration,node_energy,node_energy_tree,node_pringles,node_purity,node_instability,node_passive_energy,node_singularity toneRose
class node_player toneIndigo
```

## Components

### Game runtime

- [Startup and loop](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/main.js): `src/main.js`
- [Tick processing](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/update/tick.js): `src/update/tick.js`
- [UI updates](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/update/update.js): `src/update/update.js`
- [Navigation](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/helpers/tabs.js): `src/helpers/tabs.js`
- [Achievements](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/minor/achievements.js): `src/minor/achievements.js`

### Ordinal engine

- [Ordinal calculations](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/ordinal.js): `src/ordinal/ordinal.js`
- [Ordinal display](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/ordinalDisplay.js): `src/ordinal/ordinalDisplay.js`
- [Ordinal marks](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/ordMarks.js): `src/ordinal/ordMarks.js`
- [BMS marks](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/bmsOrdMarks.js): `src/ordinal/bmsOrdMarks.js`
- [Veblen marks](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/veblenOrdMarks.js): `src/ordinal/veblenOrdMarks.js`
- [Hardy calculations](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/ordinal/hardy.js): `src/ordinal/hardy.js`
- [Large-number arithmetic](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/lib/BreakEternity.js): `src/lib/BreakEternity.js`
- [Hyper-number arithmetic](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/lib/ExpantaNum.js): `src/lib/ExpantaNum.js`
- [Number formatting](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/lib/FormatExpantanum.js): `src/lib/FormatExpantanum.js`

### Progression layers

- [Markup and factors](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/markup/markup.js): `src/markup/markup.js`
- [Factor upgrades](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/markup/factors.js): `src/markup/factors.js`
- [Boosters](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/boosters.js): `src/boosters/boosters.js`
- [Challenges](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/challenges.js): `src/boosters/challenges.js`
- [Incrementy](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/incrementy.js): `src/boosters/incrementy.js`
- [Hierarchies](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/hierarchies.js): `src/boosters/hierarchies.js`
- [Automation](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/automation.js): `src/boosters/automation.js`
- [Overflow](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/boosters/overflow.js): `src/boosters/overflow.js`
- [Collapse](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/collapse/collapse.js): `src/collapse/collapse.js`
- [Darkness](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/collapse/darkness.js): `src/collapse/darkness.js`

### Endgame systems

- [Obliteration](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/obliterate.js): `src/obliterate/obliterate.js`
- [Energy upgrades](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/energyUpgrades.js): `src/obliterate/energyUpgrades.js`
- [Energy tree](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/energyTree.js): `src/obliterate/energyTree.js`
- [Pringles](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/pringles.js): `src/obliterate/pringles.js`
- [Purity](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/purity.js): `src/obliterate/purity.js`
- [Instability](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/instability.js): `src/obliterate/instability.js`
- [Passive energy](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/obliterate/passiveEnergy.js): `src/obliterate/passiveEnergy.js`
- [Singularity](https://github.com/marchbeta2087/ordinal-pringles/blob/main/src/collapse/singularity.js): `src/collapse/singularity.js`

### Other components

- **Player**
- **Browser**

## Connections

- Player → Browser: plays in (evidence: `README.md`)
- Browser → Startup and loop: starts
- Startup and loop → Tick processing: runs (evidence: `src/main.js`)
- Startup and loop → UI updates: refreshes
- Startup and loop → Navigation: initializes UI
- Startup and loop → Achievements: updates
- Startup and loop → Player: loads progress (evidence: `README.md`)
- Player → Markup and factors: grows ordinals (evidence: `README.md`)
- Markup and factors → Factor upgrades: offers upgrades
- Tick processing → Boosters: dispatches unlocks (evidence: `src/update/tick.js`)
- Boosters → Challenges: unlocks features
- Boosters → Incrementy: unlocks features
- Boosters → Hierarchies: unlocks features
- Boosters → Automation: unlocks features
- Boosters → Overflow: unlocks features
- Player → Collapse: prestiges at (evidence: `README.md`)
- Collapse → Darkness: unlocks (evidence: `src/collapse/collapse.js`)
- Player → Obliteration: prestiges at (evidence: `README.md`)
- Obliteration → Energy upgrades: spends energy on
- Energy upgrades → Energy tree: organizes upgrades
- Obliteration → Pringles: unlocks
- Obliteration → Purity: unlocks
- Obliteration → Instability: unlocks
- Obliteration → Passive energy: supports
- Player → Singularity: progresses to (evidence: `README.md`)
- Markup and factors → Ordinal calculations: calculates gains (evidence: `src/markup/markup.js`)
- Markup and factors → Ordinal display: renders ordinal (evidence: `src/markup/markup.js`)
- Ordinal display → Ordinal marks: uses marks
- Ordinal display → BMS marks: uses marks
- Ordinal display → Veblen marks: uses marks
- Ordinal calculations → Hardy calculations: calculates with
- Markup and factors → Large-number arithmetic: uses arithmetic
- Ordinal calculations → Hyper-number arithmetic: uses arithmetic
- Ordinal display → Number formatting: formats values
- Player → Browser: saves locally (evidence: `README.md`)
- Browser → Player: syncs optional cloud save (evidence: `README.md`)
