# wirosmango/huegrad-site architecture

> Architecture diagram of the GitHub repository wirosmango/huegrad-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wirosmango/huegrad-site
- Repository: https://github.com/wirosmango/huegrad-site

## Overview

Huegrad is a static official website for a Minecraft server. Its visible repository spans informational pages, community features, downloadable mods, and music playback; the README does not describe a more detailed user journey. The forum supports topic creation, live post display, posting, and likes; article comments use a separate live comment flow. HTML page wiring was not sampled, so links between pages and scripts are omitted. The player’s track-data fetch and the sampled Firebase relationships are shown where evidenced.

Main entry points: [`forum.js`](https://github.com/wirosmango/huegrad-site/blob/main/forum.js) (Topics and posts), [`comments.js`](https://github.com/wirosmango/huegrad-site/blob/main/comments.js) (Article comments), [`player.js`](https://github.com/wirosmango/huegrad-site/blob/main/player.js) (Audio player), [`firebase-config.js`](https://github.com/wirosmango/huegrad-site/blob/main/firebase-config.js) (Firebase setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site content"]
  node_homepage["Home page<br/>[index.html]"]
  node_news["News pages<br/>[news.html]"]
  node_news_articles["News articles"]
  node_history["Server history<br/>[history.html]"]
  node_education["Education page<br/>[obrazovanie.html]"]
  node_navigation["Navigation menu<br/>[nav.js]"]
  node_relative_times["Relative publish times<br/>[time-pub.js]"]
  node_cursor_cat["Cursor-following cat<br/>[oneko.js]"]
end

subgraph group_community["Community"]
  node_forum_ui["Forum page<br/>[forum.html]"]
  node_forum_logic["Topics and posts<br/>[forum.js]"]
  node_comments_logic["Article comments<br/>[comments.js]"]
  node_firebase_config["Firebase setup<br/>[firebase-config.js]"]
end

subgraph group_media["Media"]
  node_music_page["Music page<br/>[drochka.html]"]
  node_player["Audio player<br/>[player.js]"]
  node_track_data["Track listing<br/>[tracks.json]"]
  node_audio_files["Audio tracks"]
end

subgraph group_server["Server resources"]
  node_mods_page["Mods catalog<br/>[index.html]"]
  node_mod_files["Mod downloads"]
  node_world_page["World page<br/>[index.html]"]
end

node_visitor(("Site visitor"))
node_firestore[("Cloud Firestore")]
node_firebase_auth["Firebase Auth"]

node_visitor -->|"visits"| node_homepage
node_forum_logic -->|"uses config"| node_firebase_config
node_forum_logic -->|"reads and writes"| node_firestore
node_forum_logic -->|"authenticates"| node_firebase_auth
node_comments_logic -->|"uses config"| node_firebase_config
node_comments_logic -->|"reads and writes"| node_firestore
node_player -->|"fetches"| node_track_data
node_player -->|"plays tracks"| node_audio_files

click node_homepage "https://github.com/wirosmango/huegrad-site/blob/main/index.html"
click node_news "https://github.com/wirosmango/huegrad-site/blob/main/news.html"
click node_news_articles "https://github.com/wirosmango/huegrad-site/tree/main/news-pages"
click node_history "https://github.com/wirosmango/huegrad-site/blob/main/history.html"
click node_education "https://github.com/wirosmango/huegrad-site/blob/main/obrazovanie.html"
click node_forum_ui "https://github.com/wirosmango/huegrad-site/blob/main/forum.html"
click node_forum_logic "https://github.com/wirosmango/huegrad-site/blob/main/forum.js"
click node_comments_logic "https://github.com/wirosmango/huegrad-site/blob/main/comments.js"
click node_firebase_config "https://github.com/wirosmango/huegrad-site/blob/main/firebase-config.js"
click node_music_page "https://github.com/wirosmango/huegrad-site/blob/main/drochka.html"
click node_player "https://github.com/wirosmango/huegrad-site/blob/main/player.js"
click node_track_data "https://github.com/wirosmango/huegrad-site/blob/main/tracks.json"
click node_audio_files "https://github.com/wirosmango/huegrad-site/tree/main/tracks"
click node_mods_page "https://github.com/wirosmango/huegrad-site/blob/main/mods/index.html"
click node_mod_files "https://github.com/wirosmango/huegrad-site/tree/main/mods/files"
click node_world_page "https://github.com/wirosmango/huegrad-site/blob/main/mods/world/index.html"
click node_navigation "https://github.com/wirosmango/huegrad-site/blob/main/nav.js"
click node_relative_times "https://github.com/wirosmango/huegrad-site/blob/main/time-pub.js"
click node_cursor_cat "https://github.com/wirosmango/huegrad-site/blob/main/oneko.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_homepage,node_news,node_news_articles,node_history,node_education,node_navigation,node_relative_times,node_cursor_cat toneBlue
class node_forum_ui,node_forum_logic,node_comments_logic,node_firebase_config,node_firestore toneAmber
class node_music_page,node_player,node_track_data,node_audio_files toneMint
class node_mods_page,node_mod_files,node_world_page toneRose
class node_visitor,node_firebase_auth toneIndigo
```

## Components

### Site content

- [Home page](https://github.com/wirosmango/huegrad-site/blob/main/index.html): `index.html`
- [News pages](https://github.com/wirosmango/huegrad-site/blob/main/news.html): `news.html`
- [News articles](https://github.com/wirosmango/huegrad-site/tree/main/news-pages): `news-pages`
- [Server history](https://github.com/wirosmango/huegrad-site/blob/main/history.html): `history.html`
- [Education page](https://github.com/wirosmango/huegrad-site/blob/main/obrazovanie.html): `obrazovanie.html`
- [Navigation menu](https://github.com/wirosmango/huegrad-site/blob/main/nav.js): `nav.js`
- [Relative publish times](https://github.com/wirosmango/huegrad-site/blob/main/time-pub.js): `time-pub.js`
- [Cursor-following cat](https://github.com/wirosmango/huegrad-site/blob/main/oneko.js): `oneko.js`

### Community

- [Forum page](https://github.com/wirosmango/huegrad-site/blob/main/forum.html): `forum.html`
- [Topics and posts](https://github.com/wirosmango/huegrad-site/blob/main/forum.js): `forum.js`
- [Article comments](https://github.com/wirosmango/huegrad-site/blob/main/comments.js): `comments.js`
- [Firebase setup](https://github.com/wirosmango/huegrad-site/blob/main/firebase-config.js): `firebase-config.js`

### Media

- [Music page](https://github.com/wirosmango/huegrad-site/blob/main/drochka.html): `drochka.html`
- [Audio player](https://github.com/wirosmango/huegrad-site/blob/main/player.js): `player.js`
- [Track listing](https://github.com/wirosmango/huegrad-site/blob/main/tracks.json): `tracks.json`
- [Audio tracks](https://github.com/wirosmango/huegrad-site/tree/main/tracks): `tracks`

### Server resources

- [Mods catalog](https://github.com/wirosmango/huegrad-site/blob/main/mods/index.html): `mods/index.html`
- [Mod downloads](https://github.com/wirosmango/huegrad-site/tree/main/mods/files): `mods/files`
- [World page](https://github.com/wirosmango/huegrad-site/blob/main/mods/world/index.html): `mods/world/index.html`

### Other components

- **Site visitor**
- **Cloud Firestore**
- **Firebase Auth**

## Connections

- Site visitor → Home page: visits (evidence: `README.md`)
- Topics and posts → Firebase setup: uses config (evidence: `forum.js`)
- Topics and posts → Cloud Firestore: reads and writes (evidence: `forum.js`)
- Topics and posts → Firebase Auth: authenticates (evidence: `forum.js`)
- Article comments → Firebase setup: uses config (evidence: `comments.js`)
- Article comments → Cloud Firestore: reads and writes (evidence: `comments.js`)
- Audio player → Track listing: fetches (evidence: `player.js`)
- Audio player → Audio tracks: plays tracks (evidence: `player.js`)
