# jorenverdad/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/jorenverdad/portfolio
- Repository: https://github.com/jorenverdad/portfolio

## Overview

This is a personal portfolio website: visitors browse an assembled home page presenting the owner’s profile, career journey, skills, projects, services, testimonials, and contact section. The home page fetches GitHub statistics server-side and passes them into the About section; a separate count API and database helper provide a visitor-count capability. The journey is split into experience, education, certifications, and activities views. Relationships reflect the page composition and imports documented in the supplied index; unsampled implementations are represented only where their paths and connections are supported.

Main entry points: [`src/app/page.tsx`](https://github.com/jorenverdad/portfolio/blob/main/src/app/page.tsx) (Home Page), [`src/components/sections/journey.tsx`](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey.tsx) (Journey Section), [`src/components/sections/about.tsx`](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/about.tsx) (About), [`src/components/sections/journey/telemetry.tsx`](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/telemetry.tsx) (Journey Telemetry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Page and Navigation"]
  node_home["Home Page<br/>[page.tsx]"]
  node_navigation["Navigation Bar<br/>[nav-bar.tsx]"]
  node_footer["Footer<br/>[footer.tsx]"]
  node_count_me_in["Count-me-in UI<br/>[count-me-in.tsx]"]
end

subgraph group_portfolio["Portfolio Sections"]
  node_hero["Hero<br/>[hero.tsx]"]
  node_about["About<br/>[about.tsx]"]
  node_github_stats_view["GitHub Stats Display<br/>[github-stats.tsx]"]
  node_skills_marquee["Skills Marquee<br/>[skills-marquee.tsx]"]
  node_tech_stack["Tech Stack<br/>[tech-stack.tsx]"]
  node_projects["Projects<br/>[projects.tsx]"]
  node_services["Services<br/>[services.tsx]"]
  node_testimonials["Testimonials<br/>[testimonials.tsx]"]
  node_contact["Contact<br/>[contact.tsx]"]
end

subgraph group_journey["Career Journey"]
  node_journey["Journey Section<br/>[journey.tsx]"]
  node_experience["Experience View"]
  node_education["Education View<br/>[education-view.tsx]"]
  node_certifications["Certifications View"]
  node_activities["Activities View"]
  node_telemetry["Journey Telemetry<br/>[telemetry.tsx]"]
end

subgraph group_integrations["External Data"]
  node_github_fetch["GitHub Stats Fetcher<br/>[github.ts]"]
  node_github_api["GitHub GraphQL API"]
  node_count_route["Count API Route<br/>[route.ts]"]
  node_count_store[("Count Store<br/>[db-count.ts]")]
end

subgraph group_runtime["Shared Runtime"]
  node_lazy_mount["Lazy Mount<br/>[lazy-mount.tsx]"]
  node_scroll_reveal["Scroll Reveal<br/>[scroll-reveal.tsx]"]
  node_work_progress["Work-in-Progress UI"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_home -->|"renders"| node_navigation
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_about
node_home -->|"renders"| node_journey
node_home -->|"renders"| node_tech_stack
node_home -->|"renders"| node_projects
node_home -->|"renders"| node_services
node_home -->|"renders"| node_testimonials
node_home -->|"renders"| node_contact
node_home -->|"renders"| node_footer
node_home -->|"wraps sections"| node_scroll_reveal
node_home -->|"mounts sections"| node_lazy_mount
node_home -->|"fetches stats"| node_github_fetch
node_home -->|"passes stats"| node_about
node_about -->|"uses"| node_github_stats_view
node_about -->|"uses"| node_skills_marquee
node_journey -->|"renders"| node_experience
node_journey -->|"renders"| node_education
node_journey -->|"renders"| node_certifications
node_journey -->|"renders"| node_activities
node_experience -->|"renders"| node_telemetry
node_activities -->|"renders"| node_telemetry
node_certifications -->|"uses"| node_telemetry
node_education -->|"uses"| node_telemetry
node_github_fetch -->|"queries"| node_github_api
node_count_route -->|"uses"| node_count_store
node_footer -->|"renders"| node_count_me_in
node_navigation -->|"wraps controls"| node_work_progress

click node_home "https://github.com/jorenverdad/portfolio/blob/main/src/app/page.tsx"
click node_navigation "https://github.com/jorenverdad/portfolio/blob/main/src/components/layout/nav-bar.tsx"
click node_footer "https://github.com/jorenverdad/portfolio/blob/main/src/components/layout/footer.tsx"
click node_hero "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/hero.tsx"
click node_about "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/about.tsx"
click node_github_stats_view "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/github-stats.tsx"
click node_skills_marquee "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/skills-marquee.tsx"
click node_tech_stack "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/tech-stack.tsx"
click node_projects "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/projects.tsx"
click node_services "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/services.tsx"
click node_testimonials "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/testimonials.tsx"
click node_contact "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/contact.tsx"
click node_journey "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey.tsx"
click node_experience "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/experience-view.tsx"
click node_education "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/education-view.tsx"
click node_certifications "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/certifications-view.tsx"
click node_activities "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/activities-view.tsx"
click node_telemetry "https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/telemetry.tsx"
click node_github_fetch "https://github.com/jorenverdad/portfolio/blob/main/src/lib/github.ts"
click node_count_route "https://github.com/jorenverdad/portfolio/blob/main/src/app/api/count/route.ts"
click node_count_store "https://github.com/jorenverdad/portfolio/blob/main/src/lib/db-count.ts"
click node_lazy_mount "https://github.com/jorenverdad/portfolio/blob/main/src/components/ui/lazy-mount.tsx"
click node_scroll_reveal "https://github.com/jorenverdad/portfolio/blob/main/src/components/ui/scroll-reveal.tsx"
click node_work_progress "https://github.com/jorenverdad/portfolio/blob/main/src/components/ui/work-in-progress.tsx"
click node_count_me_in "https://github.com/jorenverdad/portfolio/blob/main/src/components/layout/count-me-in.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_home,node_navigation,node_footer,node_count_me_in toneBlue
class node_hero,node_about,node_github_stats_view,node_skills_marquee,node_tech_stack,node_projects,node_services,node_testimonials,node_contact toneAmber
class node_journey,node_experience,node_education,node_certifications,node_activities,node_telemetry toneMint
class node_github_fetch,node_github_api,node_count_route,node_count_store toneRose
class node_lazy_mount,node_scroll_reveal,node_work_progress,node_visitor toneIndigo
```

## Components

### Page and Navigation

- [Home Page](https://github.com/jorenverdad/portfolio/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Navigation Bar](https://github.com/jorenverdad/portfolio/blob/main/src/components/layout/nav-bar.tsx): `src/components/layout/nav-bar.tsx`
- [Footer](https://github.com/jorenverdad/portfolio/blob/main/src/components/layout/footer.tsx): `src/components/layout/footer.tsx`
- [Count-me-in UI](https://github.com/jorenverdad/portfolio/blob/main/src/components/layout/count-me-in.tsx): `src/components/layout/count-me-in.tsx`

### Portfolio Sections

- [Hero](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/hero.tsx): `src/components/sections/hero.tsx`
- [About](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/about.tsx): `src/components/sections/about.tsx`
- [GitHub Stats Display](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/github-stats.tsx): `src/components/sections/github-stats.tsx`
- [Skills Marquee](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/skills-marquee.tsx): `src/components/sections/skills-marquee.tsx`
- [Tech Stack](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/tech-stack.tsx): `src/components/sections/tech-stack.tsx`
- [Projects](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/projects.tsx): `src/components/sections/projects.tsx`
- [Services](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/services.tsx): `src/components/sections/services.tsx`
- [Testimonials](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/testimonials.tsx): `src/components/sections/testimonials.tsx`
- [Contact](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/contact.tsx): `src/components/sections/contact.tsx`

### Career Journey

- [Journey Section](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey.tsx): `src/components/sections/journey.tsx`
- [Experience View](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/experience-view.tsx): `src/components/sections/journey/experience-view.tsx`
- [Education View](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/education-view.tsx): `src/components/sections/journey/education-view.tsx`
- [Certifications View](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/certifications-view.tsx): `src/components/sections/journey/certifications-view.tsx`
- [Activities View](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/activities-view.tsx): `src/components/sections/journey/activities-view.tsx`
- [Journey Telemetry](https://github.com/jorenverdad/portfolio/blob/main/src/components/sections/journey/telemetry.tsx): `src/components/sections/journey/telemetry.tsx`

### External Data

- [GitHub Stats Fetcher](https://github.com/jorenverdad/portfolio/blob/main/src/lib/github.ts): `src/lib/github.ts`
- **GitHub GraphQL API**
- [Count API Route](https://github.com/jorenverdad/portfolio/blob/main/src/app/api/count/route.ts): `src/app/api/count/route.ts`
- [Count Store](https://github.com/jorenverdad/portfolio/blob/main/src/lib/db-count.ts): `src/lib/db-count.ts`

### Shared Runtime

- [Lazy Mount](https://github.com/jorenverdad/portfolio/blob/main/src/components/ui/lazy-mount.tsx): `src/components/ui/lazy-mount.tsx`
- [Scroll Reveal](https://github.com/jorenverdad/portfolio/blob/main/src/components/ui/scroll-reveal.tsx): `src/components/ui/scroll-reveal.tsx`
- [Work-in-Progress UI](https://github.com/jorenverdad/portfolio/blob/main/src/components/ui/work-in-progress.tsx): `src/components/ui/work-in-progress.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → Home Page: opens
- Home Page → Navigation Bar: renders (evidence: `src/app/page.tsx`)
- Home Page → Hero: renders (evidence: `src/app/page.tsx`)
- Home Page → About: renders (evidence: `src/app/page.tsx`)
- Home Page → Journey Section: renders (evidence: `src/app/page.tsx`)
- Home Page → Tech Stack: renders (evidence: `src/app/page.tsx`)
- Home Page → Projects: renders (evidence: `src/app/page.tsx`)
- Home Page → Services: renders (evidence: `src/app/page.tsx`)
- Home Page → Testimonials: renders (evidence: `src/app/page.tsx`)
- Home Page → Contact: renders (evidence: `src/app/page.tsx`)
- Home Page → Footer: renders (evidence: `src/app/page.tsx`)
- Home Page → Scroll Reveal: wraps sections (evidence: `src/app/page.tsx`)
- Home Page → Lazy Mount: mounts sections (evidence: `src/app/page.tsx`)
- Home Page → GitHub Stats Fetcher: fetches stats (evidence: `src/app/page.tsx`)
- Home Page → About: passes stats (evidence: `src/app/page.tsx`)
- About → GitHub Stats Display: uses (evidence: `src/components/sections/about.tsx`)
- About → Skills Marquee: uses (evidence: `src/components/sections/about.tsx`)
- Journey Section → Experience View: renders (evidence: `src/components/sections/journey.tsx`)
- Journey Section → Education View: renders (evidence: `src/components/sections/journey.tsx`)
- Journey Section → Certifications View: renders (evidence: `src/components/sections/journey.tsx`)
- Journey Section → Activities View: renders (evidence: `src/components/sections/journey.tsx`)
- Experience View → Journey Telemetry: renders (evidence: `src/components/sections/journey/experience-view.tsx`)
- Activities View → Journey Telemetry: renders (evidence: `src/components/sections/journey/activities-view.tsx`)
- Certifications View → Journey Telemetry: uses (evidence: `src/components/sections/journey/certifications-view.tsx`)
- Education View → Journey Telemetry: uses (evidence: `src/components/sections/journey/education-view.tsx`)
- GitHub Stats Fetcher → GitHub GraphQL API: queries (evidence: `src/lib/github.ts`)
- Count API Route → Count Store: uses (evidence: `src/app/api/count/route.ts`)
- Footer → Count-me-in UI: renders (evidence: `src/components/layout/footer.tsx`)
- Navigation Bar → Work-in-Progress UI: wraps controls (evidence: `src/components/layout/nav-bar.tsx`)
