# conway-hash/conway-hash-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/conway-hash/conway-hash-portfolio
- Repository: https://github.com/conway-hash/conway-hash-portfolio

## Overview

1. This repository is a small Next.js application built with the Pages Router. The entry point is `pages/index.js`, and the app is wired through `pages/_app.js` and `pages/_document.js` rather than the newer App Router structure.

2. The overall product looks like a personal portfolio or landing site, organized as a single scrolling page composed of section-based React components. The `components/` directory contains numbered, ordered sections such as navigation, landing, about, projects, experience, contact, and a Conway demo section.

3. The main composition boundary is at the page level: `pages/index.js` likely assembles the section components in sequence, while each section owns its own markup and styles. The numeric prefixes in filenames (`0app`, `1nav`, `2landing`, etc.) suggest render order and reinforce the page’s vertical information architecture.

4. There is a clear styling split between global and local styles. `styles/globals.css` provides app-wide base styling, while nearly every UI component has a matching CSS Module file for scoped styles. `styles/utilities.module.css` likely holds shared utility classes reused across sections.

5. The application is mostly static on the client side. There is no obvious state management layer, data store, or server-side domain model in the tree, which implies the page is primarily presentational and content-driven rather than data-intensive.

6. The only backend surface is the sample Next.js API route in `pages/api/hello.js`. This is the default scaffolded endpoint and does not appear to be a core part of the architecture; it serves more as a Next.js example than as a meaningful service boundary.

7. Static assets live under `public/`, including favicon files and project media. This indicates that images and other portfolio content are likely served directly by Next.js as static files rather than fetched from an external CMS or asset pipeline.

8. The `components/4projects_main.jsx` and `components/5experience_main.jsx` files suggest substructure inside larger sections. Those sections likely split summary/overview presentation from detailed lists or cards, which is useful to reflect as nested component groups in a diagram.

9. The repo is configured as a standard Next.js + React frontend with no extra runtime services visible in the tree. Build and execution are handled by Next.js tooling, and the README confirms local development via `npm run dev` and deployment via Vercel.

10. Overall architectural boundaries are simple: Next.js routing and rendering at the top, page composition in `pages/`, reusable section components in `components/`, styles isolated via CSS Modules, and static media delivered from `public/`. The design is optimized for a polished, mostly static portfolio experience with minimal server-side complexity.

Main entry points: [`components/0app.jsx`](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/0app.jsx) (App section), [`styles/utilities.module.css`](https://github.com/conway-hash/conway-hash-portfolio/blob/main/styles/utilities.module.css) (Utilities), [`pages/index.js`](https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/index.js) (Home page), [`components/4projects.jsx`](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/4projects.jsx) (Projects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_next["Next.js App"]
  node_pages_app["App shell<br/>pages router<br/>[_app.js]"]
  node_pages_document["Document<br/>html shell<br/>[_document.js]"]
  node_pages_index["Home page<br/>[index.js]"]
  node_pages_api_hello["Hello API<br/>api route<br/>[hello.js]"]
end

subgraph group_components["Page Components"]
  node_app_component["App section<br/>layout section<br/>[0app.jsx]"]
  node_nav_section["Nav<br/>section<br/>[1nav.jsx]"]
  node_landing_section["Landing<br/>hero section<br/>[2landing.jsx]"]
  node_about_section["About<br/>content section<br/>[3about.jsx]"]
  node_projects_section["Projects<br/>section<br/>[4projects.jsx]"]
  node_projects_detail["Project detail<br/>project cards<br/>[4projects_main.jsx]"]
  node_experience_section["Experience<br/>section<br/>[5experience.jsx]"]
  node_experience_detail["Experience detail<br/>timeline list"]
  node_contact_section["Contact<br/>section<br/>[6contact.jsx]"]
  node_conway_section["Conway<br/>demo section<br/>[7conway.jsx]"]
end

subgraph group_styles["Styles"]
  node_globals_css["Global CSS<br/>global stylesheet<br/>[globals.css]"]
  node_utilities_css["Utilities<br/>shared module"]
end

subgraph group_assets["Static Assets"]
  node_media_assets[("Media<br/>static assets")]
  node_favicon_assets[("Favicon<br/>static assets")]
end

node_pages_app -->|"wraps"| node_app_component
node_pages_app -->|"loads"| node_globals_css
node_pages_index -->|"renders"| node_app_component
node_app_component -->|"contains"| node_nav_section
node_app_component -->|"contains"| node_landing_section
node_app_component -->|"contains"| node_about_section
node_app_component -->|"contains"| node_projects_section
node_app_component -->|"contains"| node_experience_section
node_app_component -->|"contains"| node_contact_section
node_app_component -->|"contains"| node_conway_section
node_projects_section -->|"expands"| node_projects_detail
node_experience_section -->|"expands"| node_experience_detail
node_nav_section -->|"uses"| node_utilities_css
node_landing_section -->|"uses"| node_utilities_css
node_about_section -->|"uses"| node_utilities_css
node_projects_section -->|"uses"| node_utilities_css
node_projects_detail -->|"uses"| node_utilities_css
node_experience_section -->|"uses"| node_utilities_css
node_experience_detail -->|"uses"| node_utilities_css
node_contact_section -->|"uses"| node_utilities_css
node_conway_section -->|"uses"| node_utilities_css
node_pages_api_hello -.->|"isolated"| node_pages_api_hello
node_pages_index -->|"references"| node_media_assets
node_pages_index -->|"uses"| node_favicon_assets

click node_pages_app "https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/_app.js"
click node_pages_document "https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/_document.js"
click node_pages_index "https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/index.js"
click node_pages_api_hello "https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/api/hello.js"
click node_app_component "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/0app.jsx"
click node_nav_section "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/1nav.jsx"
click node_landing_section "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/2landing.jsx"
click node_about_section "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/3about.jsx"
click node_projects_section "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/4projects.jsx"
click node_projects_detail "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/4projects_main.jsx"
click node_experience_section "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/5experience.jsx"
click node_experience_detail "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/5experience_main.jsx"
click node_contact_section "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/6contact.jsx"
click node_conway_section "https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/7conway.jsx"
click node_globals_css "https://github.com/conway-hash/conway-hash-portfolio/blob/main/styles/globals.css"
click node_utilities_css "https://github.com/conway-hash/conway-hash-portfolio/blob/main/styles/utilities.module.css"
click node_media_assets "https://github.com/conway-hash/conway-hash-portfolio/tree/main/public/media"
click node_favicon_assets "https://github.com/conway-hash/conway-hash-portfolio/tree/main/public/favicon"

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_pages_app,node_pages_document,node_pages_index,node_pages_api_hello toneBlue
class node_app_component,node_nav_section,node_landing_section,node_about_section,node_projects_section,node_projects_detail,node_experience_section,node_experience_detail,node_contact_section,node_conway_section toneAmber
class node_globals_css,node_utilities_css toneMint
class node_media_assets,node_favicon_assets toneRose
```

## Components

### Next.js App

Pages Router entry points and scaffolded API surface.

- [App shell](https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/_app.js): pages router · Wraps every page in the Next.js Pages Router. · `pages/_app.js`
- [Document](https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/_document.js): html shell · Custom document used to shape the outer HTML shell. · `pages/_document.js`
- [Home page](https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/index.js): page · Main landing page composed from the section components. · `pages/index.js`
- [Hello API](https://github.com/conway-hash/conway-hash-portfolio/blob/main/pages/api/hello.js): api route · Default scaffolded API endpoint, not core to the app. · `pages/api/hello.js`

### Page Components

Ordered sections and reusable page composition pieces.

- [App section](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/0app.jsx): layout section · Top-level page wrapper component for the scrolling layout. · `components/0app.jsx`
- [Nav](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/1nav.jsx): section · Primary navigation for the portfolio page. · `components/1nav.jsx`
- [Landing](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/2landing.jsx): hero section · Opening hero or intro section. · `components/2landing.jsx`
- [About](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/3about.jsx): content section · Personal background and summary content. · `components/3about.jsx`
- [Projects](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/4projects.jsx): section · Project overview section with a dedicated subcomponent. · `components/4projects.jsx`
- [Project detail](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/4projects_main.jsx): project cards · Expanded project presentation and card-level content. · `components/4projects_main.jsx`
- [Experience](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/5experience.jsx): section · Work or experience overview section with detailed entries. · `components/5experience.jsx`
- [Experience detail](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/5experience_main.jsx): timeline list · Expanded experience presentation and detailed items. · `components/5experience_main.jsx`
- [Contact](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/6contact.jsx): section · Contact and call-to-action section. · `components/6contact.jsx`
- [Conway](https://github.com/conway-hash/conway-hash-portfolio/blob/main/components/7conway.jsx): demo section · Interactive Conway demo or visual experiment. · `components/7conway.jsx`

### Styles

Global styling and scoped CSS Modules.

- [Global CSS](https://github.com/conway-hash/conway-hash-portfolio/blob/main/styles/globals.css): global stylesheet · App-wide base styles. · `styles/globals.css`
- [Utilities](https://github.com/conway-hash/conway-hash-portfolio/blob/main/styles/utilities.module.css): shared module · Reusable utility classes shared across sections. · `styles/utilities.module.css`

### Static Assets

Public files served directly by Next.js.

- [Media](https://github.com/conway-hash/conway-hash-portfolio/tree/main/public/media): static assets · Portfolio media served from the public directory. · `public/media`
- [Favicon](https://github.com/conway-hash/conway-hash-portfolio/tree/main/public/favicon): static assets · Site icons and web manifest assets. · `public/favicon`

## Connections

- App shell → App section: wraps · The app shell provides the shared page wrapper.
- App shell → Global CSS: loads · Global styles are applied through the app wrapper.
- Home page → App section: renders · The home page composes the main portfolio shell.
- App section → Nav: contains · Navigation is part of the top-level scrolling layout.
- App section → Landing: contains · Hero section follows the navigation.
- App section → About: contains · About section continues the page flow.
- App section → Projects: contains · Projects is one of the primary content sections.
- App section → Experience: contains · Experience is another major content block.
- App section → Contact: contains · Contact is the closing conversion section.
- App section → Conway: contains · Conway demo is included as a featured section.
- Projects → Project detail: expands · The projects section delegates detailed project rendering.
- Experience → Experience detail: expands · The experience section delegates detailed entry rendering.
- Nav → Utilities: uses · Shared utility classes support navigation styling.
- Landing → Utilities: uses · Utilities help structure the hero layout.
- About → Utilities: uses · Shared utility classes support section layout.
- Projects → Utilities: uses · Projects layout relies on shared utilities.
- Project detail → Utilities: uses · Detailed project cards reuse shared utilities.
- Experience → Utilities: uses · Experience layout relies on shared utilities.
- Experience detail → Utilities: uses · Detailed experience entries reuse shared utilities.
- Contact → Utilities: uses · Contact layout relies on shared utilities.
- Conway → Utilities: uses · Conway demo styling also reuses shared utilities.
- Hello API → Hello API: isolated · Standalone scaffolded endpoint with no architectural dependencies.
- Home page → Media: references · The home page likely pulls in static portfolio media.
- Home page → Favicon: uses · Site-level icon assets are served from public.
