# devjhawar11/portfolio architecture

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

## Overview

devjhawar.com is an Astro portfolio: visitors browse projects and interactive explainers, discover work through the keyboard search palette, and check or wake live demos. Supporting branches publish GitHub contributions and writing, expose profile feeds, and provide contact notes. The graph includes the sampled runtime modules and documented capabilities; several page components are not present in the supplied tree, so their internal wiring is left out rather than inferred.

Main entry points: [`src/pages/search.json.ts`](https://github.com/devjhawar11/portfolio/blob/main/src/pages/search.json.ts) (Search catalog), [`src/pages/llms.txt.ts`](https://github.com/devjhawar11/portfolio/blob/main/src/pages/llms.txt.ts) (LLM profile feed), [`src/lib/status-client.ts`](https://github.com/devjhawar11/portfolio/blob/main/src/lib/status-client.ts) (Status experience), [`src/lib/health.ts`](https://github.com/devjhawar11/portfolio/blob/main/src/lib/health.ts) (Health checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio and content"]
  node_portfolio_site["Portfolio site"]
  node_project_content["Project content<br/>[content.config.ts]"]
  node_contact_api["Contact notes<br/>[note.ts]"]
  node_halftone["Halftone portrait<br/>[halftone.ts]"]
end

subgraph group_discovery["Search and feeds"]
  node_search_data["Search catalog<br/>[search.json.ts]"]
  node_palette_search["Palette ranking<br/>[search.ts]"]
  node_sections["Site sections<br/>[sections.ts]"]
  node_glossary["Glossary terms<br/>[glossary.ts]"]
  node_github_data["GitHub contributions<br/>[github.ts]"]
  node_devto_data["Writing posts<br/>[devto.ts]"]
  node_llms_feed["LLM profile feed<br/>[llms.txt.ts]"]
end

subgraph group_live["Live demo status"]
  node_status_page["Status experience<br/>[status-client.ts]"]
  node_status_api["Status function<br/>[status.ts]"]
  node_health_checks["Health checks<br/>[health.ts]"]
  node_status_targets["Demo targets<br/>[targets.ts]"]
  node_status_snapshot["Build snapshot"]
end

subgraph group_interaction["Interactive features"]
  node_sling_game["Footer slingshot<br/>[sling.ts]"]
  node_easter_eggs["Easter eggs<br/>[eggs.ts]"]
  node_sound_effects["Sound effects<br/>[sfx.ts]"]
end

node_visitor(("Visitor"))
node_github_service["GitHub"]
node_devto_service["dev.to"]
node_resend["Resend email"]
node_demo_services["Deployed demos"]

node_visitor -->|"browses"| node_portfolio_site
node_visitor -->|"opens search"| node_search_data
node_search_data -->|"indexes with"| node_palette_search
node_search_data -->|"collects projects"| node_project_content
node_search_data -->|"uses"| node_sections
node_search_data -->|"uses"| node_glossary
node_search_data -->|"loads PRs"| node_github_data
node_search_data -->|"loads posts"| node_devto_data
node_github_data -->|"fetches from"| node_github_service
node_devto_data -.->|"fetches from"| node_devto_service
node_visitor -.->|"requests profile"| node_llms_feed
node_llms_feed -->|"loads PRs"| node_github_data
node_llms_feed -->|"loads posts"| node_devto_data
node_visitor -.->|"sends note"| node_contact_api
node_contact_api -->|"sends email"| node_resend
node_visitor -->|"checks demos"| node_status_page
node_status_page -->|"fetches status"| node_status_api
node_status_page -->|"falls back to"| node_status_snapshot
node_status_api -->|"runs checks"| node_health_checks
node_health_checks -->|"checks targets"| node_status_targets
node_health_checks -->|"probes"| node_demo_services
node_visitor -.->|"plays"| node_sling_game
node_sling_game -->|"plays sounds"| node_sound_effects
node_sling_game -->|"unlocks"| node_easter_eggs
node_visitor -.->|"views portrait"| node_halftone

click node_portfolio_site "https://github.com/devjhawar11/portfolio/tree/main/src/pages"
click node_project_content "https://github.com/devjhawar11/portfolio/blob/main/src/content.config.ts"
click node_search_data "https://github.com/devjhawar11/portfolio/blob/main/src/pages/search.json.ts"
click node_palette_search "https://github.com/devjhawar11/portfolio/blob/main/src/components/Palette/search.ts"
click node_sections "https://github.com/devjhawar11/portfolio/blob/main/src/lib/sections.ts"
click node_glossary "https://github.com/devjhawar11/portfolio/blob/main/src/lib/glossary.ts"
click node_github_data "https://github.com/devjhawar11/portfolio/blob/main/src/lib/github.ts"
click node_devto_data "https://github.com/devjhawar11/portfolio/blob/main/src/lib/devto.ts"
click node_llms_feed "https://github.com/devjhawar11/portfolio/blob/main/src/pages/llms.txt.ts"
click node_contact_api "https://github.com/devjhawar11/portfolio/blob/main/api/note.ts"
click node_status_page "https://github.com/devjhawar11/portfolio/blob/main/src/lib/status-client.ts"
click node_status_api "https://github.com/devjhawar11/portfolio/blob/main/api/status.ts"
click node_health_checks "https://github.com/devjhawar11/portfolio/blob/main/src/lib/health.ts"
click node_status_targets "https://github.com/devjhawar11/portfolio/blob/main/src/lib/targets.ts"
click node_status_snapshot "https://github.com/devjhawar11/portfolio/blob/main/src/pages/status-snapshot.json.ts"
click node_sling_game "https://github.com/devjhawar11/portfolio/blob/main/src/lib/sling.ts"
click node_easter_eggs "https://github.com/devjhawar11/portfolio/blob/main/src/lib/eggs.ts"
click node_sound_effects "https://github.com/devjhawar11/portfolio/blob/main/src/lib/sfx.ts"
click node_halftone "https://github.com/devjhawar11/portfolio/blob/main/src/lib/halftone.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_portfolio_site,node_project_content,node_contact_api,node_halftone toneBlue
class node_search_data,node_palette_search,node_sections,node_glossary,node_github_data,node_devto_data,node_llms_feed toneAmber
class node_status_page,node_status_api,node_health_checks,node_status_targets,node_status_snapshot toneMint
class node_sling_game,node_easter_eggs,node_sound_effects toneRose
class node_visitor,node_github_service,node_devto_service,node_resend,node_demo_services toneIndigo
```

## Components

### Portfolio and content

- [Portfolio site](https://github.com/devjhawar11/portfolio/tree/main/src/pages): `src/pages`
- [Project content](https://github.com/devjhawar11/portfolio/blob/main/src/content.config.ts): `src/content.config.ts`
- [Contact notes](https://github.com/devjhawar11/portfolio/blob/main/api/note.ts): `api/note.ts`
- [Halftone portrait](https://github.com/devjhawar11/portfolio/blob/main/src/lib/halftone.ts): `src/lib/halftone.ts`

### Search and feeds

- [Search catalog](https://github.com/devjhawar11/portfolio/blob/main/src/pages/search.json.ts): `src/pages/search.json.ts`
- [Palette ranking](https://github.com/devjhawar11/portfolio/blob/main/src/components/Palette/search.ts): `src/components/Palette/search.ts`
- [Site sections](https://github.com/devjhawar11/portfolio/blob/main/src/lib/sections.ts): `src/lib/sections.ts`
- [Glossary terms](https://github.com/devjhawar11/portfolio/blob/main/src/lib/glossary.ts): `src/lib/glossary.ts`
- [GitHub contributions](https://github.com/devjhawar11/portfolio/blob/main/src/lib/github.ts): `src/lib/github.ts`
- [Writing posts](https://github.com/devjhawar11/portfolio/blob/main/src/lib/devto.ts): `src/lib/devto.ts`
- [LLM profile feed](https://github.com/devjhawar11/portfolio/blob/main/src/pages/llms.txt.ts): `src/pages/llms.txt.ts`

### Live demo status

- [Status experience](https://github.com/devjhawar11/portfolio/blob/main/src/lib/status-client.ts): `src/lib/status-client.ts`
- [Status function](https://github.com/devjhawar11/portfolio/blob/main/api/status.ts): `api/status.ts`
- [Health checks](https://github.com/devjhawar11/portfolio/blob/main/src/lib/health.ts): `src/lib/health.ts`
- [Demo targets](https://github.com/devjhawar11/portfolio/blob/main/src/lib/targets.ts): `src/lib/targets.ts`
- [Build snapshot](https://github.com/devjhawar11/portfolio/blob/main/src/pages/status-snapshot.json.ts): `src/pages/status-snapshot.json.ts`

### Interactive features

- [Footer slingshot](https://github.com/devjhawar11/portfolio/blob/main/src/lib/sling.ts): `src/lib/sling.ts`
- [Easter eggs](https://github.com/devjhawar11/portfolio/blob/main/src/lib/eggs.ts): `src/lib/eggs.ts`
- [Sound effects](https://github.com/devjhawar11/portfolio/blob/main/src/lib/sfx.ts): `src/lib/sfx.ts`

### Other components

- **Visitor**
- **GitHub**
- **dev.to**
- **Resend email**
- **Deployed demos**

## Connections

- Visitor → Portfolio site: browses
- Visitor → Search catalog: opens search
- Search catalog → Palette ranking: indexes with (evidence: `src/pages/search.json.ts`)
- Search catalog → Project content: collects projects (evidence: `src/pages/search.json.ts`)
- Search catalog → Site sections: uses (evidence: `src/pages/search.json.ts`)
- Search catalog → Glossary terms: uses (evidence: `src/pages/search.json.ts`)
- Search catalog → GitHub contributions: loads PRs (evidence: `src/pages/search.json.ts`)
- Search catalog → Writing posts: loads posts (evidence: `src/pages/search.json.ts`)
- GitHub contributions → GitHub: fetches from (evidence: `src/lib/github.ts`)
- Writing posts → dev.to: fetches from
- Visitor → LLM profile feed: requests profile
- LLM profile feed → GitHub contributions: loads PRs (evidence: `src/pages/llms.txt.ts`)
- LLM profile feed → Writing posts: loads posts (evidence: `src/pages/llms.txt.ts`)
- Visitor → Contact notes: sends note
- Contact notes → Resend email: sends email (evidence: `api/note.ts`)
- Visitor → Status experience: checks demos
- Status experience → Status function: fetches status (evidence: `src/lib/status-client.ts`)
- Status experience → Build snapshot: falls back to (evidence: `src/lib/status-client.ts`)
- Status function → Health checks: runs checks (evidence: `api/status.ts`)
- Health checks → Demo targets: checks targets (evidence: `src/pages/status-snapshot.json.ts`)
- Health checks → Deployed demos: probes (evidence: `src/lib/health.ts`)
- Visitor → Footer slingshot: plays
- Footer slingshot → Sound effects: plays sounds (evidence: `src/lib/sling.ts`)
- Footer slingshot → Easter eggs: unlocks (evidence: `src/lib/sling.ts`)
- Visitor → Halftone portrait: views portrait
