# andymutale/hoplite52 architecture

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

- Interactive diagram: https://gitdiagram.com/andymutale/hoplite52
- Repository: https://github.com/andymutale/hoplite52

## Overview

This repository is a personal engineering portfolio built as a Next.js page. A visitor reaches the home page, which renders the identity, navigation, project feed, and footer; the feed filters project entries, lists writing, and opens a selected project’s case study. Static project and note content is kept separately from the presentation components. The excerpts show these page and component relationships; other repository areas, including the separate `.github` app, are not included because the sampled product workflow does not establish how they relate.

Main entry points: [`app/page.tsx`](https://github.com/andymutale/hoplite52/blob/main/app/page.tsx) (Home page), [`components/ProjectFeed.tsx`](https://github.com/andymutale/hoplite52/blob/main/components/ProjectFeed.tsx) (Project and notes feed), [`components/Header.tsx`](https://github.com/andymutale/hoplite52/blob/main/components/Header.tsx) (Header navigation), [`components/IdentityStrip.tsx`](https://github.com/andymutale/hoplite52/blob/main/components/IdentityStrip.tsx) (Identity strip)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_page["Page shell"]
  node_home["Home page<br/>[page.tsx]"]
end

subgraph group_presentation["Portfolio presentation"]
  node_header["Header navigation<br/>[Header.tsx]"]
  node_identity["Identity strip<br/>[IdentityStrip.tsx]"]
  node_feed["Project and notes feed<br/>[ProjectFeed.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_case["Case study panel<br/>[CaseStudyPanel.tsx]"]
  node_minigrid["Animated mini grid<br/>[MiniGrid.tsx]"]
  node_media["Media query hook<br/>[useMediaQuery.ts]"]
end

subgraph group_content["Portfolio content"]
  node_projects["Project records<br/>[projects.ts]"]
  node_notes["Writing records<br/>[notes.ts]"]
end

node_visitor(("Visitor"))

node_visitor -.->|"opens"| node_home
node_home -->|"renders"| node_header
node_home -->|"renders"| node_identity
node_home -->|"renders"| node_feed
node_home -->|"renders"| node_footer
node_header -->|"checks breakpoint"| node_media
node_feed -->|"filters and displays"| node_projects
node_feed -->|"displays"| node_notes
node_feed -->|"renders"| node_minigrid
node_feed -->|"passes selection"| node_case

click node_home "https://github.com/andymutale/hoplite52/blob/main/app/page.tsx"
click node_header "https://github.com/andymutale/hoplite52/blob/main/components/Header.tsx"
click node_identity "https://github.com/andymutale/hoplite52/blob/main/components/IdentityStrip.tsx"
click node_feed "https://github.com/andymutale/hoplite52/blob/main/components/ProjectFeed.tsx"
click node_footer "https://github.com/andymutale/hoplite52/blob/main/components/Footer.tsx"
click node_case "https://github.com/andymutale/hoplite52/blob/main/components/CaseStudyPanel.tsx"
click node_minigrid "https://github.com/andymutale/hoplite52/blob/main/components/MiniGrid.tsx"
click node_projects "https://github.com/andymutale/hoplite52/blob/main/data/projects.ts"
click node_notes "https://github.com/andymutale/hoplite52/blob/main/data/notes.ts"
click node_media "https://github.com/andymutale/hoplite52/blob/main/utils/useMediaQuery.ts"

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 toneBlue
class node_header,node_identity,node_feed,node_footer,node_case,node_minigrid,node_media toneAmber
class node_projects,node_notes toneMint
class node_visitor toneIndigo
```

## Components

### Page shell

- [Home page](https://github.com/andymutale/hoplite52/blob/main/app/page.tsx): `app/page.tsx`

### Portfolio presentation

- [Header navigation](https://github.com/andymutale/hoplite52/blob/main/components/Header.tsx): `components/Header.tsx`
- [Identity strip](https://github.com/andymutale/hoplite52/blob/main/components/IdentityStrip.tsx): `components/IdentityStrip.tsx`
- [Project and notes feed](https://github.com/andymutale/hoplite52/blob/main/components/ProjectFeed.tsx): `components/ProjectFeed.tsx`
- [Footer](https://github.com/andymutale/hoplite52/blob/main/components/Footer.tsx): `components/Footer.tsx`
- [Case study panel](https://github.com/andymutale/hoplite52/blob/main/components/CaseStudyPanel.tsx): `components/CaseStudyPanel.tsx`
- [Animated mini grid](https://github.com/andymutale/hoplite52/blob/main/components/MiniGrid.tsx): `components/MiniGrid.tsx`
- [Media query hook](https://github.com/andymutale/hoplite52/blob/main/utils/useMediaQuery.ts): `utils/useMediaQuery.ts`

### Portfolio content

- [Project records](https://github.com/andymutale/hoplite52/blob/main/data/projects.ts): `data/projects.ts`
- [Writing records](https://github.com/andymutale/hoplite52/blob/main/data/notes.ts): `data/notes.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Home page: opens (evidence: `README.md`)
- Home page → Header navigation: renders (evidence: `app/page.tsx`)
- Home page → Identity strip: renders (evidence: `app/page.tsx`)
- Home page → Project and notes feed: renders (evidence: `app/page.tsx`)
- Home page → Footer: renders (evidence: `app/page.tsx`)
- Header navigation → Media query hook: checks breakpoint (evidence: `components/Header.tsx`)
- Project and notes feed → Project records: filters and displays (evidence: `components/ProjectFeed.tsx`)
- Project and notes feed → Writing records: displays (evidence: `components/ProjectFeed.tsx`)
- Project and notes feed → Animated mini grid: renders (evidence: `components/ProjectFeed.tsx`)
- Project and notes feed → Case study panel: passes selection (evidence: `components/ProjectFeed.tsx`)
