# ctd08/v2-portfolio-website architecture

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

## Overview

This is a personal portfolio website: visitors browse its home, about, career, project and contact pages, with a separate contact API that emails submissions. The frontend combines route-selected page views, shared navigation and ambient canvas visuals; career content includes a timeline. The backend validates and formats contact submissions before sending them through Resend. The README is minimal, so the graph reflects the capabilities visible in the route table and sampled source; the frontend-to-API submission link is not shown in the excerpts.

Main entry points: [`frontend/src/router/index.js`](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/router/index.js) (Page Router), [`frontend/src/App.vue`](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/App.vue) (Shared Shell), [`frontend/src/components/background/AmbientBackground.vue`](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/background/AmbientBackground.vue) (Ambient Background), [`frontend/src/main.js`](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/main.js) (Portfolio App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Site Shell"]
  node_frontend["Portfolio App<br/>[main.js]"]
  node_app_shell["Shared Shell<br/>[App.vue]"]
  node_router["Page Router<br/>[index.js]"]
  node_navigation["Navigation<br/>[AppNav.vue]"]
  node_footer["Footer<br/>[AppFooter.vue]"]
  node_scroll_ui["Scroll Controls<br/>[ScrollProgress.vue]"]
  node_scroll_top["Scroll To Top<br/>[ScrollToTop.vue]"]
end

subgraph group_pages["Portfolio Pages"]
  node_home["Home Page<br/>[HomeView.vue]"]
  node_about["About Page<br/>[AboutView.vue]"]
  node_career["Career Timeline<br/>[CareerView.vue]"]
  node_timeline_data["Timeline Data<br/>[timeline.js]"]
  node_contact_page["Contact Page<br/>[ContactView.vue]"]
  node_projects_section["Projects Section"]
  node_skills_section["Skills Section<br/>[SkillsSection.vue]"]
  node_companies_section["Companies Section"]
  node_currently_section["Currently Section"]
  node_hero_section["Hero Section<br/>[HeroSection.vue]"]
  node_construction["Placeholder Pages"]
end

subgraph group_visuals["Ambient Visuals"]
  node_ambient["Ambient Background"]
  node_circuit["Circuit Canvas"]
  node_starfield["Starfield Canvas"]
  node_canvas_loop["Canvas Loop<br/>[useCanvasLoop.js]"]
end

subgraph group_contact["Contact Delivery"]
  node_contact_api["Contact Endpoint<br/>[main.py]"]
  node_resend["Resend Email"]
end

node_visitor(("Visitor"))
node_sender(("Email Recipient"))

node_visitor -->|"opens"| node_frontend
node_frontend -->|"mounts"| node_app_shell
node_frontend -->|"registers"| node_router
node_app_shell -->|"renders routes"| node_router
node_app_shell -->|"renders"| node_navigation
node_app_shell -->|"renders"| node_footer
node_app_shell -->|"renders"| node_scroll_ui
node_app_shell -->|"renders"| node_scroll_top
node_app_shell -->|"renders"| node_ambient
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_about
node_router -->|"routes to"| node_career
node_router -->|"routes to"| node_contact_page
node_router -->|"routes to"| node_construction
node_career -->|"reads"| node_timeline_data
node_ambient -->|"reads route"| node_router
node_ambient -->|"renders"| node_circuit
node_ambient -->|"renders"| node_starfield
node_circuit -->|"uses"| node_canvas_loop
node_starfield -->|"uses"| node_canvas_loop
node_contact_api -->|"sends email"| node_resend
node_resend -->|"delivers to"| node_sender
node_visitor -.->|"submits form"| node_contact_api

click node_frontend "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/main.js"
click node_app_shell "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/App.vue"
click node_router "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/router/index.js"
click node_navigation "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/layout/AppNav.vue"
click node_footer "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/layout/AppFooter.vue"
click node_scroll_ui "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/ui/ScrollProgress.vue"
click node_scroll_top "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/ui/ScrollToTop.vue"
click node_home "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/HomeView.vue"
click node_about "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/AboutView.vue"
click node_career "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/CareerView.vue"
click node_timeline_data "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/data/timeline.js"
click node_contact_page "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/ContactView.vue"
click node_projects_section "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/ProjectsSection.vue"
click node_skills_section "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/SkillsSection.vue"
click node_companies_section "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/CompaniesSection.vue"
click node_currently_section "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/CurrentlySection.vue"
click node_hero_section "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/HeroSection.vue"
click node_construction "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/UnderConstructionView.vue"
click node_ambient "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/background/AmbientBackground.vue"
click node_circuit "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/background/CircuitBackground.vue"
click node_starfield "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/background/StarfieldBackground.vue"
click node_canvas_loop "https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/composables/useCanvasLoop.js"
click node_contact_api "https://github.com/ctd08/v2-portfolio-website/blob/main/backend/main.py"

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_frontend,node_app_shell,node_router,node_navigation,node_footer,node_scroll_ui,node_scroll_top toneBlue
class node_home,node_about,node_career,node_timeline_data,node_contact_page,node_projects_section,node_skills_section,node_companies_section,node_currently_section,node_hero_section,node_construction toneAmber
class node_ambient,node_circuit,node_starfield,node_canvas_loop toneMint
class node_contact_api,node_resend toneRose
class node_visitor,node_sender toneIndigo
```

## Components

### Site Shell

- [Portfolio App](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/main.js): `frontend/src/main.js`
- [Shared Shell](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Page Router](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/router/index.js): `frontend/src/router/index.js`
- [Navigation](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/layout/AppNav.vue): `frontend/src/components/layout/AppNav.vue`
- [Footer](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/layout/AppFooter.vue): `frontend/src/components/layout/AppFooter.vue`
- [Scroll Controls](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/ui/ScrollProgress.vue): `frontend/src/components/ui/ScrollProgress.vue`
- [Scroll To Top](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/ui/ScrollToTop.vue): `frontend/src/components/ui/ScrollToTop.vue`

### Portfolio Pages

- [Home Page](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/HomeView.vue): `frontend/src/views/HomeView.vue`
- [About Page](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/AboutView.vue): `frontend/src/views/AboutView.vue`
- [Career Timeline](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/CareerView.vue): `frontend/src/views/CareerView.vue`
- [Timeline Data](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/data/timeline.js): `frontend/src/data/timeline.js`
- [Contact Page](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/ContactView.vue): `frontend/src/views/ContactView.vue`
- [Projects Section](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/ProjectsSection.vue): `frontend/src/components/sections/ProjectsSection.vue`
- [Skills Section](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/SkillsSection.vue): `frontend/src/components/sections/SkillsSection.vue`
- [Companies Section](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/CompaniesSection.vue): `frontend/src/components/sections/CompaniesSection.vue`
- [Currently Section](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/CurrentlySection.vue): `frontend/src/components/sections/CurrentlySection.vue`
- [Hero Section](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/sections/HeroSection.vue): `frontend/src/components/sections/HeroSection.vue`
- [Placeholder Pages](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/views/UnderConstructionView.vue): `frontend/src/views/UnderConstructionView.vue`

### Ambient Visuals

- [Ambient Background](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/background/AmbientBackground.vue): `frontend/src/components/background/AmbientBackground.vue`
- [Circuit Canvas](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/background/CircuitBackground.vue): `frontend/src/components/background/CircuitBackground.vue`
- [Starfield Canvas](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/components/background/StarfieldBackground.vue): `frontend/src/components/background/StarfieldBackground.vue`
- [Canvas Loop](https://github.com/ctd08/v2-portfolio-website/blob/main/frontend/src/composables/useCanvasLoop.js): `frontend/src/composables/useCanvasLoop.js`

### Contact Delivery

- [Contact Endpoint](https://github.com/ctd08/v2-portfolio-website/blob/main/backend/main.py): `backend/main.py`
- **Resend Email**

### Other components

- **Visitor**
- **Email Recipient**

## Connections

- Visitor → Portfolio App: opens (evidence: `frontend/src/main.js`)
- Portfolio App → Shared Shell: mounts (evidence: `frontend/src/main.js`)
- Portfolio App → Page Router: registers (evidence: `frontend/src/main.js`)
- Shared Shell → Page Router: renders routes (evidence: `frontend/src/App.vue`)
- Shared Shell → Navigation: renders (evidence: `frontend/src/App.vue`)
- Shared Shell → Footer: renders (evidence: `frontend/src/App.vue`)
- Shared Shell → Scroll Controls: renders (evidence: `frontend/src/App.vue`)
- Shared Shell → Scroll To Top: renders (evidence: `frontend/src/App.vue`)
- Shared Shell → Ambient Background: renders (evidence: `frontend/src/App.vue`)
- Page Router → Home Page: routes to (evidence: `frontend/src/router/index.js`)
- Page Router → About Page: routes to (evidence: `frontend/src/router/index.js`)
- Page Router → Career Timeline: routes to (evidence: `frontend/src/router/index.js`)
- Page Router → Contact Page: routes to (evidence: `frontend/src/router/index.js`)
- Page Router → Placeholder Pages: routes to (evidence: `frontend/src/router/index.js`)
- Career Timeline → Timeline Data: reads (evidence: `frontend/src/views/CareerView.vue`)
- Ambient Background → Page Router: reads route (evidence: `frontend/src/components/background/AmbientBackground.vue`)
- Ambient Background → Circuit Canvas: renders (evidence: `frontend/src/components/background/AmbientBackground.vue`)
- Ambient Background → Starfield Canvas: renders (evidence: `frontend/src/components/background/AmbientBackground.vue`)
- Circuit Canvas → Canvas Loop: uses (evidence: `frontend/src/components/background/CircuitBackground.vue`)
- Starfield Canvas → Canvas Loop: uses (evidence: `frontend/src/components/background/StarfieldBackground.vue`)
- Contact Endpoint → Resend Email: sends email (evidence: `backend/main.py`)
- Resend Email → Email Recipient: delivers to
- Visitor → Contact Endpoint: submits form
