# matthewshields/matthewshields.co.uk architecture

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

- Interactive diagram: https://gitdiagram.com/matthewshields/matthewshields.co.uk
- Repository: https://github.com/matthewshields/matthewshields.co.uk

## Overview

This is a Gatsby-based personal portfolio and publishing site. Visitors browse the home page, paginated writing, curated links, photography, and flexible-content pages; Markdown-backed queries provide the content rendered through shared layout and presentation components. The graph preserves those domain areas and the Netlify CMS integration. Source excerpts show several rendering calls and queries, but the README is minimal and some implementation files were not sampled, so uncertain wiring is omitted.

Main entry points: [`src/layout/index.jsx`](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/layout/index.jsx) (Site layout), [`src/templates/page.jsx`](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/templates/page.jsx) (Flexible pages), [`src/pages/index.jsx`](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/pages/index.jsx) (Home page), [`src/pages/links.jsx`](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/pages/links.jsx) (Curated links)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content and data"]
  node_records["Markdown content"]
  node_siteconfig["Site configuration<br/>[SiteConfig.js]"]
  node_navigationdata["Navigation data<br/>[navigation.yml]"]
end

subgraph group_routes["Pages and templates"]
  node_home["Home page<br/>[index.jsx]"]
  node_linkspage["Curated links<br/>[links.jsx]"]
  node_listing["Writing listing<br/>[listing.jsx]"]
  node_pagetemplate["Flexible pages<br/>[page.jsx]"]
  node_posttemplate["Writing posts<br/>[post.jsx]"]
end

subgraph group_presentation["Shared presentation"]
  node_layout["Site layout<br/>[index.jsx]"]
  node_header["Navigation header<br/>[Header.jsx]"]
  node_footer["Site footer<br/>[Footer.jsx]"]
  node_postlisting["Post cards<br/>[PostListing.jsx]"]
  node_hero["Page hero<br/>[Hero.jsx]"]
  node_seo["SEO metadata<br/>[SEO.jsx]"]
  node_flexible["Flexible content"]
  node_textblock["Text blocks<br/>[TextBlock.jsx]"]
  node_blocklist["Block lists<br/>[BlockList.jsx]"]
  node_gallery["Photography gallery<br/>[Gallery.jsx]"]
end

subgraph group_authoring["Content authoring"]
  node_cms["Netlify CMS<br/>[index.js]"]
  node_cmsconfig["CMS configuration<br/>[config.yml]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"opens"| node_home
node_visitor -->|"browses"| node_linkspage
node_visitor -->|"browses"| node_listing
node_visitor -->|"opens"| node_pagetemplate
node_visitor -->|"opens"| node_posttemplate
node_home -->|"queries writing"| node_records
node_linkspage -->|"queries links"| node_records
node_listing -->|"queries writing"| node_records
node_pagetemplate -->|"queries page"| node_records
node_home -->|"renders"| node_layout
node_linkspage -->|"renders"| node_layout
node_listing -->|"renders"| node_layout
node_pagetemplate -->|"renders"| node_layout
node_posttemplate -->|"renders"| node_layout
node_home -->|"renders"| node_postlisting
node_linkspage -->|"renders"| node_postlisting
node_listing -->|"renders"| node_postlisting
node_pagetemplate -->|"renders"| node_hero
node_pagetemplate -->|"renders"| node_flexible
node_pagetemplate -->|"renders"| node_seo
node_posttemplate -->|"renders"| node_hero
node_posttemplate -->|"renders"| node_seo
node_layout -->|"renders"| node_header
node_layout -->|"renders"| node_footer
node_layout -->|"uses settings"| node_siteconfig
node_header -->|"reads links"| node_navigationdata
node_footer -->|"uses settings"| node_siteconfig
node_seo -->|"uses metadata"| node_siteconfig
node_flexible -->|"renders"| node_textblock
node_flexible -->|"renders"| node_blocklist
node_cms -.->|"uses configuration"| node_cmsconfig

click node_records "https://github.com/matthewshields/matthewshields.co.uk/tree/master/content"
click node_siteconfig "https://github.com/matthewshields/matthewshields.co.uk/blob/master/data/SiteConfig.js"
click node_navigationdata "https://github.com/matthewshields/matthewshields.co.uk/blob/master/data/settings/navigation.yml"
click node_home "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/pages/index.jsx"
click node_linkspage "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/pages/links.jsx"
click node_listing "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/templates/listing.jsx"
click node_pagetemplate "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/templates/page.jsx"
click node_posttemplate "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/templates/post.jsx"
click node_layout "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/layout/index.jsx"
click node_header "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Header/Header.jsx"
click node_footer "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Footer/Footer.jsx"
click node_postlisting "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/PostListing/PostListing.jsx"
click node_hero "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Hero/Hero.jsx"
click node_seo "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/SEO/SEO.jsx"
click node_flexible "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/FlexibleContent/FlexibleContent.jsx"
click node_textblock "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/TextBlock/TextBlock.jsx"
click node_blocklist "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/BlockList/BlockList.jsx"
click node_gallery "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Gallery/Gallery.jsx"
click node_cms "https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/netlifycms/index.js"
click node_cmsconfig "https://github.com/matthewshields/matthewshields.co.uk/blob/master/static/admin/config.yml"

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_records,node_siteconfig,node_navigationdata toneBlue
class node_home,node_linkspage,node_listing,node_pagetemplate,node_posttemplate toneAmber
class node_layout,node_header,node_footer,node_postlisting,node_hero,node_seo,node_flexible,node_textblock,node_blocklist,node_gallery toneMint
class node_cms,node_cmsconfig toneRose
class node_visitor toneIndigo
```

## Components

### Content and data

- [Markdown content](https://github.com/matthewshields/matthewshields.co.uk/tree/master/content): `content`
- [Site configuration](https://github.com/matthewshields/matthewshields.co.uk/blob/master/data/SiteConfig.js): `data/SiteConfig.js`
- [Navigation data](https://github.com/matthewshields/matthewshields.co.uk/blob/master/data/settings/navigation.yml): `data/settings/navigation.yml`

### Pages and templates

- [Home page](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/pages/index.jsx): `src/pages/index.jsx`
- [Curated links](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/pages/links.jsx): `src/pages/links.jsx`
- [Writing listing](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/templates/listing.jsx): `src/templates/listing.jsx`
- [Flexible pages](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/templates/page.jsx): `src/templates/page.jsx`
- [Writing posts](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/templates/post.jsx): `src/templates/post.jsx`

### Shared presentation

- [Site layout](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/layout/index.jsx): `src/layout/index.jsx`
- [Navigation header](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Header/Header.jsx): `src/components/Header/Header.jsx`
- [Site footer](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Footer/Footer.jsx): `src/components/Footer/Footer.jsx`
- [Post cards](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/PostListing/PostListing.jsx): `src/components/PostListing/PostListing.jsx`
- [Page hero](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Hero/Hero.jsx): `src/components/Hero/Hero.jsx`
- [SEO metadata](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/SEO/SEO.jsx): `src/components/SEO/SEO.jsx`
- [Flexible content](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/FlexibleContent/FlexibleContent.jsx): `src/components/FlexibleContent/FlexibleContent.jsx`
- [Text blocks](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/TextBlock/TextBlock.jsx): `src/components/TextBlock/TextBlock.jsx`
- [Block lists](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/BlockList/BlockList.jsx): `src/components/BlockList/BlockList.jsx`
- [Photography gallery](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/components/Gallery/Gallery.jsx): `src/components/Gallery/Gallery.jsx`

### Content authoring

- [Netlify CMS](https://github.com/matthewshields/matthewshields.co.uk/blob/master/src/netlifycms/index.js): `src/netlifycms/index.js`
- [CMS configuration](https://github.com/matthewshields/matthewshields.co.uk/blob/master/static/admin/config.yml): `static/admin/config.yml`

### Other components

- **Site visitor**

## Connections

- Site visitor → Home page: opens
- Site visitor → Curated links: browses
- Site visitor → Writing listing: browses
- Site visitor → Flexible pages: opens
- Site visitor → Writing posts: opens
- Home page → Markdown content: queries writing (evidence: `src/pages/index.jsx`)
- Curated links → Markdown content: queries links (evidence: `src/pages/links.jsx`)
- Writing listing → Markdown content: queries writing (evidence: `src/templates/listing.jsx`)
- Flexible pages → Markdown content: queries page (evidence: `src/templates/page.jsx`)
- Home page → Site layout: renders (evidence: `src/pages/index.jsx`)
- Curated links → Site layout: renders (evidence: `src/pages/links.jsx`)
- Writing listing → Site layout: renders (evidence: `src/templates/listing.jsx`)
- Flexible pages → Site layout: renders (evidence: `src/templates/page.jsx`)
- Writing posts → Site layout: renders (evidence: `src/templates/post.jsx`)
- Home page → Post cards: renders (evidence: `src/pages/index.jsx`)
- Curated links → Post cards: renders (evidence: `src/pages/links.jsx`)
- Writing listing → Post cards: renders (evidence: `src/templates/listing.jsx`)
- Flexible pages → Page hero: renders (evidence: `src/templates/page.jsx`)
- Flexible pages → Flexible content: renders (evidence: `src/templates/page.jsx`)
- Flexible pages → SEO metadata: renders (evidence: `src/templates/page.jsx`)
- Writing posts → Page hero: renders (evidence: `src/templates/post.jsx`)
- Writing posts → SEO metadata: renders (evidence: `src/templates/post.jsx`)
- Site layout → Navigation header: renders (evidence: `src/layout/index.jsx`)
- Site layout → Site footer: renders (evidence: `src/layout/index.jsx`)
- Site layout → Site configuration: uses settings (evidence: `src/layout/index.jsx`)
- Navigation header → Navigation data: reads links (evidence: `src/components/Header/Header.jsx`)
- Site footer → Site configuration: uses settings (evidence: `src/layout/index.jsx`)
- SEO metadata → Site configuration: uses metadata (evidence: `src/components/SEO/SEO.jsx`)
- Flexible content → Text blocks: renders (evidence: `src/components/FlexibleContent/FlexibleContent.jsx`)
- Flexible content → Block lists: renders (evidence: `src/components/FlexibleContent/FlexibleContent.jsx`)
- Netlify CMS → CMS configuration: uses configuration
