# hexvork/hexaeroglass architecture

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

- Interactive diagram: https://gitdiagram.com/hexvork/hexaeroglass
- Repository: https://github.com/hexvork/hexaeroglass

## Overview

HexAeroGlass is an Astro static-blog theme. A visitor reaches article, archive, or informational routes; the site renders Markdown content in shared layouts, with optional search, comments, and other blog features. The graph preserves documented capabilities even where their route implementations were not sampled. Source-backed links are cited; README-only behavior is cited to the README, and uncertain wiring is omitted.

Main entry points: [`src/config.ts`](https://github.com/hexvork/hexaeroglass/blob/main/src/config.ts) (Site configuration), [`src/components/Comments.astro`](https://github.com/hexvork/hexaeroglass/blob/main/src/components/Comments.astro) (Comments), [`src/content`](https://github.com/hexvork/hexaeroglass/tree/main/src/content) (Posts and pages), [`src/content.config.ts`](https://github.com/hexvork/hexaeroglass/blob/main/src/content.config.ts) (Content collections)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content and feeds"]
  node_collections[("Content collections<br/>[content.config.ts]")]
  node_postcontent["Posts and pages"]
  node_contentutils["Content utilities<br/>[content-utils.ts]"]
  node_rss["RSS feed<br/>[rss.xml.ts]"]
  node_llms["LLMs listing<br/>[llms.txt.ts]"]
end

subgraph group_routes["Site routes"]
  node_home["Home and archives<br/>[index.astro]"]
  node_postroute["Post route<br/>[&#91;slug&#93;.astro]"]
  node_categoryroutes["Category routes"]
  node_tagroutes["Tag routes"]
  node_otherpages["Informational pages"]
  node_externals["External warning page<br/>[external.astro]"]
end

subgraph group_presentation["Layouts and UI"]
  node_mainlayout["Main layout<br/>[MainLayout.astro]"]
  node_postlayout["Post layout<br/>[BlogPost.astro]"]
  node_components["Shared UI"]
  node_config["Site configuration<br/>[config.ts]"]
end

subgraph group_features["Blog features"]
  node_markdown["Markdown enhancements"]
  node_search["Local search<br/>[header.js]"]
  node_comments["Comments<br/>[Comments.astro]"]
  node_theme["Theme switching<br/>[theme-utils.ts]"]
  node_externalhandling["External link handling<br/>[link-utils.ts]"]
  node_imagefallback["Image fallback<br/>[blog-post.js]"]
  node_pagefind[("Pagefind index")]
end

node_visitor(("Site visitor"))
node_giscus["Giscus service"]
node_waline["Waline service"]
node_rssconsumer(("Feed reader"))

node_visitor -->|"opens"| node_home
node_visitor -->|"opens"| node_postroute
node_visitor -->|"browses"| node_categoryroutes
node_visitor -->|"browses"| node_tagroutes
node_visitor -->|"opens"| node_otherpages
node_postcontent -->|"loaded as"| node_collections
node_rss -->|"gets sorted posts"| node_contentutils
node_rssconsumer -->|"requests feed"| node_rss
node_llms -->|"reads site description"| node_config
node_mainlayout -.->|"uses shared UI"| node_components
node_postroute -.->|"renders posts"| node_postlayout
node_home -.->|"lists posts"| node_contentutils
node_categoryroutes -.->|"filters posts"| node_collections
node_tagroutes -.->|"filters posts"| node_collections
node_markdown -->|"transforms directives"| node_postcontent
node_visitor -->|"searches locally"| node_search
node_search -->|"queries index"| node_pagefind
node_comments -.->|"supports comments"| node_giscus
node_comments -.->|"supports comments"| node_waline
node_mainlayout -.->|"supports switching"| node_theme
node_config -->|"selects provider"| node_comments
node_config -->|"configures warnings"| node_externals
node_externalhandling -->|"routes unsafe links"| node_externals
node_visitor -->|"follows unsafe link"| node_externals
node_imagefallback -.->|"advances fallback source"| node_postcontent

click node_collections "https://github.com/hexvork/hexaeroglass/blob/main/src/content.config.ts"
click node_postcontent "https://github.com/hexvork/hexaeroglass/tree/main/src/content"
click node_contentutils "https://github.com/hexvork/hexaeroglass/blob/main/src/utils/content-utils.ts"
click node_rss "https://github.com/hexvork/hexaeroglass/blob/main/src/pages/rss.xml.ts"
click node_llms "https://github.com/hexvork/hexaeroglass/blob/main/src/pages/llms.txt.ts"
click node_home "https://github.com/hexvork/hexaeroglass/blob/main/src/pages/index.astro"
click node_postroute "https://github.com/hexvork/hexaeroglass/blob/main/src/pages/posts/%5Bslug%5D.astro"
click node_categoryroutes "https://github.com/hexvork/hexaeroglass/tree/main/src/pages/categories"
click node_tagroutes "https://github.com/hexvork/hexaeroglass/tree/main/src/pages/tags"
click node_otherpages "https://github.com/hexvork/hexaeroglass/tree/main/src/pages"
click node_externals "https://github.com/hexvork/hexaeroglass/blob/main/src/pages/external.astro"
click node_mainlayout "https://github.com/hexvork/hexaeroglass/blob/main/src/layouts/MainLayout.astro"
click node_postlayout "https://github.com/hexvork/hexaeroglass/blob/main/src/layouts/BlogPost.astro"
click node_components "https://github.com/hexvork/hexaeroglass/tree/main/src/components"
click node_config "https://github.com/hexvork/hexaeroglass/blob/main/src/config.ts"
click node_markdown "https://github.com/hexvork/hexaeroglass/blob/main/src/plugins/rehype-component-note.mjs"
click node_search "https://github.com/hexvork/hexaeroglass/blob/main/src/scripts/header.js"
click node_comments "https://github.com/hexvork/hexaeroglass/blob/main/src/components/Comments.astro"
click node_theme "https://github.com/hexvork/hexaeroglass/blob/main/src/utils/theme-utils.ts"
click node_externalhandling "https://github.com/hexvork/hexaeroglass/blob/main/src/utils/link-utils.ts"
click node_imagefallback "https://github.com/hexvork/hexaeroglass/blob/main/src/scripts/blog-post.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_collections,node_postcontent,node_contentutils,node_rss,node_llms toneBlue
class node_home,node_postroute,node_categoryroutes,node_tagroutes,node_otherpages,node_externals toneAmber
class node_mainlayout,node_postlayout,node_components,node_config toneMint
class node_markdown,node_search,node_comments,node_theme,node_externalhandling,node_imagefallback,node_pagefind toneRose
class node_visitor,node_giscus,node_waline,node_rssconsumer toneIndigo
```

## Components

### Content and feeds

- [Content collections](https://github.com/hexvork/hexaeroglass/blob/main/src/content.config.ts): `src/content.config.ts`
- [Posts and pages](https://github.com/hexvork/hexaeroglass/tree/main/src/content): `src/content`
- [Content utilities](https://github.com/hexvork/hexaeroglass/blob/main/src/utils/content-utils.ts): `src/utils/content-utils.ts`
- [RSS feed](https://github.com/hexvork/hexaeroglass/blob/main/src/pages/rss.xml.ts): `src/pages/rss.xml.ts`
- [LLMs listing](https://github.com/hexvork/hexaeroglass/blob/main/src/pages/llms.txt.ts): `src/pages/llms.txt.ts`

### Site routes

- [Home and archives](https://github.com/hexvork/hexaeroglass/blob/main/src/pages/index.astro): `src/pages/index.astro`
- [Post route](https://github.com/hexvork/hexaeroglass/blob/main/src/pages/posts/%5Bslug%5D.astro): `src/pages/posts/[slug].astro`
- [Category routes](https://github.com/hexvork/hexaeroglass/tree/main/src/pages/categories): `src/pages/categories`
- [Tag routes](https://github.com/hexvork/hexaeroglass/tree/main/src/pages/tags): `src/pages/tags`
- [Informational pages](https://github.com/hexvork/hexaeroglass/tree/main/src/pages): `src/pages`
- [External warning page](https://github.com/hexvork/hexaeroglass/blob/main/src/pages/external.astro): `src/pages/external.astro`

### Layouts and UI

- [Main layout](https://github.com/hexvork/hexaeroglass/blob/main/src/layouts/MainLayout.astro): `src/layouts/MainLayout.astro`
- [Post layout](https://github.com/hexvork/hexaeroglass/blob/main/src/layouts/BlogPost.astro): `src/layouts/BlogPost.astro`
- [Shared UI](https://github.com/hexvork/hexaeroglass/tree/main/src/components): `src/components`
- [Site configuration](https://github.com/hexvork/hexaeroglass/blob/main/src/config.ts): `src/config.ts`

### Blog features

- [Markdown enhancements](https://github.com/hexvork/hexaeroglass/blob/main/src/plugins/rehype-component-note.mjs): `src/plugins/rehype-component-note.mjs`
- [Local search](https://github.com/hexvork/hexaeroglass/blob/main/src/scripts/header.js): `src/scripts/header.js`
- [Comments](https://github.com/hexvork/hexaeroglass/blob/main/src/components/Comments.astro): `src/components/Comments.astro`
- [Theme switching](https://github.com/hexvork/hexaeroglass/blob/main/src/utils/theme-utils.ts): `src/utils/theme-utils.ts`
- [External link handling](https://github.com/hexvork/hexaeroglass/blob/main/src/utils/link-utils.ts): `src/utils/link-utils.ts`
- [Image fallback](https://github.com/hexvork/hexaeroglass/blob/main/src/scripts/blog-post.js): `src/scripts/blog-post.js`
- **Pagefind index**

### Other components

- **Site visitor**
- **Giscus service**
- **Waline service**
- **Feed reader**

## Connections

- Site visitor → Home and archives: opens (evidence: `README.md`)
- Site visitor → Post route: opens (evidence: `README.md`)
- Site visitor → Category routes: browses (evidence: `README.md`)
- Site visitor → Tag routes: browses (evidence: `README.md`)
- Site visitor → Informational pages: opens (evidence: `README.md`)
- Posts and pages → Content collections: loaded as (evidence: `src/content.config.ts`)
- RSS feed → Content utilities: gets sorted posts (evidence: `src/pages/rss.xml.ts`)
- Feed reader → RSS feed: requests feed (evidence: `README.md`)
- LLMs listing → Site configuration: reads site description (evidence: `src/pages/llms.txt.ts`)
- Main layout → Shared UI: uses shared UI
- Post route → Post layout: renders posts
- Home and archives → Content utilities: lists posts
- Category routes → Content collections: filters posts
- Tag routes → Content collections: filters posts
- Markdown enhancements → Posts and pages: transforms directives (evidence: `README.md`)
- Site visitor → Local search: searches locally (evidence: `README.md`)
- Local search → Pagefind index: queries index (evidence: `README.md`)
- Comments → Giscus service: supports comments (evidence: `README.md`)
- Comments → Waline service: supports comments (evidence: `README.md`)
- Main layout → Theme switching: supports switching (evidence: `README.md`)
- Site configuration → Comments: selects provider (evidence: `README.md`)
- Site configuration → External warning page: configures warnings (evidence: `README.md`)
- External link handling → External warning page: routes unsafe links (evidence: `src/utils/link-utils.ts`)
- Site visitor → External warning page: follows unsafe link (evidence: `README.md`)
- Image fallback → Posts and pages: advances fallback source (evidence: `README.md`)
