# trahman888/trahman888.github.io architecture

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

- Interactive diagram: https://gitdiagram.com/trahman888/trahman888.github.io
- Repository: https://github.com/trahman888/trahman888.github.io
- Video tour (about a minute): https://gitdiagram.com/trahman888/trahman888.github.io/video

## Overview

This is a static React academic portfolio: visitors browse a research profile, filter publications, and optionally open eligible paper explainer pages. Content is maintained in TypeScript data files; the README also documents a Scholar-metrics refresh script. The graph follows routing and component relationships visible in the excerpts and SOURCE INDEX. Some content components and data modules are unsampled, so their internal behavior and unshown links are not inferred.

Main entry points: [`src/pages/Home.tsx`](https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/Home.tsx) (Home page), [`src/pages/Publication.tsx`](https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/Publication.tsx) (Publication page), [`src/components/Publications.tsx`](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Publications.tsx) (Publication catalog), [`src/data`](https://github.com/trahman888/trahman888.github.io/tree/main/src/data) (Portfolio data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing and pages"]
  node_app["Route dispatcher<br/>[App.tsx]"]
  node_home["Home page<br/>[Home.tsx]"]
  node_publication_page["Publication page<br/>[Publication.tsx]"]
  node_not_found["Not found page<br/>[NotFound.tsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_profile_sections["Profile sections<br/>[About.tsx]"]
  node_impact["Impact metrics<br/>[Impact.tsx]"]
  node_news["News timeline<br/>[News.tsx]"]
  node_awards["Awards<br/>[Awards.tsx]"]
  node_site_content["Portfolio data"]
  node_scholar_refresh["Scholar scraper<br/>[scrape_scholar.py]"]
end

subgraph group_publication["Publication experience"]
  node_publication_list["Publication catalog<br/>[Publications.tsx]"]
  node_publication_data["Publication records<br/>[publications.ts]"]
  node_publication_detail["Paper explainers<br/>[Section.tsx]"]
  node_publication_nav["Paper pager"]
  node_publication_links["Paper links"]
  node_publication_thumbs["Paper thumbnails"]
end

subgraph group_shared["Shared presentation"]
  node_navbar["Navigation bar<br/>[Navbar.tsx]"]
  node_notice["Site notice<br/>[NoticeBar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_theme["Theme control<br/>[ThemeToggle.tsx]"]
  node_rich_text["Rich-text renderer<br/>[RichText.tsx]"]
  node_rich_utils["Rich-text utilities<br/>[richTextUtils.tsx]"]
  node_compress["Compact-view context"]
  node_theme_context["Theme context<br/>[theme-context.ts]"]
end

node_visitor(("Visitor"))
node_scholar(("Google Scholar"))

node_visitor -->|"opens site"| node_app
node_app -->|"routes home"| node_home
node_app -->|"routes papers"| node_publication_page
node_app -->|"routes fallback"| node_not_found
node_home -->|"renders"| node_profile_sections
node_home -->|"renders"| node_impact
node_home -->|"renders"| node_news
node_home -->|"renders"| node_awards
node_home -->|"renders"| node_publication_list
node_home -->|"renders"| node_navbar
node_home -->|"renders"| node_notice
node_home -->|"renders"| node_footer
node_profile_sections -->|"reads profile"| node_site_content
node_impact -->|"reads metrics"| node_site_content
node_news -->|"reads news"| node_site_content
node_awards -->|"reads awards"| node_site_content
node_notice -->|"reads notice"| node_site_content
node_publication_list -->|"reads records"| node_publication_data
node_publication_list -->|"renders"| node_publication_thumbs
node_publication_list -->|"renders"| node_publication_links
node_publication_list -->|"renders text"| node_rich_text
node_publication_page -->|"renders list"| node_publication_list
node_publication_page -->|"renders sections"| node_publication_detail
node_publication_page -->|"renders pager"| node_publication_nav
node_publication_page -->|"renders links"| node_publication_links
node_publication_page -->|"renders"| node_navbar
node_publication_page -->|"renders"| node_notice
node_publication_page -->|"renders"| node_footer
node_publication_detail -->|"renders"| node_publication_thumbs
node_navbar -->|"renders toggle"| node_theme
node_theme -->|"uses context"| node_theme_context
node_navbar -->|"uses context"| node_compress
node_rich_text -->|"renders with"| node_rich_utils
node_scholar_refresh -->|"scrapes metrics"| node_scholar

click node_app "https://github.com/trahman888/trahman888.github.io/blob/main/src/App.tsx"
click node_home "https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/Home.tsx"
click node_publication_page "https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/Publication.tsx"
click node_not_found "https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/NotFound.tsx"
click node_profile_sections "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/About.tsx"
click node_impact "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Impact.tsx"
click node_news "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/News.tsx"
click node_awards "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Awards.tsx"
click node_site_content "https://github.com/trahman888/trahman888.github.io/tree/main/src/data"
click node_scholar_refresh "https://github.com/trahman888/trahman888.github.io/blob/main/scripts/scrape_scholar.py"
click node_publication_list "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Publications.tsx"
click node_publication_data "https://github.com/trahman888/trahman888.github.io/blob/main/src/data/publications.ts"
click node_publication_detail "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Section.tsx"
click node_publication_nav "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/PublicationPager.tsx"
click node_publication_links "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/PublicationLinks.tsx"
click node_publication_thumbs "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/PublicationThumb.tsx"
click node_navbar "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Navbar.tsx"
click node_notice "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/NoticeBar.tsx"
click node_footer "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Footer.tsx"
click node_theme "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/ThemeToggle.tsx"
click node_rich_text "https://github.com/trahman888/trahman888.github.io/blob/main/src/components/ui/RichText.tsx"
click node_rich_utils "https://github.com/trahman888/trahman888.github.io/blob/main/src/lib/richTextUtils.tsx"
click node_compress "https://github.com/trahman888/trahman888.github.io/blob/main/src/contexts/compress-context.ts"
click node_theme_context "https://github.com/trahman888/trahman888.github.io/blob/main/src/contexts/theme-context.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_app,node_home,node_publication_page,node_not_found toneBlue
class node_profile_sections,node_impact,node_news,node_awards,node_site_content,node_scholar_refresh toneAmber
class node_publication_list,node_publication_data,node_publication_detail,node_publication_nav,node_publication_links,node_publication_thumbs toneMint
class node_navbar,node_notice,node_footer,node_theme,node_rich_text,node_rich_utils,node_compress,node_theme_context toneRose
class node_visitor,node_scholar toneIndigo
```

## Components

### Routing and pages

- [Route dispatcher](https://github.com/trahman888/trahman888.github.io/blob/main/src/App.tsx): `src/App.tsx`
- [Home page](https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Publication page](https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/Publication.tsx): `src/pages/Publication.tsx`
- [Not found page](https://github.com/trahman888/trahman888.github.io/blob/main/src/pages/NotFound.tsx): `src/pages/NotFound.tsx`

### Portfolio content

- [Profile sections](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Impact metrics](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Impact.tsx): `src/components/Impact.tsx`
- [News timeline](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/News.tsx): `src/components/News.tsx`
- [Awards](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Awards.tsx): `src/components/Awards.tsx`
- [Portfolio data](https://github.com/trahman888/trahman888.github.io/tree/main/src/data): `src/data`
- [Scholar scraper](https://github.com/trahman888/trahman888.github.io/blob/main/scripts/scrape_scholar.py): `scripts/scrape_scholar.py`

### Publication experience

- [Publication catalog](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Publications.tsx): `src/components/Publications.tsx`
- [Publication records](https://github.com/trahman888/trahman888.github.io/blob/main/src/data/publications.ts): `src/data/publications.ts`
- [Paper explainers](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Section.tsx): `src/components/Section.tsx`
- [Paper pager](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/PublicationPager.tsx): `src/components/PublicationPager.tsx`
- [Paper links](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/PublicationLinks.tsx): `src/components/PublicationLinks.tsx`
- [Paper thumbnails](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/PublicationThumb.tsx): `src/components/PublicationThumb.tsx`

### Shared presentation

- [Navigation bar](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Site notice](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/NoticeBar.tsx): `src/components/NoticeBar.tsx`
- [Footer](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Theme control](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/ThemeToggle.tsx): `src/components/ThemeToggle.tsx`
- [Rich-text renderer](https://github.com/trahman888/trahman888.github.io/blob/main/src/components/ui/RichText.tsx): `src/components/ui/RichText.tsx`
- [Rich-text utilities](https://github.com/trahman888/trahman888.github.io/blob/main/src/lib/richTextUtils.tsx): `src/lib/richTextUtils.tsx`
- [Compact-view context](https://github.com/trahman888/trahman888.github.io/blob/main/src/contexts/compress-context.ts): `src/contexts/compress-context.ts`
- [Theme context](https://github.com/trahman888/trahman888.github.io/blob/main/src/contexts/theme-context.ts): `src/contexts/theme-context.ts`

### Other components

- **Visitor**
- **Google Scholar**

## Connections

- Visitor → Route dispatcher: opens site (evidence: `README.md`)
- Route dispatcher → Home page: routes home (evidence: `src/App.tsx`)
- Route dispatcher → Publication page: routes papers (evidence: `src/App.tsx`)
- Route dispatcher → Not found page: routes fallback (evidence: `src/App.tsx`)
- Home page → Profile sections: renders (evidence: `src/pages/Home.tsx`)
- Home page → Impact metrics: renders (evidence: `src/pages/Home.tsx`)
- Home page → News timeline: renders (evidence: `src/pages/Home.tsx`)
- Home page → Awards: renders (evidence: `src/pages/Home.tsx`)
- Home page → Publication catalog: renders (evidence: `src/pages/Home.tsx`)
- Home page → Navigation bar: renders (evidence: `src/pages/Home.tsx`)
- Home page → Site notice: renders (evidence: `src/pages/Home.tsx`)
- Home page → Footer: renders (evidence: `src/pages/Home.tsx`)
- Profile sections → Portfolio data: reads profile (evidence: `src/components/About.tsx`)
- Impact metrics → Portfolio data: reads metrics (evidence: `src/components/Impact.tsx`)
- News timeline → Portfolio data: reads news (evidence: `src/components/News.tsx`)
- Awards → Portfolio data: reads awards (evidence: `src/components/Awards.tsx`)
- Site notice → Portfolio data: reads notice (evidence: `src/components/NoticeBar.tsx`)
- Publication catalog → Publication records: reads records (evidence: `src/components/Publications.tsx`)
- Publication catalog → Paper thumbnails: renders (evidence: `src/components/Publications.tsx`)
- Publication catalog → Paper links: renders (evidence: `src/components/Publications.tsx`)
- Publication catalog → Rich-text renderer: renders text (evidence: `src/components/Publications.tsx`)
- Publication page → Publication catalog: renders list (evidence: `src/pages/Publication.tsx`)
- Publication page → Paper explainers: renders sections (evidence: `src/pages/Publication.tsx`)
- Publication page → Paper pager: renders pager (evidence: `src/pages/Publication.tsx`)
- Publication page → Paper links: renders links (evidence: `src/pages/Publication.tsx`)
- Publication page → Navigation bar: renders (evidence: `src/pages/Publication.tsx`)
- Publication page → Site notice: renders (evidence: `src/pages/Publication.tsx`)
- Publication page → Footer: renders (evidence: `src/pages/Publication.tsx`)
- Paper explainers → Paper thumbnails: renders (evidence: `src/components/Section.tsx`)
- Navigation bar → Theme control: renders toggle (evidence: `src/components/Navbar.tsx`)
- Theme control → Theme context: uses context (evidence: `src/components/ThemeToggle.tsx`)
- Navigation bar → Compact-view context: uses context (evidence: `src/components/Navbar.tsx`)
- Rich-text renderer → Rich-text utilities: renders with (evidence: `src/components/ui/RichText.tsx`)
- Scholar scraper → Google Scholar: scrapes metrics (evidence: `README.md`)
