# hongkiulam/site architecture

> Architecture diagram of the GitHub repository hongkiulam/site, 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/hongkiulam/site
- Repository: https://github.com/hongkiulam/site

## Overview

This is a server-rendered Astro portfolio site with photography, interactive home-page elements, navigation, and experimental 3D pages. The clearest evidenced runtime flow is photography project data from Behance (or a development mock) through an API endpoint, plus a client-side photo lightbox with canvas pan/zoom. The README is an uncustomized Astro starter and does not document the site’s capabilities; several page implementations are unsampled, so their links are omitted rather than inferred.

Main entry points: [`src/pages/api/behance/all-graphql/index.ts`](https://github.com/hongkiulam/site/blob/v2/src/pages/api/behance/all-graphql/index.ts) (Behance projects API), [`src/components/photos/Lightbox.svelte`](https://github.com/hongkiulam/site/blob/v2/src/components/photos/Lightbox.svelte) (Photo lightbox), [`src/components/MobileNav.tsx`](https://github.com/hongkiulam/site/blob/v2/src/components/MobileNav.tsx) (Mobile navigation), [`src/components/photos/Image.svelte`](https://github.com/hongkiulam/site/blob/v2/src/components/photos/Image.svelte) (Photo image)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site experience"]
  node_home["Home page<br/>[index.astro]"]
  node_homevisuals["Home visuals"]
  node_mobile["Mobile navigation<br/>[MobileNav.tsx]"]
  node_wipe["Page wipe"]
end

subgraph group_photos["Photography"]
  node_photosindex["Photo gallery<br/>[index.astro]"]
  node_projectpage["Photo project<br/>[&#91;projectId&#93;.astro]"]
  node_photoimage["Photo image<br/>[Image.svelte]"]
  node_lightbox["Photo lightbox<br/>[Lightbox.svelte]"]
  node_panzoom["Canvas pan zoom<br/>[panZoomCanvas.ts]"]
end

subgraph group_experiments["Experiments"]
  node_experimentsindex["Experiments index<br/>[index.astro]"]
  node_phantom["Phantom Land"]
  node_experimentpage["Experiment page"]
end

subgraph group_api["API integrations"]
  node_behanceapi["Behance projects API<br/>[index.ts]"]
  node_projectmock["Project mock data<br/>[_projects.ts]"]
  node_gqlquery["Projects query<br/>[_projects.gql]"]
  node_imageproxy["Image proxy<br/>[index.ts]"]
end

node_visitor(("Visitor"))
node_behance{{"Behance GraphQL"}}
node_imagehost{{"External image host"}}

node_visitor -.->|"opens"| node_home
node_visitor -.->|"opens"| node_photosindex
node_visitor -.->|"opens"| node_experimentsindex
node_mobile -->|"renders"| node_wipe
node_photoimage -->|"opens"| node_lightbox
node_lightbox -->|"uses"| node_panzoom
node_behanceapi -->|"loads in development"| node_projectmock
node_behanceapi -->|"reads query"| node_gqlquery
node_behanceapi -->|"fetches projects"| node_behance
node_imageproxy -->|"fetches image"| node_imagehost

click node_home "https://github.com/hongkiulam/site/blob/v2/src/pages/index.astro"
click node_homevisuals "https://github.com/hongkiulam/site/tree/v2/src/components/home"
click node_mobile "https://github.com/hongkiulam/site/blob/v2/src/components/MobileNav.tsx"
click node_wipe "https://github.com/hongkiulam/site/blob/v2/src/components/MobileNavPageWipe.tsx"
click node_photosindex "https://github.com/hongkiulam/site/blob/v2/src/pages/photos/index.astro"
click node_projectpage "https://github.com/hongkiulam/site/blob/v2/src/pages/photos/%5BprojectId%5D.astro"
click node_photoimage "https://github.com/hongkiulam/site/blob/v2/src/components/photos/Image.svelte"
click node_lightbox "https://github.com/hongkiulam/site/blob/v2/src/components/photos/Lightbox.svelte"
click node_panzoom "https://github.com/hongkiulam/site/blob/v2/src/components/photos/panZoomCanvas.ts"
click node_experimentsindex "https://github.com/hongkiulam/site/blob/v2/src/pages/experiments/index.astro"
click node_phantom "https://github.com/hongkiulam/site/blob/v2/src/components/experiments/R3FPhantomLandClone.tsx"
click node_experimentpage "https://github.com/hongkiulam/site/blob/v2/src/pages/experiments/r3f-phantom-land-clone.astro"
click node_behanceapi "https://github.com/hongkiulam/site/blob/v2/src/pages/api/behance/all-graphql/index.ts"
click node_projectmock "https://github.com/hongkiulam/site/blob/v2/src/pages/api/behance/all-graphql/_projects.ts"
click node_gqlquery "https://github.com/hongkiulam/site/blob/v2/src/pages/api/behance/all-graphql/_projects.gql"
click node_imageproxy "https://github.com/hongkiulam/site/blob/v2/src/pages/api/proxy-image/index.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,node_homevisuals,node_mobile,node_wipe toneBlue
class node_photosindex,node_projectpage,node_photoimage,node_lightbox,node_panzoom toneAmber
class node_experimentsindex,node_phantom,node_experimentpage toneMint
class node_behanceapi,node_projectmock,node_gqlquery,node_imageproxy toneRose
class node_visitor,node_behance,node_imagehost toneIndigo
```

## Components

### Site experience

- [Home page](https://github.com/hongkiulam/site/blob/v2/src/pages/index.astro): `src/pages/index.astro`
- [Home visuals](https://github.com/hongkiulam/site/tree/v2/src/components/home): `src/components/home`
- [Mobile navigation](https://github.com/hongkiulam/site/blob/v2/src/components/MobileNav.tsx): `src/components/MobileNav.tsx`
- [Page wipe](https://github.com/hongkiulam/site/blob/v2/src/components/MobileNavPageWipe.tsx): `src/components/MobileNavPageWipe.tsx`

### Photography

- [Photo gallery](https://github.com/hongkiulam/site/blob/v2/src/pages/photos/index.astro): `src/pages/photos/index.astro`
- [Photo project](https://github.com/hongkiulam/site/blob/v2/src/pages/photos/%5BprojectId%5D.astro): `src/pages/photos/[projectId].astro`
- [Photo image](https://github.com/hongkiulam/site/blob/v2/src/components/photos/Image.svelte): `src/components/photos/Image.svelte`
- [Photo lightbox](https://github.com/hongkiulam/site/blob/v2/src/components/photos/Lightbox.svelte): `src/components/photos/Lightbox.svelte`
- [Canvas pan zoom](https://github.com/hongkiulam/site/blob/v2/src/components/photos/panZoomCanvas.ts): `src/components/photos/panZoomCanvas.ts`

### Experiments

- [Experiments index](https://github.com/hongkiulam/site/blob/v2/src/pages/experiments/index.astro): `src/pages/experiments/index.astro`
- [Phantom Land](https://github.com/hongkiulam/site/blob/v2/src/components/experiments/R3FPhantomLandClone.tsx): `src/components/experiments/R3FPhantomLandClone.tsx`
- [Experiment page](https://github.com/hongkiulam/site/blob/v2/src/pages/experiments/r3f-phantom-land-clone.astro): `src/pages/experiments/r3f-phantom-land-clone.astro`

### API integrations

- [Behance projects API](https://github.com/hongkiulam/site/blob/v2/src/pages/api/behance/all-graphql/index.ts): `src/pages/api/behance/all-graphql/index.ts`
- [Project mock data](https://github.com/hongkiulam/site/blob/v2/src/pages/api/behance/all-graphql/_projects.ts): `src/pages/api/behance/all-graphql/_projects.ts`
- [Projects query](https://github.com/hongkiulam/site/blob/v2/src/pages/api/behance/all-graphql/_projects.gql): `src/pages/api/behance/all-graphql/_projects.gql`
- [Image proxy](https://github.com/hongkiulam/site/blob/v2/src/pages/api/proxy-image/index.ts): `src/pages/api/proxy-image/index.ts`

### Other components

- **Visitor**
- **Behance GraphQL**
- **External image host**

## Connections

- Visitor → Home page: opens
- Visitor → Photo gallery: opens
- Visitor → Experiments index: opens
- Mobile navigation → Page wipe: renders (evidence: `src/components/MobileNav.tsx`)
- Photo image → Photo lightbox: opens (evidence: `src/components/photos/Image.svelte`)
- Photo lightbox → Canvas pan zoom: uses (evidence: `src/components/photos/Lightbox.svelte`)
- Behance projects API → Project mock data: loads in development (evidence: `src/pages/api/behance/all-graphql/index.ts`)
- Behance projects API → Projects query: reads query (evidence: `src/pages/api/behance/all-graphql/index.ts`)
- Behance projects API → Behance GraphQL: fetches projects (evidence: `src/pages/api/behance/all-graphql/index.ts`)
- Image proxy → External image host: fetches image (evidence: `src/pages/api/proxy-image/index.ts`)
