# pablosazycz/ski-escape architecture

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

- Interactive diagram: https://gitdiagram.com/pablosazycz/ski-escape
- Repository: https://github.com/pablosazycz/ski-escape

## Overview

Ski Escape is a browser and Android arcade skiing game. The player steers through a run, collecting coins and power-ups while avoiding obstacles and escaping the Yeti; run outcomes feed profile progression, shop, quests, and replay. The main game module also coordinates translation, sound, and ads. The excerpts show those integrations and secure local storage, but do not expose all gameplay or persistence call sites, so some feature-level relationships are omitted rather than inferred.

Main entry points: [`main.js`](https://github.com/pablosazycz/ski-escape/blob/main/main.js) (Menus and controls), [`ads.js`](https://github.com/pablosazycz/ski-escape/blob/main/ads.js) (Ad manager), [`security.js`](https://github.com/pablosazycz/ski-escape/blob/main/security.js) (Data integrity), [`i18n.js`](https://github.com/pablosazycz/ski-escape/blob/main/i18n.js) (Translations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Game and progression"]
  node_game["Run simulation<br/>[main.js]"]
  node_render["Game rendering<br/>[main.js]"]
  node_progress["Profile and records<br/>[main.js]"]
  node_shop["Shop and skins<br/>[main.js]"]
  node_quests["Daily quests<br/>[main.js]"]
end

subgraph group_interface["Interface and localization"]
  node_menus["Menus and controls<br/>[main.js]"]
  node_translations["Translations<br/>[i18n.js]"]
end

subgraph group_services["Game services"]
  node_audio["Procedural audio<br/>[sound.js]"]
  node_admanager["Ad manager<br/>[ads.js]"]
  node_security["Data integrity<br/>[security.js]"]
  node_storage[("Browser storage")]
end

subgraph group_platform["Platform runtime"]
  node_android["Android host<br/>[MainActivity.java]"]
  node_capacitor["Capacitor runtime"]
end

node_player(("Player"))
node_admob["Google AdMob"]

node_player -->|"uses controls"| node_menus
node_menus -->|"starts and pauses"| node_game
node_game -->|"draws state"| node_render
node_game -->|"updates profile"| node_progress
node_progress -->|"updates shop UI"| node_shop
node_progress -->|"updates quest UI"| node_quests
node_menus -->|"toggles language"| node_translations
node_menus -->|"applies translations"| node_translations
node_game -->|"plays reward sound"| node_audio
node_menus -->|"toggles mute"| node_audio
node_menus -->|"hides banner"| node_admanager
node_game -.->|"uses integrity module"| node_security
node_security -->|"reads and writes"| node_storage
node_android -->|"extends bridge"| node_capacitor
node_admanager -->|"loads and shows ads"| node_admob

click node_game "https://github.com/pablosazycz/ski-escape/blob/main/main.js"
click node_render "https://github.com/pablosazycz/ski-escape/blob/main/main.js"
click node_progress "https://github.com/pablosazycz/ski-escape/blob/main/main.js"
click node_shop "https://github.com/pablosazycz/ski-escape/blob/main/main.js"
click node_quests "https://github.com/pablosazycz/ski-escape/blob/main/main.js"
click node_menus "https://github.com/pablosazycz/ski-escape/blob/main/main.js"
click node_translations "https://github.com/pablosazycz/ski-escape/blob/main/i18n.js"
click node_audio "https://github.com/pablosazycz/ski-escape/blob/main/sound.js"
click node_admanager "https://github.com/pablosazycz/ski-escape/blob/main/ads.js"
click node_security "https://github.com/pablosazycz/ski-escape/blob/main/security.js"
click node_android "https://github.com/pablosazycz/ski-escape/blob/main/android/app/src/main/java/com/skiescape/game/MainActivity.java"

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_game,node_render,node_progress,node_shop,node_quests toneBlue
class node_menus,node_translations toneAmber
class node_audio,node_admanager,node_security,node_storage toneMint
class node_android,node_capacitor toneRose
class node_player,node_admob toneIndigo
```

## Components

### Game and progression

- [Run simulation](https://github.com/pablosazycz/ski-escape/blob/main/main.js): `main.js`
- [Game rendering](https://github.com/pablosazycz/ski-escape/blob/main/main.js): `main.js`
- [Profile and records](https://github.com/pablosazycz/ski-escape/blob/main/main.js): `main.js`
- [Shop and skins](https://github.com/pablosazycz/ski-escape/blob/main/main.js): `main.js`
- [Daily quests](https://github.com/pablosazycz/ski-escape/blob/main/main.js): `main.js`

### Interface and localization

- [Menus and controls](https://github.com/pablosazycz/ski-escape/blob/main/main.js): `main.js`
- [Translations](https://github.com/pablosazycz/ski-escape/blob/main/i18n.js): `i18n.js`

### Game services

- [Procedural audio](https://github.com/pablosazycz/ski-escape/blob/main/sound.js): `sound.js`
- [Ad manager](https://github.com/pablosazycz/ski-escape/blob/main/ads.js): `ads.js`
- [Data integrity](https://github.com/pablosazycz/ski-escape/blob/main/security.js): `security.js`
- **Browser storage**

### Platform runtime

- [Android host](https://github.com/pablosazycz/ski-escape/blob/main/android/app/src/main/java/com/skiescape/game/MainActivity.java): `android/app/src/main/java/com/skiescape/game/MainActivity.java`
- **Capacitor runtime**

### Other components

- **Player**
- **Google AdMob**

## Connections

- Player → Menus and controls: uses controls (evidence: `main.js`)
- Menus and controls → Run simulation: starts and pauses (evidence: `main.js`)
- Run simulation → Game rendering: draws state (evidence: `main.js`)
- Run simulation → Profile and records: updates profile (evidence: `main.js`)
- Profile and records → Shop and skins: updates shop UI (evidence: `main.js`)
- Profile and records → Daily quests: updates quest UI (evidence: `main.js`)
- Menus and controls → Translations: toggles language (evidence: `main.js`)
- Menus and controls → Translations: applies translations (evidence: `main.js`)
- Run simulation → Procedural audio: plays reward sound (evidence: `main.js`)
- Menus and controls → Procedural audio: toggles mute (evidence: `main.js`)
- Menus and controls → Ad manager: hides banner (evidence: `main.js`)
- Run simulation → Data integrity: uses integrity module (evidence: `main.js`)
- Data integrity → Browser storage: reads and writes (evidence: `security.js`)
- Android host → Capacitor runtime: extends bridge (evidence: `android/app/src/main/java/com/skiescape/game/MainActivity.java`)
- Ad manager → Google AdMob: loads and shows ads (evidence: `ads.js`)
