# yorkejohn/yorkejohn.dev architecture

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

- Interactive diagram: https://gitdiagram.com/yorkejohn/yorkejohn.dev
- Repository: https://github.com/yorkejohn/yorkejohn.dev

## Overview

This is a design-forward personal portfolio and publishing site. Visitors arrive at the home, blog, projects, or privacy pages; the site renders those experiences within a shared layout, with blog metadata and project content supplying key results. Supporting branches include interactive site controls, generated social images, and home-page showcase features. The README documents the site’s portfolio purpose and background music. Some page and layout implementations are unsampled, so the graph omits uncertain internal calls rather than inferring them from names.

Main entry points: [`src/components/pages`](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages) (Page components), [`src/app/blog/[slug]/page.tsx`](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/blog/%5Bslug%5D/page.tsx) (Blog routes), [`src/components/pages/blog`](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages/blog) (Blog views), [`src/app/page.tsx`](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/page.tsx) (Home route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Routes and layout"]
  node_home_route["Home route<br/>[page.tsx]"]
  node_blog_route["Blog routes<br/>[page.tsx]"]
  node_projects_route["Projects route<br/>[page.tsx]"]
  node_privacy_route["Privacy route<br/>[page.tsx]"]
  node_root_layout["Root layout<br/>[layout.tsx]"]
  node_layout_parts["Shared layout"]
end

subgraph group_content["Portfolio content"]
  node_page_components["Page components"]
  node_home_features["Home showcases"]
  node_blog_views["Blog views"]
  node_posts["Post metadata<br/>[posts.ts]"]
  node_project_views["Project views"]
  node_project_registry["Project registry<br/>[registry.ts]"]
end

subgraph group_interaction["Site interactions"]
  node_shared_ui["Shared UI"]
  node_terminal["Terminal<br/>[terminal.tsx]"]
  node_drag_window["Draggable window"]
  node_filter_hook["Filter data hook"]
  node_sound["Sound playback<br/>[play-sound.ts]"]
  node_weather_widget["Weather widget<br/>[header.tsx]"]
end

subgraph group_support["Rendering support"]
  node_og_routes["Social image routes"]
  node_og_renderer["Image renderer<br/>[og.tsx]"]
end

node_visitor(("Visitor"))
node_weather_service(("Open-Meteo"))

node_visitor -->|"visits"| node_home_route
node_visitor -->|"visits"| node_blog_route
node_visitor -->|"visits"| node_projects_route
node_visitor -->|"visits"| node_privacy_route
node_home_route -->|"renders via"| node_page_components
node_blog_route -->|"renders via"| node_page_components
node_projects_route -->|"renders via"| node_page_components
node_privacy_route -->|"renders via"| node_page_components
node_root_layout -->|"renders"| node_layout_parts
node_blog_route -->|"loads metadata"| node_posts
node_blog_views -->|"reads posts"| node_posts
node_project_views -->|"reads projects"| node_project_registry
node_weather_widget -->|"fetches forecast"| node_weather_service
node_og_routes -->|"generates image"| node_og_renderer
node_terminal -->|"plays sounds"| node_sound
node_drag_window -->|"plays sounds"| node_sound
node_blog_views -->|"uses filtering"| node_filter_hook

click node_home_route "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/page.tsx"
click node_blog_route "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/blog/%5Bslug%5D/page.tsx"
click node_projects_route "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/projects/page.tsx"
click node_privacy_route "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/privacy/page.tsx"
click node_root_layout "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/layout.tsx"
click node_layout_parts "https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/layout"
click node_page_components "https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages"
click node_home_features "https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages/home"
click node_blog_views "https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages/blog"
click node_posts "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/posts.ts"
click node_project_views "https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages/projects"
click node_project_registry "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/pages/projects/registry.ts"
click node_shared_ui "https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components"
click node_terminal "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/terminal.tsx"
click node_drag_window "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/draggable-window.tsx"
click node_filter_hook "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/hooks/use-filtered-data.ts"
click node_sound "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/lib/play-sound.ts"
click node_weather_widget "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/layout/header.tsx"
click node_og_routes "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/opengraph-image.tsx"
click node_og_renderer "https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/lib/og.tsx"

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_home_route,node_blog_route,node_projects_route,node_privacy_route,node_root_layout,node_layout_parts toneBlue
class node_page_components,node_home_features,node_blog_views,node_posts,node_project_views,node_project_registry toneAmber
class node_shared_ui,node_terminal,node_drag_window,node_filter_hook,node_sound,node_weather_widget toneMint
class node_og_routes,node_og_renderer toneRose
class node_visitor,node_weather_service toneIndigo
```

## Components

### Routes and layout

- [Home route](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Blog routes](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/blog/%5Bslug%5D/page.tsx): `src/app/blog/[slug]/page.tsx`
- [Projects route](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/projects/page.tsx): `src/app/projects/page.tsx`
- [Privacy route](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/privacy/page.tsx): `src/app/privacy/page.tsx`
- [Root layout](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/layout.tsx): `src/app/layout.tsx`
- [Shared layout](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/layout): `src/components/layout`

### Portfolio content

- [Page components](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages): `src/components/pages`
- [Home showcases](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages/home): `src/components/pages/home`
- [Blog views](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages/blog): `src/components/pages/blog`
- [Post metadata](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/posts.ts): `src/posts.ts`
- [Project views](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components/pages/projects): `src/components/pages/projects`
- [Project registry](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/pages/projects/registry.ts): `src/components/pages/projects/registry.ts`

### Site interactions

- [Shared UI](https://github.com/yorkejohn/yorkejohn.dev/tree/main/src/components): `src/components`
- [Terminal](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/terminal.tsx): `src/components/terminal.tsx`
- [Draggable window](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/draggable-window.tsx): `src/components/draggable-window.tsx`
- [Filter data hook](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/hooks/use-filtered-data.ts): `src/hooks/use-filtered-data.ts`
- [Sound playback](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/lib/play-sound.ts): `src/lib/play-sound.ts`
- [Weather widget](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/components/layout/header.tsx): `src/components/layout/header.tsx`

### Rendering support

- [Social image routes](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/app/opengraph-image.tsx): `src/app/opengraph-image.tsx`
- [Image renderer](https://github.com/yorkejohn/yorkejohn.dev/blob/main/src/lib/og.tsx): `src/lib/og.tsx`

### Other components

- **Visitor**
- **Open-Meteo**

## Connections

- Visitor → Home route: visits
- Visitor → Blog routes: visits (evidence: `src/app/blog/[slug]/page.tsx`)
- Visitor → Projects route: visits (evidence: `src/app/projects/page.tsx`)
- Visitor → Privacy route: visits (evidence: `src/app/privacy/page.tsx`)
- Home route → Page components: renders via (evidence: `src/app/page.tsx`)
- Blog routes → Page components: renders via (evidence: `src/app/blog/[slug]/page.tsx`)
- Projects route → Page components: renders via (evidence: `src/app/projects/page.tsx`)
- Privacy route → Page components: renders via (evidence: `src/app/privacy/page.tsx`)
- Root layout → Shared layout: renders (evidence: `src/app/layout.tsx`)
- Blog routes → Post metadata: loads metadata (evidence: `src/app/blog/[slug]/page.tsx`)
- Blog views → Post metadata: reads posts (evidence: `src/components/pages/blog/article.tsx`)
- Project views → Project registry: reads projects (evidence: `src/components/pages/projects/project-card.tsx`)
- Weather widget → Open-Meteo: fetches forecast (evidence: `src/components/layout/header.tsx`)
- Social image routes → Image renderer: generates image (evidence: `src/app/opengraph-image.tsx`)
- Terminal → Sound playback: plays sounds (evidence: `src/components/terminal.tsx`)
- Draggable window → Sound playback: plays sounds (evidence: `src/components/draggable-window.tsx`)
- Blog views → Filter data hook: uses filtering (evidence: `src/components/pages/blog/blog.tsx`)
