# gmdavisux/gmdavisux.github.io architecture

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

- Interactive diagram: https://gitdiagram.com/gmdavisux/gmdavisux.github.io
- Repository: https://github.com/gmdavisux/gmdavisux.github.io

## Overview

This is a static portfolio site: visitors browse project collections and page-specific case studies, with testimonials and image overlays as supporting experiences. The browser app loads collection JSON, builds navigation tiles, and fetches page fragments. A separate local admin capability is present in the tree and README, but its runtime wiring is not shown in the excerpts; its relationship to the public site is therefore left unconnected. Edges reflect excerpted calls or explicit README statements.

Main entry points: [`js/app.js`](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/app.js) (App bootstrap), [`js/modules/collections.js`](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/collections.js) (Collection loader), [`js/modules/content-loader.js`](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/content-loader.js) (Page loader), [`js/modules/router.js`](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/router.js) (URL routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio experience"]
  node_shell["HTML shell<br/>[index.html]"]
  node_app["App bootstrap<br/>[app.js]"]
  node_router["URL routing<br/>[router.js]"]
  node_collections["Collection loader<br/>[collections.js]"]
  node_templates["Tile rendering<br/>[templates.js]"]
  node_validation["Collection validation<br/>[validate.js]"]
  node_navigation["Navigation behavior<br/>[navigation.js]"]
  node_contact["Contact links<br/>[contact.js]"]
  node_overlay["Image overlay<br/>[overlay.js]"]
  node_content_loader["Page loader<br/>[content-loader.js]"]
end

subgraph group_content["Portfolio content"]
  node_collections_data["Collection JSON<br/>[projects.json]"]
  node_page_fragments["Case-study fragments"]
  node_testimonials["Testimonials renderer<br/>[testimonials.js]"]
  node_testimonials_data["Testimonials JSON<br/>[testimonials.json]"]
end

subgraph group_admin["Local administration"]
  node_admin["Admin dashboard"]
end

node_visitor(("Site visitor"))

node_visitor -->|"opens"| node_shell
node_app -->|"reads route"| node_router
node_app -->|"loads collection"| node_collections
node_app -->|"initializes overlay"| node_overlay
node_app -->|"loads content"| node_content_loader
node_app -->|"updates links"| node_navigation
node_app -->|"updates contacts"| node_contact
node_collections -->|"gets collection URL"| node_router
node_collections -->|"renders tiles"| node_templates
node_collections -->|"validates data"| node_validation
node_collections -->|"fetches JSON"| node_collections_data
node_content_loader -->|"gets page route"| node_router
node_content_loader -->|"fetches fragment"| node_page_fragments
node_content_loader -->|"wires images"| node_overlay
node_content_loader -->|"renders recommendations"| node_testimonials
node_testimonials -->|"fetches JSON"| node_testimonials_data
node_visitor -->|"uses locally"| node_admin

click node_shell "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/index.html"
click node_app "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/app.js"
click node_router "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/router.js"
click node_collections "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/collections.js"
click node_templates "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/templates.js"
click node_validation "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/validate.js"
click node_navigation "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/navigation.js"
click node_contact "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/contact.js"
click node_overlay "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/overlay.js"
click node_content_loader "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/content-loader.js"
click node_collections_data "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/projects.json"
click node_page_fragments "https://github.com/gmdavisux/gmdavisux.github.io/tree/main/pages"
click node_testimonials "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/testimonials.js"
click node_testimonials_data "https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/testimonials.json"
click node_admin "https://github.com/gmdavisux/gmdavisux.github.io/tree/main/tools/admin"

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_shell,node_app,node_router,node_collections,node_templates,node_validation,node_navigation,node_contact,node_overlay,node_content_loader toneBlue
class node_collections_data,node_page_fragments,node_testimonials,node_testimonials_data toneAmber
class node_admin toneMint
class node_visitor toneIndigo
```

## Components

### Portfolio experience

- [HTML shell](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/index.html): `index.html`
- [App bootstrap](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/app.js): `js/app.js`
- [URL routing](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/router.js): `js/modules/router.js`
- [Collection loader](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/collections.js): `js/modules/collections.js`
- [Tile rendering](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/templates.js): `js/modules/templates.js`
- [Collection validation](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/validate.js): `js/modules/validate.js`
- [Navigation behavior](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/navigation.js): `js/modules/navigation.js`
- [Contact links](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/contact.js): `js/modules/contact.js`
- [Image overlay](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/overlay.js): `js/modules/overlay.js`
- [Page loader](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/content-loader.js): `js/modules/content-loader.js`

### Portfolio content

- [Collection JSON](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/projects.json): `js/projects.json`
- [Case-study fragments](https://github.com/gmdavisux/gmdavisux.github.io/tree/main/pages): `pages`
- [Testimonials renderer](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/modules/testimonials.js): `js/modules/testimonials.js`
- [Testimonials JSON](https://github.com/gmdavisux/gmdavisux.github.io/blob/main/js/testimonials.json): `js/testimonials.json`

### Local administration

- [Admin dashboard](https://github.com/gmdavisux/gmdavisux.github.io/tree/main/tools/admin): `tools/admin`

### Other components

- **Site visitor**

## Connections

- Site visitor → HTML shell: opens (evidence: `README.md`)
- App bootstrap → URL routing: reads route (evidence: `js/app.js`)
- App bootstrap → Collection loader: loads collection (evidence: `js/app.js`)
- App bootstrap → Image overlay: initializes overlay (evidence: `js/app.js`)
- App bootstrap → Page loader: loads content (evidence: `js/app.js`)
- App bootstrap → Navigation behavior: updates links (evidence: `js/app.js`)
- App bootstrap → Contact links: updates contacts (evidence: `js/app.js`)
- Collection loader → URL routing: gets collection URL (evidence: `js/modules/collections.js`)
- Collection loader → Tile rendering: renders tiles (evidence: `js/modules/collections.js`)
- Collection loader → Collection validation: validates data (evidence: `js/modules/collections.js`)
- Collection loader → Collection JSON: fetches JSON (evidence: `js/modules/collections.js`)
- Page loader → URL routing: gets page route (evidence: `js/modules/content-loader.js`)
- Page loader → Case-study fragments: fetches fragment (evidence: `js/modules/content-loader.js`)
- Page loader → Image overlay: wires images (evidence: `js/modules/content-loader.js`)
- Page loader → Testimonials renderer: renders recommendations (evidence: `js/modules/content-loader.js`)
- Testimonials renderer → Testimonials JSON: fetches JSON (evidence: `js/modules/testimonials.js`)
- Site visitor → Admin dashboard: uses locally (evidence: `README.md`)
