# hectorcolon/portfolio-design-journey architecture

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

- Interactive diagram: https://gitdiagram.com/hectorcolon/portfolio-design-journey
- Repository: https://github.com/hectorcolon/portfolio-design-journey

## Overview

This is a React portfolio site. A visitor opens a routed page; the home page presents biography, skills and certifications, work history, and contact, with shared navigation and footer. The contact form submits a subscription to a configured Google Sheets endpoint and attempts a Slack notification, showing feedback through the toast system. The graph focuses on these visitor-facing stages and the app’s routing/presentation layer. Relationships for sampled components are source-index-supported; unsampled page or section details are not expanded beyond documented imports.

Main entry points: [`src/App.tsx`](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/App.tsx) (Router and shell), [`src/components/ui/contact-form/ContactForm.tsx`](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/contact-form/ContactForm.tsx) (Subscription form), [`src/pages/Home.tsx`](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/pages/Home.tsx) (Home page), [`src/components/layout/Navbar.tsx`](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/layout/Navbar.tsx) (Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app["Router and shell<br/>[App.tsx]"]
  node_home["Home page<br/>[Home.tsx]"]
  node_blog["Blog page<br/>[Blog.tsx]"]
  node_notfound["Not found page<br/>[NotFound.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_about["About section<br/>[AboutMe.tsx]"]
  node_skills["Skills and certifications<br/>[Skills.tsx]"]
  node_skilldata["Skill catalog<br/>[skills.tsx]"]
  node_skillbar["Skill bars<br/>[SkillBar.tsx]"]
  node_experience["Work experience<br/>[Experience.tsx]"]
  node_workdata["Experience records"]
  node_timeline["Timeline item<br/>[TimelineItem.tsx]"]
  node_timelineicons["Timeline icons<br/>[Timelineicons.tsx]"]
end

subgraph group_contact["Contact flow"]
  node_contactsection["Contact section<br/>[ContactMe.tsx]"]
  node_contactmethods["Contact methods"]
  node_form["Subscription form<br/>[ContactForm.tsx]"]
  node_sheets[("Google Sheets endpoint")]
  node_slack["Slack webhook"]
end

subgraph group_shared["Shared UI"]
  node_toastapi["Toast API<br/>[use-toast.ts]"]
  node_toaststate["Toast state<br/>[use-toast.ts]"]
  node_toaster["Toast renderer<br/>[toaster.tsx]"]
  node_button["Button primitive<br/>[button.tsx]"]
  node_input["Input primitive<br/>[input.tsx]"]
  node_mobile["Mobile breakpoint hook<br/>[use-mobile.tsx]"]
  node_title["Name and title<br/>[title.tsx]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_blog
node_app -->|"routes to"| node_notfound
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_toaster
node_home -->|"renders"| node_about
node_home -->|"renders"| node_skills
node_home -->|"renders"| node_experience
node_home -->|"renders"| node_contactsection
node_skills -->|"reads"| node_skilldata
node_skills -->|"renders"| node_skillbar
node_experience -->|"reads"| node_workdata
node_experience -->|"renders"| node_timeline
node_timeline -->|"uses"| node_timelineicons
node_contactsection -->|"reads"| node_contactmethods
node_blog -->|"renders"| node_form
node_form -->|"renders"| node_button
node_form -->|"renders"| node_input
node_form -->|"submits"| node_sheets
node_form -->|"notifies"| node_slack
node_form -->|"reports status"| node_toastapi
node_toastapi -->|"delegates"| node_toaststate
node_toaster -->|"subscribes"| node_toaststate
node_navbar -->|"checks breakpoint"| node_mobile
node_navbar -->|"displays"| node_title
node_footer -->|"displays"| node_title

click node_app "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/App.tsx"
click node_home "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/pages/Home.tsx"
click node_blog "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/pages/Blog.tsx"
click node_notfound "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/pages/NotFound.tsx"
click node_navbar "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/layout/Navbar.tsx"
click node_footer "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/layout/Footer.tsx"
click node_about "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/AboutMe.tsx"
click node_skills "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/Skills.tsx"
click node_skilldata "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/skills.tsx"
click node_skillbar "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/skill-bar/SkillBar.tsx"
click node_experience "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/Experience.tsx"
click node_workdata "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/work_experience.tsx"
click node_timeline "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/experience-timeline/TimelineItem.tsx"
click node_timelineicons "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/experience-icons/Timelineicons.tsx"
click node_contactsection "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/ContactMe.tsx"
click node_contactmethods "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/contact_methods.tsx"
click node_form "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/contact-form/ContactForm.tsx"
click node_toastapi "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/use-toast.ts"
click node_toaststate "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/hooks/use-toast.ts"
click node_toaster "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/toaster.tsx"
click node_button "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/button.tsx"
click node_input "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/input.tsx"
click node_mobile "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/hooks/use-mobile.tsx"
click node_title "https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/title.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_app,node_home,node_blog,node_notfound,node_navbar,node_footer toneBlue
class node_about,node_skills,node_skilldata,node_skillbar,node_experience,node_workdata,node_timeline,node_timelineicons toneAmber
class node_contactsection,node_contactmethods,node_form,node_sheets,node_slack toneMint
class node_toastapi,node_toaststate,node_toaster,node_button,node_input,node_mobile,node_title toneRose
class node_visitor toneIndigo
```

## Components

### App shell

- [Router and shell](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/App.tsx): `src/App.tsx`
- [Home page](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Blog page](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/pages/Blog.tsx): `src/pages/Blog.tsx`
- [Not found page](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/pages/NotFound.tsx): `src/pages/NotFound.tsx`
- [Navigation](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/layout/Navbar.tsx): `src/components/layout/Navbar.tsx`
- [Footer](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/layout/Footer.tsx): `src/components/layout/Footer.tsx`

### Portfolio content

- [About section](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/AboutMe.tsx): `src/components/sections/AboutMe.tsx`
- [Skills and certifications](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/Skills.tsx): `src/components/sections/Skills.tsx`
- [Skill catalog](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/skills.tsx): `src/constants/skills.tsx`
- [Skill bars](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/skill-bar/SkillBar.tsx): `src/components/ui/skill-bar/SkillBar.tsx`
- [Work experience](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/Experience.tsx): `src/components/sections/Experience.tsx`
- [Experience records](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/work_experience.tsx): `src/constants/work_experience.tsx`
- [Timeline item](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/experience-timeline/TimelineItem.tsx): `src/components/ui/experience-timeline/TimelineItem.tsx`
- [Timeline icons](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/experience-icons/Timelineicons.tsx): `src/components/ui/experience-icons/Timelineicons.tsx`

### Contact flow

- [Contact section](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/sections/ContactMe.tsx): `src/components/sections/ContactMe.tsx`
- [Contact methods](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/contact_methods.tsx): `src/constants/contact_methods.tsx`
- [Subscription form](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/contact-form/ContactForm.tsx): `src/components/ui/contact-form/ContactForm.tsx`
- **Google Sheets endpoint**
- **Slack webhook**

### Shared UI

- [Toast API](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/use-toast.ts): `src/components/ui/use-toast.ts`
- [Toast state](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/hooks/use-toast.ts): `src/hooks/use-toast.ts`
- [Toast renderer](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/toaster.tsx): `src/components/ui/toaster.tsx`
- [Button primitive](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`
- [Input primitive](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/components/ui/input.tsx): `src/components/ui/input.tsx`
- [Mobile breakpoint hook](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/hooks/use-mobile.tsx): `src/hooks/use-mobile.tsx`
- [Name and title](https://github.com/hectorcolon/portfolio-design-journey/blob/main/src/constants/title.tsx): `src/constants/title.tsx`

### Other components

- **Visitor**

## Connections

- Visitor → Router and shell: opens
- Router and shell → Home page: routes to (evidence: `src/App.tsx`)
- Router and shell → Blog page: routes to (evidence: `src/App.tsx`)
- Router and shell → Not found page: routes to (evidence: `src/App.tsx`)
- Router and shell → Navigation: renders (evidence: `src/App.tsx`)
- Router and shell → Footer: renders (evidence: `src/App.tsx`)
- Router and shell → Toast renderer: renders (evidence: `src/App.tsx`)
- Home page → About section: renders (evidence: `src/pages/Home.tsx`)
- Home page → Skills and certifications: renders (evidence: `src/pages/Home.tsx`)
- Home page → Work experience: renders (evidence: `src/pages/Home.tsx`)
- Home page → Contact section: renders (evidence: `src/pages/Home.tsx`)
- Skills and certifications → Skill catalog: reads (evidence: `src/components/sections/Skills.tsx`)
- Skills and certifications → Skill bars: renders (evidence: `src/components/sections/Skills.tsx`)
- Work experience → Experience records: reads (evidence: `src/components/sections/Experience.tsx`)
- Work experience → Timeline item: renders (evidence: `src/components/sections/Experience.tsx`)
- Timeline item → Timeline icons: uses (evidence: `src/components/ui/experience-timeline/TimelineItem.tsx`)
- Contact section → Contact methods: reads (evidence: `src/components/sections/ContactMe.tsx`)
- Blog page → Subscription form: renders (evidence: `src/pages/Blog.tsx`)
- Subscription form → Button primitive: renders (evidence: `src/components/ui/contact-form/ContactForm.tsx`)
- Subscription form → Input primitive: renders (evidence: `src/components/ui/contact-form/ContactForm.tsx`)
- Subscription form → Google Sheets endpoint: submits (evidence: `src/components/ui/contact-form/ContactForm.tsx`)
- Subscription form → Slack webhook: notifies (evidence: `src/components/ui/contact-form/ContactForm.tsx`)
- Subscription form → Toast API: reports status (evidence: `src/components/ui/contact-form/ContactForm.tsx`)
- Toast API → Toast state: delegates (evidence: `src/components/ui/use-toast.ts`)
- Toast renderer → Toast state: subscribes (evidence: `src/components/ui/toaster.tsx`)
- Navigation → Mobile breakpoint hook: checks breakpoint (evidence: `src/components/layout/Navbar.tsx`)
- Navigation → Name and title: displays (evidence: `src/components/layout/Navbar.tsx`)
- Footer → Name and title: displays (evidence: `src/components/layout/Footer.tsx`)
