# bearlessdev/cookie-clicker architecture

> Architecture diagram of the GitHub repository bearlessdev/cookie-clicker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bearlessdev/cookie-clicker
- Repository: https://github.com/bearlessdev/cookie-clicker

## Overview

This appears to be a Godot incremental clicking game: the filenames suggest a cookie-and-points loop with upgrades, persistence, and Discord presence. The tree also shows splash and main scenes. No README or source excerpts were provided, so those capabilities and their wiring cannot be confirmed; the graph therefore shows the identifiable runtime components without speculative call or data-flow edges.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup"]
  node_splash_scene["Splash scene<br/>[boot_splash.tscn]"]
  node_splash_script["Splash logic<br/>[boot_splash.gd]"]
end

subgraph group_gameplay["Gameplay"]
  node_main_scene["Main scene<br/>[main.tscn]"]
  node_nested_main_scene["Nested main scene<br/>[main.tscn]"]
  node_main_script["Main logic<br/>[main.gd]"]
  node_nested_main_script["Nested main logic<br/>[main.gd]"]
  node_cookie_logic["Cookie logic<br/>[cookie.gd]"]
  node_points_logic["Points logic<br/>[points.gd]"]
end

subgraph group_progression["Progression"]
  node_upgrade_list["Upgrade list<br/>[upgrade_list.gd]"]
  node_upgrade_card_scene["Upgrade card scene<br/>[upgrade_card.tscn]"]
  node_upgrade_card_script["Upgrade card logic<br/>[upgrade_card.gd]"]
  node_nested_upgrade_card_script["Nested card logic<br/>[upgrade_card.gd]"]
end

subgraph group_services["Persistence and presence"]
  node_save_manager["Save manager<br/>[save_manager.gd]"]
  node_data_setup["Data folder setup"]
  node_discord_rpc["Discord presence<br/>[discord_rpc.gd]"]
end

node_player(("Player"))

click node_splash_scene "https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/boot_splash.tscn"
click node_splash_script "https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/boot_splash.gd"
click node_main_scene "https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main.tscn"
click node_nested_main_scene "https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main/main.tscn"
click node_main_script "https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/main.gd"
click node_nested_main_script "https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main/main.gd"
click node_cookie_logic "https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/cookie.gd"
click node_points_logic "https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/points.gd"
click node_upgrade_list "https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main/upgrade_list.gd"
click node_upgrade_card_scene "https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/upgrade_card.tscn"
click node_upgrade_card_script "https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/upgrade_card.gd"
click node_nested_upgrade_card_script "https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/upgrade_card.gd"
click node_save_manager "https://github.com/bearlessdev/cookie-clicker/blob/main/data/save_manager.gd"
click node_data_setup "https://github.com/bearlessdev/cookie-clicker/blob/main/data/auto_create_data_folder.gd"
click node_discord_rpc "https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/discord_rpc.gd"

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_splash_scene,node_splash_script toneBlue
class node_main_scene,node_nested_main_scene,node_main_script,node_nested_main_script,node_cookie_logic,node_points_logic toneAmber
class node_upgrade_list,node_upgrade_card_scene,node_upgrade_card_script,node_nested_upgrade_card_script toneMint
class node_save_manager,node_data_setup,node_discord_rpc toneRose
class node_player toneIndigo
```

## Components

### Startup

- [Splash scene](https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/boot_splash.tscn): `scenes/boot_splash.tscn`
- [Splash logic](https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/boot_splash.gd): `scripts/boot_splash.gd`

### Gameplay

- [Main scene](https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main.tscn): `scenes/main.tscn`
- [Nested main scene](https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main/main.tscn): `scenes/main/main.tscn`
- [Main logic](https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/main.gd): `scripts/main.gd`
- [Nested main logic](https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main/main.gd): `scenes/main/main.gd`
- [Cookie logic](https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/cookie.gd): `scripts/cookie.gd`
- [Points logic](https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/points.gd): `scripts/points.gd`

### Progression

- [Upgrade list](https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/main/upgrade_list.gd): `scenes/main/upgrade_list.gd`
- [Upgrade card scene](https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/upgrade_card.tscn): `scenes/upgrade_card.tscn`
- [Upgrade card logic](https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/upgrade_card.gd): `scripts/upgrade_card.gd`
- [Nested card logic](https://github.com/bearlessdev/cookie-clicker/blob/main/scenes/upgrade_card.gd): `scenes/upgrade_card.gd`

### Persistence and presence

- [Save manager](https://github.com/bearlessdev/cookie-clicker/blob/main/data/save_manager.gd): `data/save_manager.gd`
- [Data folder setup](https://github.com/bearlessdev/cookie-clicker/blob/main/data/auto_create_data_folder.gd): `data/auto_create_data_folder.gd`
- [Discord presence](https://github.com/bearlessdev/cookie-clicker/blob/main/scripts/discord_rpc.gd): `scripts/discord_rpc.gd`

### Other components

- **Player**