# sum-boop/sum-boop.github.io architecture

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

- Interactive diagram: https://gitdiagram.com/sum-boop/sum-boop.github.io
- Repository: https://github.com/sum-boop/sum-boop.github.io

## Overview

This is a React portfolio presenting a CCTV and surveillance specialist’s work, capabilities, credentials, and contact channels. Visitors enter a composed single-page experience, explore deployment summaries and briefings, review career and skills content, then reach the operator through direct messaging links. A VMS-themed interactive layer lets visitors switch operational views and deployment filters; a 3D workstation and Earth scene provide visual context. The graph follows documented composition and sampled calls; some feature implementations are unsampled, so their internal wiring is not inferred.

Main entry points: [`src/sections/PortfolioSections.tsx`](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/sections/PortfolioSections.tsx) (Section composition), [`src/App.tsx`](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/App.tsx) (App shell), [`src/components/ContactForm.tsx`](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/ContactForm.tsx) (Contact composer), [`src/components/Deployments.tsx`](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/Deployments.tsx) (Deployment briefings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_appshell["App shell<br/>[App.tsx]"]
  node_sections["Section composition"]
  node_palette["Command palette<br/>[CommandPalette.tsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_content["Career and skills<br/>[Experience.tsx]"]
  node_data["Portfolio data<br/>[profile.ts]"]
  node_contact["Contact composer<br/>[ContactForm.tsx]"]
  node_contactdata["Contact channels<br/>[contact.ts]"]
end

subgraph group_operations["Operations showcase"]
  node_vms["VMS workspace state<br/>[VmsContext.tsx]"]
  node_vmslogic["VMS category logic<br/>[vmsLogic.ts]"]
  node_deployments["Deployment briefings<br/>[Deployments.tsx]"]
  node_projectdata["Deployment content<br/>[projects.ts]"]
  node_briefing["Briefing modal<br/>[App.tsx]"]
  node_workstation["3D workstation"]
  node_stage3d["Surveillance scene"]
  node_materials["Scene materials<br/>[materials.ts]"]
  node_model["Surveillance model"]
  node_earth["Earth centerpiece<br/>[EarthGlobe.tsx]"]
end

subgraph group_experience["Interaction foundations"]
  node_motion["Motion system<br/>[primitives.tsx]"]
  node_theme["Theme preference<br/>[useTheme.ts]"]
end

node_visitor(("Portfolio visitor"))
node_storage[("Browser local storage")]
node_messaging(("Messaging apps"))

node_visitor -->|"opens portfolio"| node_entry
node_entry -->|"renders"| node_appshell
node_appshell -->|"composes"| node_sections
node_appshell -->|"opens"| node_palette
node_sections -->|"uses transitions"| node_motion
node_sections -->|"renders"| node_deployments
node_sections -->|"renders"| node_workstation
node_sections -->|"renders"| node_earth
node_sections -->|"renders"| node_content
node_deployments -->|"reads briefings"| node_projectdata
node_deployments -->|"opens selection"| node_briefing
node_appshell -->|"renders"| node_briefing
node_appshell -->|"sets selected site and feed"| node_vms
node_palette -->|"controls workspace"| node_vms
node_vms -->|"resolves category mode"| node_vmslogic
node_workstation -.->|"presents 3D stage"| node_stage3d
node_stage3d -->|"uses"| node_materials
node_stage3d -->|"uses"| node_model
node_content -.->|"presents portfolio information"| node_data
node_sections -->|"renders"| node_contact
node_contact -->|"reads channels"| node_contactdata
node_contact -->|"opens direct links"| node_messaging
node_visitor -.->|"toggles theme"| node_theme
node_theme -->|"persists preference"| node_storage

click node_entry "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/main.tsx"
click node_appshell "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/App.tsx"
click node_sections "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/sections/PortfolioSections.tsx"
click node_palette "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/CommandPalette.tsx"
click node_vms "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/context/VmsContext.tsx"
click node_vmslogic "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/utils/vmsLogic.ts"
click node_deployments "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/Deployments.tsx"
click node_projectdata "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/data/projects.ts"
click node_briefing "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/App.tsx"
click node_workstation "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/WorkstationBand.tsx"
click node_stage3d "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/three/SurveillanceStage3D.tsx"
click node_materials "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/three/materials.ts"
click node_model "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/three/surveillanceModel.ts"
click node_earth "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/EarthGlobe.tsx"
click node_content "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/Experience.tsx"
click node_data "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/data/profile.ts"
click node_contact "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/ContactForm.tsx"
click node_contactdata "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/data/contact.ts"
click node_motion "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/motion/primitives.tsx"
click node_theme "https://github.com/sum-boop/sum-boop.github.io/blob/main/src/hooks/useTheme.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_entry,node_appshell,node_sections,node_palette toneBlue
class node_content,node_data,node_contact,node_contactdata,node_storage toneAmber
class node_vms,node_vmslogic,node_deployments,node_projectdata,node_briefing,node_workstation,node_stage3d,node_materials,node_model,node_earth toneMint
class node_motion,node_theme toneRose
class node_visitor,node_messaging toneIndigo
```

## Components

### Application shell

- [React entry](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/main.tsx): `src/main.tsx`
- [App shell](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/App.tsx): `src/App.tsx`
- [Section composition](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/sections/PortfolioSections.tsx): `src/sections/PortfolioSections.tsx`
- [Command palette](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/CommandPalette.tsx): `src/components/CommandPalette.tsx`

### Portfolio content

- [Career and skills](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/Experience.tsx): `src/components/Experience.tsx`
- [Portfolio data](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/data/profile.ts): `src/data/profile.ts`
- [Contact composer](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/ContactForm.tsx): `src/components/ContactForm.tsx`
- [Contact channels](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/data/contact.ts): `src/data/contact.ts`

### Operations showcase

- [VMS workspace state](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/context/VmsContext.tsx): `src/context/VmsContext.tsx`
- [VMS category logic](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/utils/vmsLogic.ts): `src/utils/vmsLogic.ts`
- [Deployment briefings](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/Deployments.tsx): `src/components/Deployments.tsx`
- [Deployment content](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/data/projects.ts): `src/data/projects.ts`
- [Briefing modal](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/App.tsx): `src/App.tsx`
- [3D workstation](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/WorkstationBand.tsx): `src/components/WorkstationBand.tsx`
- [Surveillance scene](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/three/SurveillanceStage3D.tsx): `src/components/three/SurveillanceStage3D.tsx`
- [Scene materials](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/three/materials.ts): `src/components/three/materials.ts`
- [Surveillance model](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/three/surveillanceModel.ts): `src/components/three/surveillanceModel.ts`
- [Earth centerpiece](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/components/EarthGlobe.tsx): `src/components/EarthGlobe.tsx`

### Interaction foundations

- [Motion system](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/motion/primitives.tsx): `src/motion/primitives.tsx`
- [Theme preference](https://github.com/sum-boop/sum-boop.github.io/blob/main/src/hooks/useTheme.ts): `src/hooks/useTheme.ts`

### Other components

- **Portfolio visitor**
- **Browser local storage**
- **Messaging apps**

## Connections

- Portfolio visitor → React entry: opens portfolio
- React entry → App shell: renders (evidence: `src/main.tsx`)
- App shell → Section composition: composes (evidence: `src/App.tsx`)
- App shell → Command palette: opens (evidence: `src/App.tsx`)
- Section composition → Motion system: uses transitions (evidence: `src/sections/PortfolioSections.tsx`)
- Section composition → Deployment briefings: renders (evidence: `src/sections/PortfolioSections.tsx`)
- Section composition → 3D workstation: renders (evidence: `src/sections/PortfolioSections.tsx`)
- Section composition → Earth centerpiece: renders (evidence: `src/sections/PortfolioSections.tsx`)
- Section composition → Career and skills: renders (evidence: `src/sections/PortfolioSections.tsx`)
- Deployment briefings → Deployment content: reads briefings (evidence: `src/components/Deployments.tsx`)
- Deployment briefings → Briefing modal: opens selection (evidence: `src/App.tsx`)
- App shell → Briefing modal: renders (evidence: `src/App.tsx`)
- App shell → VMS workspace state: sets selected site and feed (evidence: `src/App.tsx`)
- Command palette → VMS workspace state: controls workspace (evidence: `src/components/CommandPalette.tsx`)
- VMS workspace state → VMS category logic: resolves category mode (evidence: `src/context/VmsContext.tsx`)
- 3D workstation → Surveillance scene: presents 3D stage
- Surveillance scene → Scene materials: uses (evidence: `src/components/three/SurveillanceStage3D.tsx`)
- Surveillance scene → Surveillance model: uses (evidence: `src/components/three/SurveillanceStage3D.tsx`)
- Career and skills → Portfolio data: presents portfolio information
- Section composition → Contact composer: renders (evidence: `src/sections/PortfolioSections.tsx`)
- Contact composer → Contact channels: reads channels (evidence: `src/components/ContactForm.tsx`)
- Contact composer → Messaging apps: opens direct links
- Portfolio visitor → Theme preference: toggles theme
- Theme preference → Browser local storage: persists preference (evidence: `src/hooks/useTheme.ts`)
