# gowthamr56/portfolio-website architecture

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

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

## Overview

This repository is a Streamlit personal portfolio. Visitors browse a home introduction and separate projects, blog, resume, about, and contact pages; the contact page validates and stores submitted messages in Firestore. Shared helpers fetch page icons and Lottie JSON. The README also documents a GitHub Actions keep-awake workflow, but its implementation is not represented as a runtime feature here. Connections are limited to those visible in the sampled page/helper source; some page modules were not sampled.

Main entry points: [`generalize.py`](https://github.com/gowthamr56/portfolio-website/blob/master/generalize.py) (Page icon fetch), [`pages/05_📭_Contact.py`](https://github.com/gowthamr56/portfolio-website/blob/master/pages/05_%F0%9F%93%AD_Contact.py) (Contact form), [`00_🎈_Home.py`](https://github.com/gowthamr56/portfolio-website/blob/master/00_%F0%9F%8E%88_Home.py) (Home introduction), [`pages/03_📜_Resume.py`](https://github.com/gowthamr56/portfolio-website/blob/master/pages/03_%F0%9F%93%9C_Resume.py) (Resume download)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio pages"]
  node_home["Home introduction<br/>[00_🎈_Home.py]"]
  node_projects["Project showcase<br/>[01_📚_Projects.py]"]
  node_blogs["Blog listing<br/>[02_📰_Blogs.py]"]
  node_resume["Resume download<br/>[03_📜_Resume.py]"]
  node_about["About profile<br/>[04_💬_About.py]"]
  node_resume_file["PDF document<br/>[resume_pdf.pdf]"]
end

subgraph group_shared["Shared presentation"]
  node_icons["Page icon fetch<br/>[generalize.py]"]
  node_lottie["Lottie data fetch<br/>[generalize.py]"]
end

subgraph group_contact["Contact capture"]
  node_contact_page["Contact form<br/>[05_📭_Contact.py]"]
  node_firestore[("Message storage")]
end

node_visitor(("Visitor"))
node_lottie_service(("Lottie assets"))
node_icon_asset(("Remote page icon"))

node_visitor -->|"views"| node_home
node_visitor -->|"views"| node_projects
node_visitor -->|"views"| node_blogs
node_visitor -->|"downloads"| node_resume
node_visitor -->|"views"| node_about
node_visitor -->|"submits"| node_contact_page
node_home -->|"gets icon"| node_icons
node_projects -->|"gets icon"| node_icons
node_blogs -->|"gets icon"| node_icons
node_resume -->|"gets icon"| node_icons
node_about -->|"gets icon"| node_icons
node_contact_page -->|"gets icon"| node_icons
node_home -->|"loads animation"| node_lottie
node_about -->|"loads animation"| node_lottie
node_contact_page -->|"loads animation"| node_lottie
node_lottie -->|"requests JSON"| node_lottie_service
node_icons -->|"downloads image"| node_icon_asset
node_resume -->|"reads PDF"| node_resume_file
node_contact_page -->|"writes message"| node_firestore

click node_home "https://github.com/gowthamr56/portfolio-website/blob/master/00_%F0%9F%8E%88_Home.py"
click node_projects "https://github.com/gowthamr56/portfolio-website/blob/master/pages/01_%F0%9F%93%9A_Projects.py"
click node_blogs "https://github.com/gowthamr56/portfolio-website/blob/master/pages/02_%F0%9F%93%B0_Blogs.py"
click node_resume "https://github.com/gowthamr56/portfolio-website/blob/master/pages/03_%F0%9F%93%9C_Resume.py"
click node_about "https://github.com/gowthamr56/portfolio-website/blob/master/pages/04_%F0%9F%92%AC_About.py"
click node_contact_page "https://github.com/gowthamr56/portfolio-website/blob/master/pages/05_%F0%9F%93%AD_Contact.py"
click node_icons "https://github.com/gowthamr56/portfolio-website/blob/master/generalize.py"
click node_lottie "https://github.com/gowthamr56/portfolio-website/blob/master/generalize.py"
click node_resume_file "https://github.com/gowthamr56/portfolio-website/blob/master/resume_pdf.pdf"

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_projects,node_blogs,node_resume,node_about,node_resume_file toneBlue
class node_icons,node_lottie toneAmber
class node_contact_page,node_firestore toneMint
class node_visitor,node_lottie_service,node_icon_asset toneIndigo
```

## Components

### Portfolio pages

- [Home introduction](https://github.com/gowthamr56/portfolio-website/blob/master/00_%F0%9F%8E%88_Home.py): `00_🎈_Home.py`
- [Project showcase](https://github.com/gowthamr56/portfolio-website/blob/master/pages/01_%F0%9F%93%9A_Projects.py): `pages/01_📚_Projects.py`
- [Blog listing](https://github.com/gowthamr56/portfolio-website/blob/master/pages/02_%F0%9F%93%B0_Blogs.py): `pages/02_📰_Blogs.py`
- [Resume download](https://github.com/gowthamr56/portfolio-website/blob/master/pages/03_%F0%9F%93%9C_Resume.py): `pages/03_📜_Resume.py`
- [About profile](https://github.com/gowthamr56/portfolio-website/blob/master/pages/04_%F0%9F%92%AC_About.py): `pages/04_💬_About.py`
- [PDF document](https://github.com/gowthamr56/portfolio-website/blob/master/resume_pdf.pdf): `resume_pdf.pdf`

### Shared presentation

- [Page icon fetch](https://github.com/gowthamr56/portfolio-website/blob/master/generalize.py): `generalize.py`
- [Lottie data fetch](https://github.com/gowthamr56/portfolio-website/blob/master/generalize.py): `generalize.py`

### Contact capture

- [Contact form](https://github.com/gowthamr56/portfolio-website/blob/master/pages/05_%F0%9F%93%AD_Contact.py): `pages/05_📭_Contact.py`
- **Message storage**

### Other components

- **Visitor**
- **Lottie assets**
- **Remote page icon**

## Connections

- Visitor → Home introduction: views (evidence: `00_🎈_Home.py`)
- Visitor → Project showcase: views (evidence: `pages/01_📚_Projects.py`)
- Visitor → Blog listing: views (evidence: `pages/02_📰_Blogs.py`)
- Visitor → Resume download: downloads (evidence: `pages/03_📜_Resume.py`)
- Visitor → About profile: views (evidence: `pages/04_💬_About.py`)
- Visitor → Contact form: submits (evidence: `pages/05_📭_Contact.py`)
- Home introduction → Page icon fetch: gets icon (evidence: `00_🎈_Home.py`)
- Project showcase → Page icon fetch: gets icon (evidence: `pages/01_📚_Projects.py`)
- Blog listing → Page icon fetch: gets icon (evidence: `pages/02_📰_Blogs.py`)
- Resume download → Page icon fetch: gets icon (evidence: `pages/03_📜_Resume.py`)
- About profile → Page icon fetch: gets icon (evidence: `pages/04_💬_About.py`)
- Contact form → Page icon fetch: gets icon (evidence: `pages/05_📭_Contact.py`)
- Home introduction → Lottie data fetch: loads animation (evidence: `00_🎈_Home.py`)
- About profile → Lottie data fetch: loads animation (evidence: `pages/04_💬_About.py`)
- Contact form → Lottie data fetch: loads animation (evidence: `pages/05_📭_Contact.py`)
- Lottie data fetch → Lottie assets: requests JSON (evidence: `generalize.py`)
- Page icon fetch → Remote page icon: downloads image (evidence: `generalize.py`)
- Resume download → PDF document: reads PDF (evidence: `pages/03_📜_Resume.py`)
- Contact form → Message storage: writes message (evidence: `pages/05_📭_Contact.py`)
