# kaiser54/temitope-portfolio architecture

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

## Overview

This is a personal portfolio and writing site. A visitor enters through the web app, which reads the current route and renders the home page, a work/notes/explorations section, or an individual note; section navigation updates the route, and route metadata follows it. The site also includes interactive animation demonstrations and a simulated Ask AI textbox. The graph emphasizes those user-facing branches and the shared motion layer. Some subsystem links rely on SOURCE INDEX references rather than inspected implementations, so uncertain connections are omitted.

Main entry points: [`apps/web/src/App.tsx`](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/App.tsx) (Web app), [`apps/web/src/components/SectionTabs.tsx`](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/SectionTabs.tsx) (Section navigation), [`apps/web/src/animate.ts`](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/animate.ts) (Animation loader), [`apps/web/src/components/NotePage.tsx`](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/NotePage.tsx) (Individual notes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site shell"]
  node_webapp["Web app<br/>[App.tsx]"]
  node_route["Route handling<br/>[router.ts]"]
  node_seo["Route metadata<br/>[seo.ts]"]
  node_localtime["Local time<br/>[LocalTime.tsx]"]
  node_theme["Theme toggle<br/>[ThemeToggle.tsx]"]
  node_footer["Interactive footer<br/>[FooterString.tsx]"]
end

subgraph group_browse["Portfolio browsing"]
  node_profile["Profile and content<br/>[content.ts]"]
  node_company["Company details<br/>[Company.tsx]"]
  node_tabs["Section navigation<br/>[SectionTabs.tsx]"]
  node_projects["Project listings<br/>[Projects.tsx]"]
  node_explorations["Explorations<br/>[Explorations.tsx]"]
end

subgraph group_notes["Notes and demos"]
  node_noteslist["Notes listing<br/>[Notes.tsx]"]
  node_notepage["Individual notes<br/>[NotePage.tsx]"]
  node_themeswitchernote["Theme switcher note"]
  node_askainote["Ask AI note<br/>[AskAiNote.tsx]"]
  node_notedemos["Motion demonstrations<br/>[NoteDemos.tsx]"]
  node_codeblock["Code examples<br/>[CodeBlock.tsx]"]
end

subgraph group_runtime["Motion and UI"]
  node_rollingtext["Rolling text<br/>[RollingText.tsx]"]
  node_scrubber["Animation scrubber<br/>[Scrubber.tsx]"]
  node_catapult["Catapult interaction<br/>[catapult.ts]"]
  node_swipe["Swipe gestures<br/>[useSwipeTabs.ts]"]
  node_motion["Motion configuration<br/>[motion.tsx]"]
  node_animate["Animation loader<br/>[animate.ts]"]
  node_motionengine["Motion engine<br/>[motion-engine.ts]"]
  node_asktextbox["Ask AI textbox<br/>[AskAiTextbox.tsx]"]
  node_fakeresponse["Canned responses<br/>[dummy.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_webapp
node_webapp -->|"reads route"| node_route
node_webapp -->|"reads profile"| node_profile
node_webapp -->|"renders"| node_company
node_webapp -->|"renders"| node_localtime
node_webapp -->|"renders"| node_theme
node_webapp -->|"renders"| node_footer
node_webapp -->|"renders"| node_tabs
node_webapp -->|"renders"| node_notepage
node_webapp -->|"provides motion"| node_motion
node_route -->|"gets route metadata"| node_seo
node_tabs -->|"navigates"| node_route
node_tabs -->|"reads listings"| node_profile
node_tabs -->|"renders"| node_projects
node_tabs -->|"renders"| node_noteslist
node_tabs -->|"renders"| node_explorations
node_tabs -->|"uses gestures"| node_swipe
node_notepage -->|"renders"| node_themeswitchernote
node_notepage -->|"renders"| node_askainote
node_themeswitchernote -->|"renders demos"| node_notedemos
node_themeswitchernote -->|"renders examples"| node_codeblock
node_notedemos -->|"uses scrubber"| node_scrubber
node_notedemos -->|"uses text effect"| node_rollingtext
node_footer -->|"animates with"| node_animate
node_swipe -->|"animates with"| node_animate
node_motion -->|"loads"| node_animate
node_animate -->|"loads on demand"| node_motionengine
node_asktextbox -->|"uses responses"| node_fakeresponse

click node_webapp "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/App.tsx"
click node_route "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/router.ts"
click node_seo "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/seo.ts"
click node_profile "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/content.ts"
click node_company "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Company.tsx"
click node_localtime "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/LocalTime.tsx"
click node_theme "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/ThemeToggle.tsx"
click node_footer "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/FooterString.tsx"
click node_tabs "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/SectionTabs.tsx"
click node_projects "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Projects.tsx"
click node_noteslist "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Notes.tsx"
click node_explorations "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Explorations.tsx"
click node_notepage "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/NotePage.tsx"
click node_themeswitchernote "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/notes/ThemeSwitcherNote.tsx"
click node_askainote "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/notes/AskAiNote.tsx"
click node_notedemos "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/NoteDemos.tsx"
click node_codeblock "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/CodeBlock.tsx"
click node_rollingtext "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/RollingText.tsx"
click node_scrubber "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Scrubber.tsx"
click node_catapult "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/catapult.ts"
click node_swipe "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/useSwipeTabs.ts"
click node_motion "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/motion.tsx"
click node_animate "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/animate.ts"
click node_motionengine "https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/motion-engine.ts"
click node_asktextbox "https://github.com/kaiser54/temitope-portfolio/blob/main/packages/ui/src/components/ask-ai/AskAiTextbox.tsx"
click node_fakeresponse "https://github.com/kaiser54/temitope-portfolio/blob/main/packages/ui/src/components/ask-ai/dummy.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_webapp,node_route,node_seo,node_localtime,node_theme,node_footer toneBlue
class node_profile,node_company,node_tabs,node_projects,node_explorations toneAmber
class node_noteslist,node_notepage,node_themeswitchernote,node_askainote,node_notedemos,node_codeblock toneMint
class node_rollingtext,node_scrubber,node_catapult,node_swipe,node_motion,node_animate,node_motionengine,node_asktextbox,node_fakeresponse toneRose
class node_visitor toneIndigo
```

## Components

### Site shell

- [Web app](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Route handling](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/router.ts): `apps/web/src/router.ts`
- [Route metadata](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/seo.ts): `apps/web/src/seo.ts`
- [Local time](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/LocalTime.tsx): `apps/web/src/components/LocalTime.tsx`
- [Theme toggle](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/ThemeToggle.tsx): `apps/web/src/components/ThemeToggle.tsx`
- [Interactive footer](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/FooterString.tsx): `apps/web/src/components/FooterString.tsx`

### Portfolio browsing

- [Profile and content](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/content.ts): `apps/web/src/content.ts`
- [Company details](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Company.tsx): `apps/web/src/components/Company.tsx`
- [Section navigation](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/SectionTabs.tsx): `apps/web/src/components/SectionTabs.tsx`
- [Project listings](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Projects.tsx): `apps/web/src/components/Projects.tsx`
- [Explorations](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Explorations.tsx): `apps/web/src/components/Explorations.tsx`

### Notes and demos

- [Notes listing](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Notes.tsx): `apps/web/src/components/Notes.tsx`
- [Individual notes](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/NotePage.tsx): `apps/web/src/components/NotePage.tsx`
- [Theme switcher note](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/notes/ThemeSwitcherNote.tsx): `apps/web/src/notes/ThemeSwitcherNote.tsx`
- [Ask AI note](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/notes/AskAiNote.tsx): `apps/web/src/notes/AskAiNote.tsx`
- [Motion demonstrations](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/NoteDemos.tsx): `apps/web/src/components/NoteDemos.tsx`
- [Code examples](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/CodeBlock.tsx): `apps/web/src/components/CodeBlock.tsx`

### Motion and UI

- [Rolling text](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/RollingText.tsx): `apps/web/src/components/RollingText.tsx`
- [Animation scrubber](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/Scrubber.tsx): `apps/web/src/components/Scrubber.tsx`
- [Catapult interaction](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/catapult.ts): `apps/web/src/components/catapult.ts`
- [Swipe gestures](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/components/useSwipeTabs.ts): `apps/web/src/components/useSwipeTabs.ts`
- [Motion configuration](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/motion.tsx): `apps/web/src/motion.tsx`
- [Animation loader](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/animate.ts): `apps/web/src/animate.ts`
- [Motion engine](https://github.com/kaiser54/temitope-portfolio/blob/main/apps/web/src/motion-engine.ts): `apps/web/src/motion-engine.ts`
- [Ask AI textbox](https://github.com/kaiser54/temitope-portfolio/blob/main/packages/ui/src/components/ask-ai/AskAiTextbox.tsx): `packages/ui/src/components/ask-ai/AskAiTextbox.tsx`
- [Canned responses](https://github.com/kaiser54/temitope-portfolio/blob/main/packages/ui/src/components/ask-ai/dummy.ts): `packages/ui/src/components/ask-ai/dummy.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Web app: opens
- Web app → Route handling: reads route (evidence: `apps/web/src/App.tsx`)
- Web app → Profile and content: reads profile (evidence: `apps/web/src/App.tsx`)
- Web app → Company details: renders (evidence: `apps/web/src/App.tsx`)
- Web app → Local time: renders (evidence: `apps/web/src/App.tsx`)
- Web app → Theme toggle: renders (evidence: `apps/web/src/App.tsx`)
- Web app → Interactive footer: renders (evidence: `apps/web/src/App.tsx`)
- Web app → Section navigation: renders (evidence: `apps/web/src/App.tsx`)
- Web app → Individual notes: renders (evidence: `apps/web/src/App.tsx`)
- Web app → Motion configuration: provides motion (evidence: `apps/web/src/App.tsx`)
- Route handling → Route metadata: gets route metadata (evidence: `apps/web/src/router.ts`)
- Section navigation → Route handling: navigates (evidence: `apps/web/src/components/SectionTabs.tsx`)
- Section navigation → Profile and content: reads listings (evidence: `apps/web/src/components/SectionTabs.tsx`)
- Section navigation → Project listings: renders (evidence: `apps/web/src/components/SectionTabs.tsx`)
- Section navigation → Notes listing: renders (evidence: `apps/web/src/components/SectionTabs.tsx`)
- Section navigation → Explorations: renders (evidence: `apps/web/src/components/SectionTabs.tsx`)
- Section navigation → Swipe gestures: uses gestures (evidence: `apps/web/src/components/useSwipeTabs.ts`)
- Individual notes → Theme switcher note: renders (evidence: `apps/web/src/components/NotePage.tsx`)
- Individual notes → Ask AI note: renders (evidence: `apps/web/src/components/NotePage.tsx`)
- Theme switcher note → Motion demonstrations: renders demos (evidence: `apps/web/src/notes/ThemeSwitcherNote.tsx`)
- Theme switcher note → Code examples: renders examples (evidence: `apps/web/src/notes/ThemeSwitcherNote.tsx`)
- Motion demonstrations → Animation scrubber: uses scrubber (evidence: `apps/web/src/components/NoteDemos.tsx`)
- Motion demonstrations → Rolling text: uses text effect (evidence: `apps/web/src/components/NoteDemos.tsx`)
- Interactive footer → Animation loader: animates with (evidence: `apps/web/src/components/FooterString.tsx`)
- Swipe gestures → Animation loader: animates with (evidence: `apps/web/src/components/useSwipeTabs.ts`)
- Motion configuration → Animation loader: loads (evidence: `apps/web/src/motion.tsx`)
- Animation loader → Motion engine: loads on demand (evidence: `apps/web/src/animate.ts`)
- Ask AI textbox → Canned responses: uses responses (evidence: `packages/ui/src/components/ask-ai/AskAiTextbox.tsx`)
