# brightselva/hb-kak architecture

> Architecture diagram of the GitHub repository brightselva/hb-kak, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-08-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brightselva/hb-kak
- Repository: https://github.com/brightselva/hb-kak

## Overview

#### Purpose and Entry Points
HB-KAK is a static browser-based project with no visible backend, package manifest, or build system. The primary entry point is `index.html`; two additional standalone map-oriented pages, `adventure-map.html` and `adventure-map-opt.html`, likely provide alternate or optimized experiences.

#### Static Delivery Boundary
All application behavior must be delivered directly by browser-loaded HTML and any inline or externally referenced assets defined within those documents. There is no repository evidence of server-side code, API layer, database, deployment configuration, or dependency management.

Grounding paths:
- `index.html`
- `adventure-map.html`
- `adventure-map-opt.html`

#### Primary Experience Shell
`index.html` is the likely default landing or application shell. It should be treated as the top-level navigation/control boundary from which users reach the main experience or map views.

Grounding path:
- `index.html`

#### Adventure Map Implementations
The repository contains two map pages, indicating a core interactive map feature with at least two variants:
- `adventure-map.html`: baseline map implementation.
- `adventure-map-opt.html`: likely optimized, revised, or alternate implementation.

These pages are architecturally important because they may duplicate or diverge in embedded data, rendering logic, asset usage, and interaction behavior. Changes to shared user-facing map concepts should be checked against both variants.

Grounding paths:
- `adventure-map.html`
- `adventure-map-opt.html`

#### Runtime and Control Flow
The material runtime is the web browser. Expected flow is:
1. Browser loads `index.html` or a map document directly.
2. HTML-defined scripts, styles, and referenced assets initialize the page.
3. User interactions occur client-side within the loaded document.
4. Navigation between pages uses ordinary browser document navigation unless the HTML implements another mechanism.

No external service integration can be confirmed from the supplied tree.

#### Project State Documentation
`project_status.md` is the repository’s only explicit project-state artifact and should be consulted before planning substantial changes, especially when deciding which map variant is active or preferred.

Grounding path:
- `project_status.md`

Main entry points: [`adventure-map.html`](https://github.com/brightselva/hb-kak/blob/main/adventure-map.html) (Baseline adventure map), [`adventure-map-opt.html`](https://github.com/brightselva/hb-kak/blob/main/adventure-map-opt.html) (Optimized adventure map), [`index.html`](https://github.com/brightselva/hb-kak/blob/main/index.html) (Primary shell), [`project_status.md`](https://github.com/brightselva/hb-kak/blob/main/project_status.md) (Project status)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser runtime"]
  node_browser_runtime{{"Web browser<br/>runtime"}}
  node_index["Primary shell<br/>HTML entry point<br/>[index.html]"]
  node_page_assets["Page-defined assets<br/>scripts, styles, assets"]
end

subgraph group_maps["Adventure map variants"]
  node_map_baseline["Baseline adventure map<br/>HTML map implementation<br/>[adventure-map.html]"]
  node_map_optimized["Optimized adventure map<br/>HTML map implementation"]
  node_map_interaction["Map interaction<br/>client-side behavior"]
end

node_user(("User<br/>actor"))
node_project_status["Project status<br/>project-state documentation<br/>[project_status.md]"]

node_user -->|"uses"| node_browser_runtime
node_browser_runtime -->|"loads"| node_index
node_browser_runtime -->|"loads directly"| node_map_baseline
node_browser_runtime -->|"loads directly"| node_map_optimized
node_index -->|"navigates to"| node_map_baseline
node_index -->|"navigates to"| node_map_optimized
node_index -->|"initializes from"| node_page_assets
node_map_baseline -->|"initializes from"| node_page_assets
node_map_optimized -->|"initializes from"| node_page_assets
node_map_baseline -->|"runs"| node_map_interaction
node_map_optimized -->|"runs"| node_map_interaction
node_project_status -.->|"guides planning for"| node_map_baseline
node_project_status -.->|"guides planning for"| node_map_optimized

click node_index "https://github.com/brightselva/hb-kak/blob/main/index.html"
click node_map_baseline "https://github.com/brightselva/hb-kak/blob/main/adventure-map.html"
click node_map_optimized "https://github.com/brightselva/hb-kak/blob/main/adventure-map-opt.html"
click node_project_status "https://github.com/brightselva/hb-kak/blob/main/project_status.md"

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_browser_runtime,node_index,node_page_assets toneBlue
class node_map_baseline,node_map_optimized,node_map_interaction toneAmber
class node_user,node_project_status toneNeutral
```

## Components

### Browser runtime

All behavior runs in browser-loaded documents.

- **Web browser**: runtime · Loads documents and executes client-side behavior.
- [Primary shell](https://github.com/brightselva/hb-kak/blob/main/index.html): HTML entry point · Default landing and navigation boundary. · `index.html`
- **Page-defined assets**: scripts, styles, assets · Inline or document-referenced resources initialize each page.

### Adventure map variants

Two implementations of the core map experience.

- [Baseline adventure map](https://github.com/brightselva/hb-kak/blob/main/adventure-map.html): HTML map implementation · Core interactive map variant. · `adventure-map.html`
- [Optimized adventure map](https://github.com/brightselva/hb-kak/blob/main/adventure-map-opt.html): HTML map implementation · Alternate or revised map variant. · `adventure-map-opt.html`
- **Map interaction**: client-side behavior · Rendering and user interaction execute within the loaded map document.

### Other components

- **User**: actor
- [Project status](https://github.com/brightselva/hb-kak/blob/main/project_status.md): project-state documentation · Consult before choosing the active or preferred map variant. · `project_status.md`

## Connections

- User → Web browser: uses
- Web browser → Primary shell: loads
- Web browser → Baseline adventure map: loads directly
- Web browser → Optimized adventure map: loads directly
- Primary shell → Baseline adventure map: navigates to
- Primary shell → Optimized adventure map: navigates to
- Primary shell → Page-defined assets: initializes from
- Baseline adventure map → Page-defined assets: initializes from
- Optimized adventure map → Page-defined assets: initializes from
- Baseline adventure map → Map interaction: runs
- Optimized adventure map → Map interaction: runs
- Project status → Baseline adventure map: guides planning for
- Project status → Optimized adventure map: guides planning for