# matikepa/matsonkepson.github.io architecture

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

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

## Overview

This repository is the source for a personal technical blog. The principal workflow is Markdown content being assembled by Hugo into a static site, then hosted on GitHub Pages for readers. Site configuration and the LoveIt theme shape the generated experience. A separate browser-side script initializes PostHog and Google Analytics and implements cookie consent, including local consent storage. The README documents the publishing stack; runtime relationships beyond the excerpts are limited to those shown in the JavaScript.

Main entry points: [`scripts/gtag.js`](https://github.com/matikepa/matsonkepson.github.io/blob/main/scripts/gtag.js) (Analytics initialization), [`content`](https://github.com/matikepa/matsonkepson.github.io/tree/main/content) (Articles and pages), [`config/_default`](https://github.com/matikepa/matsonkepson.github.io/tree/main/config/_default) (Site configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Blog content"]
  node_markdown["Articles and pages"]
end

subgraph group_site["Site generation"]
  node_hugo["Hugo generator"]
  node_siteconfig["Site configuration"]
  node_loveit["LoveIt theme"]
  node_pages["GitHub Pages"]
end

subgraph group_analytics["Browser analytics"]
  node_consent["Cookie consent<br/>[gtag.js]"]
  node_browserstorage[("Consent storage<br/>[gtag.js]")]
  node_analyticscode["Analytics initialization<br/>[gtag.js]"]
end

node_reader(("Reader"))
node_posthog["PostHog"]
node_googleanalytics["Google Analytics"]

node_markdown -->|"builds from"| node_hugo
node_siteconfig -->|"configures"| node_hugo
node_loveit -->|"themes"| node_hugo
node_hugo -->|"publishes to"| node_pages
node_pages -->|"serves site"| node_reader
node_consent -->|"reads and writes"| node_browserstorage
node_consent -->|"configures"| node_analyticscode
node_analyticscode -->|"initializes"| node_posthog
node_analyticscode -->|"loads and configures"| node_googleanalytics

click node_markdown "https://github.com/matikepa/matsonkepson.github.io/tree/main/content"
click node_siteconfig "https://github.com/matikepa/matsonkepson.github.io/tree/main/config/_default"
click node_consent "https://github.com/matikepa/matsonkepson.github.io/blob/main/scripts/gtag.js"
click node_browserstorage "https://github.com/matikepa/matsonkepson.github.io/blob/main/scripts/gtag.js"
click node_analyticscode "https://github.com/matikepa/matsonkepson.github.io/blob/main/scripts/gtag.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_markdown toneBlue
class node_hugo,node_siteconfig,node_loveit,node_pages toneAmber
class node_consent,node_browserstorage,node_analyticscode toneMint
class node_reader,node_posthog,node_googleanalytics toneIndigo
```

## Components

### Blog content

- [Articles and pages](https://github.com/matikepa/matsonkepson.github.io/tree/main/content): `content`

### Site generation

- **Hugo generator**
- [Site configuration](https://github.com/matikepa/matsonkepson.github.io/tree/main/config/_default): `config/_default`
- **LoveIt theme**
- **GitHub Pages**

### Browser analytics

- [Cookie consent](https://github.com/matikepa/matsonkepson.github.io/blob/main/scripts/gtag.js): `scripts/gtag.js`
- [Consent storage](https://github.com/matikepa/matsonkepson.github.io/blob/main/scripts/gtag.js): `scripts/gtag.js`
- [Analytics initialization](https://github.com/matikepa/matsonkepson.github.io/blob/main/scripts/gtag.js): `scripts/gtag.js`

### Other components

- **Reader**
- **PostHog**
- **Google Analytics**

## Connections

- Articles and pages → Hugo generator: builds from (evidence: `README.md`)
- Site configuration → Hugo generator: configures (evidence: `README.md`)
- LoveIt theme → Hugo generator: themes (evidence: `README.md`)
- Hugo generator → GitHub Pages: publishes to (evidence: `README.md`)
- GitHub Pages → Reader: serves site (evidence: `README.md`)
- Cookie consent → Consent storage: reads and writes (evidence: `scripts/gtag.js`)
- Cookie consent → Analytics initialization: configures (evidence: `scripts/gtag.js`)
- Analytics initialization → PostHog: initializes (evidence: `scripts/gtag.js`)
- Analytics initialization → Google Analytics: loads and configures (evidence: `scripts/gtag.js`)
