# itshashi7/hashi-portfolio architecture

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

## Overview

This is a static, single-page personal portfolio. A visitor enters through the page shell, explores the hero and project case studies, browses experience and skills, and can ask questions through an in-browser keyword-matching chat. The graph preserves the documented content and interaction branches; shared motion and profile-data layers are included. Some components are represented by their directory because their implementation was not sampled, so those relationships are shown only where the page shell, README, or source index supports them.

Main entry points: [`app/page.tsx`](https://github.com/itshashi7/hashi-portfolio/blob/main/app/page.tsx) (Page Shell), [`lib/profile.ts`](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/profile.ts) (Profile Data), [`components/fx`](https://github.com/itshashi7/hashi-portfolio/tree/main/components/fx) (Visual Effects), [`components/sections/hero.tsx`](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/hero.tsx) (Hero)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site and Navigation"]
  node_page["Page Shell<br/>[page.tsx]"]
  node_nav["Section Navigation<br/>[nav.tsx]"]
  node_loader["Intro Loader<br/>[loader.tsx]"]
  node_providers["Theme Providers<br/>[providers.tsx]"]
end

subgraph group_content["Portfolio Content"]
  node_hero["Hero<br/>[hero.tsx]"]
  node_projects["Project Gallery<br/>[works.tsx]"]
  node_casebits["Case Study Details"]
  node_about["About<br/>[about.tsx]"]
  node_experiments["Experiments<br/>[experiments.tsx]"]
  node_stack["Skills and Stack<br/>[stack.tsx]"]
  node_marquee["Logo Marquee<br/>[marquee.tsx]"]
  node_footer["Footer and Agent View<br/>[footer.tsx]"]
end

subgraph group_interaction["Interactive Features"]
  node_chat["Ask Chat<br/>[ask.tsx]"]
  node_chatlogic["Chat Matching<br/>[chat.ts]"]
  node_visualfx["Visual Effects"]
  node_reactbits["React Bits Widgets"]
  node_ui["UI Components"]
end

subgraph group_shared["Shared Runtime"]
  node_profile["Profile Data<br/>[profile.ts]"]
  node_contentfile["Site Copy<br/>[profile.json]"]
  node_motion["Motion Runtime<br/>[motion.ts]"]
  node_tokens["Motion Tokens<br/>[tokens.ts]"]
  node_idle["Idle Scheduling<br/>[idle.ts]"]
  node_icons["Icon Mapping<br/>[icons.ts]"]
  node_agentmd["Agent Markdown<br/>[agent-markdown.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_page
node_page -->|"renders"| node_nav
node_page -->|"renders"| node_loader
node_page -->|"renders"| node_hero
node_page -->|"loads"| node_marquee
node_page -->|"loads"| node_projects
node_page -->|"loads"| node_experiments
node_page -->|"loads"| node_chat
node_page -->|"loads"| node_about
node_page -->|"loads"| node_stack
node_page -->|"loads"| node_footer
node_page -->|"renders"| node_visualfx
node_page -->|"uses"| node_providers
node_projects -->|"renders"| node_casebits
node_hero -->|"uses"| node_reactbits
node_marquee -->|"uses"| node_reactbits
node_hero -->|"reads"| node_profile
node_projects -->|"reads"| node_profile
node_about -->|"reads"| node_profile
node_experiments -->|"reads"| node_profile
node_stack -->|"reads"| node_profile
node_footer -->|"reads"| node_profile
node_profile -->|"imports"| node_contentfile
node_chat -->|"queries"| node_chatlogic
node_chatlogic -->|"uses"| node_profile
node_chat -->|"uses"| node_ui
node_nav -->|"uses"| node_ui
node_hero -->|"renders"| node_visualfx
node_visualfx -->|"uses"| node_motion
node_visualfx -->|"schedules with"| node_idle
node_visualfx -->|"uses"| node_tokens
node_marquee -->|"uses"| node_icons
node_footer -->|"renders"| node_agentmd
node_agentmd -->|"reads"| node_profile
node_nav -->|"uses"| node_profile

click node_page "https://github.com/itshashi7/hashi-portfolio/blob/main/app/page.tsx"
click node_nav "https://github.com/itshashi7/hashi-portfolio/blob/main/components/site/nav.tsx"
click node_loader "https://github.com/itshashi7/hashi-portfolio/blob/main/components/site/loader.tsx"
click node_hero "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/hero.tsx"
click node_projects "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/works.tsx"
click node_casebits "https://github.com/itshashi7/hashi-portfolio/tree/main/components/works"
click node_about "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/about.tsx"
click node_experiments "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/experiments.tsx"
click node_stack "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/stack.tsx"
click node_marquee "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/marquee.tsx"
click node_footer "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/footer.tsx"
click node_chat "https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/ask.tsx"
click node_chatlogic "https://github.com/itshashi7/hashi-portfolio/blob/main/lib/chat.ts"
click node_visualfx "https://github.com/itshashi7/hashi-portfolio/tree/main/components/fx"
click node_reactbits "https://github.com/itshashi7/hashi-portfolio/tree/main/components/reactbits"
click node_ui "https://github.com/itshashi7/hashi-portfolio/tree/main/components/ui"
click node_profile "https://github.com/itshashi7/hashi-portfolio/blob/main/lib/profile.ts"
click node_contentfile "https://github.com/itshashi7/hashi-portfolio/blob/main/content/profile.json"
click node_motion "https://github.com/itshashi7/hashi-portfolio/blob/main/lib/motion.ts"
click node_tokens "https://github.com/itshashi7/hashi-portfolio/blob/main/lib/tokens.ts"
click node_idle "https://github.com/itshashi7/hashi-portfolio/blob/main/lib/idle.ts"
click node_icons "https://github.com/itshashi7/hashi-portfolio/blob/main/lib/icons.ts"
click node_agentmd "https://github.com/itshashi7/hashi-portfolio/blob/main/lib/agent-markdown.ts"
click node_providers "https://github.com/itshashi7/hashi-portfolio/blob/main/components/providers.tsx"

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_page,node_nav,node_loader,node_providers toneBlue
class node_hero,node_projects,node_casebits,node_about,node_experiments,node_stack,node_marquee,node_footer toneAmber
class node_chat,node_chatlogic,node_visualfx,node_reactbits,node_ui toneMint
class node_profile,node_contentfile,node_motion,node_tokens,node_idle,node_icons,node_agentmd toneRose
class node_visitor toneIndigo
```

## Components

### Site and Navigation

- [Page Shell](https://github.com/itshashi7/hashi-portfolio/blob/main/app/page.tsx): `app/page.tsx`
- [Section Navigation](https://github.com/itshashi7/hashi-portfolio/blob/main/components/site/nav.tsx): `components/site/nav.tsx`
- [Intro Loader](https://github.com/itshashi7/hashi-portfolio/blob/main/components/site/loader.tsx): `components/site/loader.tsx`
- [Theme Providers](https://github.com/itshashi7/hashi-portfolio/blob/main/components/providers.tsx): `components/providers.tsx`

### Portfolio Content

- [Hero](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/hero.tsx): `components/sections/hero.tsx`
- [Project Gallery](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/works.tsx): `components/sections/works.tsx`
- [Case Study Details](https://github.com/itshashi7/hashi-portfolio/tree/main/components/works): `components/works`
- [About](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/about.tsx): `components/sections/about.tsx`
- [Experiments](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/experiments.tsx): `components/sections/experiments.tsx`
- [Skills and Stack](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/stack.tsx): `components/sections/stack.tsx`
- [Logo Marquee](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/marquee.tsx): `components/sections/marquee.tsx`
- [Footer and Agent View](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/footer.tsx): `components/sections/footer.tsx`

### Interactive Features

- [Ask Chat](https://github.com/itshashi7/hashi-portfolio/blob/main/components/sections/ask.tsx): `components/sections/ask.tsx`
- [Chat Matching](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/chat.ts): `lib/chat.ts`
- [Visual Effects](https://github.com/itshashi7/hashi-portfolio/tree/main/components/fx): `components/fx`
- [React Bits Widgets](https://github.com/itshashi7/hashi-portfolio/tree/main/components/reactbits): `components/reactbits`
- [UI Components](https://github.com/itshashi7/hashi-portfolio/tree/main/components/ui): `components/ui`

### Shared Runtime

- [Profile Data](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/profile.ts): `lib/profile.ts`
- [Site Copy](https://github.com/itshashi7/hashi-portfolio/blob/main/content/profile.json): `content/profile.json`
- [Motion Runtime](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/motion.ts): `lib/motion.ts`
- [Motion Tokens](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/tokens.ts): `lib/tokens.ts`
- [Idle Scheduling](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/idle.ts): `lib/idle.ts`
- [Icon Mapping](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/icons.ts): `lib/icons.ts`
- [Agent Markdown](https://github.com/itshashi7/hashi-portfolio/blob/main/lib/agent-markdown.ts): `lib/agent-markdown.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Page Shell: opens (evidence: `README.md`)
- Page Shell → Section Navigation: renders (evidence: `app/page.tsx`)
- Page Shell → Intro Loader: renders (evidence: `app/page.tsx`)
- Page Shell → Hero: renders (evidence: `app/page.tsx`)
- Page Shell → Logo Marquee: loads (evidence: `app/page.tsx`)
- Page Shell → Project Gallery: loads (evidence: `app/page.tsx`)
- Page Shell → Experiments: loads (evidence: `app/page.tsx`)
- Page Shell → Ask Chat: loads (evidence: `app/page.tsx`)
- Page Shell → About: loads (evidence: `app/page.tsx`)
- Page Shell → Skills and Stack: loads (evidence: `app/page.tsx`)
- Page Shell → Footer and Agent View: loads (evidence: `app/page.tsx`)
- Page Shell → Visual Effects: renders (evidence: `app/page.tsx`)
- Page Shell → Theme Providers: uses
- Project Gallery → Case Study Details: renders (evidence: `components/sections/works.tsx`)
- Hero → React Bits Widgets: uses (evidence: `components/sections/hero.tsx`)
- Logo Marquee → React Bits Widgets: uses (evidence: `components/sections/marquee.tsx`)
- Hero → Profile Data: reads (evidence: `components/sections/hero.tsx`)
- Project Gallery → Profile Data: reads (evidence: `components/sections/works.tsx`)
- About → Profile Data: reads (evidence: `components/sections/about.tsx`)
- Experiments → Profile Data: reads (evidence: `components/sections/experiments.tsx`)
- Skills and Stack → Profile Data: reads (evidence: `components/sections/stack.tsx`)
- Footer and Agent View → Profile Data: reads (evidence: `components/sections/footer.tsx`)
- Profile Data → Site Copy: imports (evidence: `lib/profile.ts`)
- Ask Chat → Chat Matching: queries (evidence: `components/sections/ask.tsx`)
- Chat Matching → Profile Data: uses (evidence: `lib/chat.ts`)
- Ask Chat → UI Components: uses (evidence: `components/sections/ask.tsx`)
- Section Navigation → UI Components: uses (evidence: `components/site/nav.tsx`)
- Hero → Visual Effects: renders (evidence: `components/sections/hero.tsx`)
- Visual Effects → Motion Runtime: uses (evidence: `components/fx/network-field.tsx`)
- Visual Effects → Idle Scheduling: schedules with (evidence: `components/fx/network-field.tsx`)
- Visual Effects → Motion Tokens: uses (evidence: `components/fx/use-split-reveal.ts`)
- Logo Marquee → Icon Mapping: uses (evidence: `components/sections/marquee.tsx`)
- Footer and Agent View → Agent Markdown: renders (evidence: `components/sections/footer.tsx`)
- Agent Markdown → Profile Data: reads (evidence: `lib/agent-markdown.ts`)
- Section Navigation → Profile Data: uses (evidence: `components/site/nav.tsx`)
