# viv4-web/w3planner architecture

> Architecture diagram of the GitHub repository viv4-web/w3planner, 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/viv4-web/w3planner
- Repository: https://github.com/viv4-web/w3planner

## Overview

Build Planner is a browser-based Witcher 3 character-build planner. A user configures skills, mutations, equipment and consumables, then shares or bookmarks the resulting build link; the README says build state is stored in the link and the offline version uses the same application code. The graph retains the major application areas and data modules visible in the tree. Source excerpts show little front-end wiring, so uncertain internal connections are dashed and unverified rather than inferred as calls.

Main entry points: [`src/app.js`](https://github.com/viv4-web/w3planner/blob/main/src/app.js) (Build Planner), [`src/importsave.js`](https://github.com/viv4-web/w3planner/blob/main/src/importsave.js) (Save Import), [`src/glossary.js`](https://github.com/viv4-web/w3planner/blob/main/src/glossary.js) (Game Glossary), [`src/screens.js`](https://github.com/viv4-web/w3planner/blob/main/src/screens.js) (Planner Screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planner["Build Planner"]
  node_planner_app["Build Planner<br/>[app.js]"]
  node_skill_rules["Skill Rules<br/>[TIPFN.js]"]
  node_equipment["Equipment<br/>[equipment.js]"]
  node_consumables["Consumables<br/>[consumables.js]"]
  node_share_link["Build Link"]
end

subgraph group_reference["Game Data"]
  node_build_data["Build Data"]
end

subgraph group_companion["Companion Features"]
  node_glossary["Game Glossary<br/>[glossary.js]"]
  node_save_import["Save Import<br/>[importsave.js]"]
  node_save_reader["Save Reader<br/>[saveread.js]"]
end

subgraph group_delivery["App Presentation"]
  node_screens["Planner Screens<br/>[screens.js]"]
  node_app_styles["App Styles<br/>[app.css]"]
  node_screen_styles["Screen Styles<br/>[screens.css]"]
  node_glossary_styles["Glossary Styles<br/>[glossary.css]"]
  node_import_styles["Import Styles<br/>[importsave.css]"]
  node_config["Site Config<br/>[config.js]"]
end

node_user(("Player"))

node_user -->|"configures"| node_planner_app
node_planner_app -->|"encodes build"| node_share_link
node_user -->|"shares or bookmarks"| node_share_link
node_planner_app -.->|"uses rules"| node_skill_rules
node_planner_app -.->|"uses game data"| node_build_data
node_planner_app -.->|"coordinates"| node_equipment
node_planner_app -.->|"coordinates"| node_consumables
node_planner_app -.->|"displays screens"| node_screens
node_planner_app -.->|"offers glossary"| node_glossary
node_planner_app -.->|"offers import"| node_save_import
node_save_import -.->|"uses reader"| node_save_reader
node_planner_app -.->|"styled by"| node_app_styles
node_screens -.->|"styled by"| node_screen_styles
node_glossary -.->|"styled by"| node_glossary_styles
node_save_import -.->|"styled by"| node_import_styles

click node_planner_app "https://github.com/viv4-web/w3planner/blob/main/src/app.js"
click node_skill_rules "https://github.com/viv4-web/w3planner/blob/main/data/TIPFN.js"
click node_build_data "https://github.com/viv4-web/w3planner/tree/main/data"
click node_equipment "https://github.com/viv4-web/w3planner/blob/main/src/equipment.js"
click node_consumables "https://github.com/viv4-web/w3planner/blob/main/src/consumables.js"
click node_screens "https://github.com/viv4-web/w3planner/blob/main/src/screens.js"
click node_glossary "https://github.com/viv4-web/w3planner/blob/main/src/glossary.js"
click node_save_import "https://github.com/viv4-web/w3planner/blob/main/src/importsave.js"
click node_save_reader "https://github.com/viv4-web/w3planner/blob/main/src/saveread.js"
click node_app_styles "https://github.com/viv4-web/w3planner/blob/main/src/app.css"
click node_screen_styles "https://github.com/viv4-web/w3planner/blob/main/src/screens.css"
click node_glossary_styles "https://github.com/viv4-web/w3planner/blob/main/src/glossary.css"
click node_import_styles "https://github.com/viv4-web/w3planner/blob/main/src/importsave.css"
click node_config "https://github.com/viv4-web/w3planner/blob/main/static/config.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_planner_app,node_skill_rules,node_equipment,node_consumables,node_share_link toneBlue
class node_build_data toneAmber
class node_glossary,node_save_import,node_save_reader toneMint
class node_screens,node_app_styles,node_screen_styles,node_glossary_styles,node_import_styles,node_config toneRose
class node_user toneIndigo
```

## Components

### Build Planner

- [Build Planner](https://github.com/viv4-web/w3planner/blob/main/src/app.js): `src/app.js`
- [Skill Rules](https://github.com/viv4-web/w3planner/blob/main/data/TIPFN.js): `data/TIPFN.js`
- [Equipment](https://github.com/viv4-web/w3planner/blob/main/src/equipment.js): `src/equipment.js`
- [Consumables](https://github.com/viv4-web/w3planner/blob/main/src/consumables.js): `src/consumables.js`
- **Build Link**

### Game Data

- [Build Data](https://github.com/viv4-web/w3planner/tree/main/data): `data`

### Companion Features

- [Game Glossary](https://github.com/viv4-web/w3planner/blob/main/src/glossary.js): `src/glossary.js`
- [Save Import](https://github.com/viv4-web/w3planner/blob/main/src/importsave.js): `src/importsave.js`
- [Save Reader](https://github.com/viv4-web/w3planner/blob/main/src/saveread.js): `src/saveread.js`

### App Presentation

- [Planner Screens](https://github.com/viv4-web/w3planner/blob/main/src/screens.js): `src/screens.js`
- [App Styles](https://github.com/viv4-web/w3planner/blob/main/src/app.css): `src/app.css`
- [Screen Styles](https://github.com/viv4-web/w3planner/blob/main/src/screens.css): `src/screens.css`
- [Glossary Styles](https://github.com/viv4-web/w3planner/blob/main/src/glossary.css): `src/glossary.css`
- [Import Styles](https://github.com/viv4-web/w3planner/blob/main/src/importsave.css): `src/importsave.css`
- [Site Config](https://github.com/viv4-web/w3planner/blob/main/static/config.js): `static/config.js`

### Other components

- **Player**

## Connections

- Player → Build Planner: configures (evidence: `README.md`)
- Build Planner → Build Link: encodes build (evidence: `README.md`)
- Player → Build Link: shares or bookmarks (evidence: `README.md`)
- Build Planner → Skill Rules: uses rules
- Build Planner → Build Data: uses game data
- Build Planner → Equipment: coordinates
- Build Planner → Consumables: coordinates
- Build Planner → Planner Screens: displays screens
- Build Planner → Game Glossary: offers glossary
- Build Planner → Save Import: offers import
- Save Import → Save Reader: uses reader
- Build Planner → App Styles: styled by
- Planner Screens → Screen Styles: styled by
- Game Glossary → Glossary Styles: styled by
- Save Import → Import Styles: styled by
