# bkevangelista/personal-website architecture

> Architecture diagram of the GitHub repository bkevangelista/personal-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/bkevangelista/personal-website
- Repository: https://github.com/bkevangelista/personal-website

## Overview

This repository combines a personal portfolio website with a FastAPI service for listing and retrieving files from Google Cloud Storage. Visitors browse the home, about, and resume pages; the resume page presents a timeline, while a file-preview component can request files through the API. The backend routes requests to its storage client, which uses configured credentials to contact GCS. Relationships for unsampled page details and the frontend-to-backend URL mapping are omitted where the excerpts do not establish them.

Main entry points: [`bevangelista-website/src/app/page.js`](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/page.js) (Home page), [`bevangelista-website/src/app/resume/page.js`](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/resume/page.js) (Resume page), [`backend/app/utils/gcs_client.py`](https://github.com/bkevangelista/personal-website/blob/main/backend/app/utils/gcs_client.py) (Storage client), [`bevangelista-website/src/app/components/NavBar.jsx`](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/NavBar.jsx) (Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Portfolio website"]
  node_home["Home page<br/>[page.js]"]
  node_header["Profile header<br/>[Header.jsx]"]
  node_navbar["Navigation<br/>[NavBar.jsx]"]
  node_about["About page<br/>[page.js]"]
  node_resume["Resume page<br/>[page.js]"]
  node_timeline["Experience timeline<br/>[Timeline.jsx]"]
  node_filehandler["File preview<br/>[FileHandler.js]"]
  node_darkmode["Theme state<br/>[DarkModeContext.js]"]
  node_constants["Site constants<br/>[constants.js]"]
end

subgraph group_backend["API service"]
  node_api["API application<br/>[main.py]"]
  node_routes["API routes<br/>[routes.py]"]
  node_config["GCP configuration<br/>[config.py]"]
end

subgraph group_storage["Cloud storage"]
  node_gcsclient["Storage client<br/>[gcs_client.py]"]
end

node_visitor(("Visitor"))
node_gcs[("Google Cloud Storage")]

node_visitor -->|"visits"| node_home
node_home -->|"renders"| node_navbar
node_home -->|"renders"| node_header
node_visitor -->|"visits"| node_about
node_visitor -->|"visits"| node_resume
node_resume -->|"renders"| node_navbar
node_resume -->|"renders"| node_timeline
node_navbar -->|"reads and updates"| node_darkmode
node_home -.->|"uses"| node_constants
node_header -->|"uses"| node_constants
node_api -->|"registers"| node_routes
node_routes -->|"calls"| node_gcsclient
node_gcsclient -->|"reads settings"| node_config
node_gcsclient -->|"requests files"| node_gcs
node_filehandler -.->|"requests files"| node_routes

click node_home "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/page.js"
click node_header "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/Header.jsx"
click node_navbar "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/NavBar.jsx"
click node_about "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/about/page.js"
click node_resume "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/resume/page.js"
click node_timeline "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/Timeline.jsx"
click node_filehandler "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/FileHandler.js"
click node_darkmode "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/context/DarkModeContext.js"
click node_constants "https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/utils/constants/constants.js"
click node_api "https://github.com/bkevangelista/personal-website/blob/main/backend/app/main.py"
click node_routes "https://github.com/bkevangelista/personal-website/blob/main/backend/app/api/routes/routes.py"
click node_config "https://github.com/bkevangelista/personal-website/blob/main/backend/app/core/config.py"
click node_gcsclient "https://github.com/bkevangelista/personal-website/blob/main/backend/app/utils/gcs_client.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_home,node_header,node_navbar,node_about,node_resume,node_timeline,node_filehandler,node_darkmode,node_constants toneBlue
class node_api,node_routes,node_config,node_gcs toneAmber
class node_gcsclient toneMint
class node_visitor toneIndigo
```

## Components

### Portfolio website

- [Home page](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/page.js): `bevangelista-website/src/app/page.js`
- [Profile header](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/Header.jsx): `bevangelista-website/src/app/components/Header.jsx`
- [Navigation](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/NavBar.jsx): `bevangelista-website/src/app/components/NavBar.jsx`
- [About page](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/about/page.js): `bevangelista-website/src/app/about/page.js`
- [Resume page](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/resume/page.js): `bevangelista-website/src/app/resume/page.js`
- [Experience timeline](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/Timeline.jsx): `bevangelista-website/src/app/components/Timeline.jsx`
- [File preview](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/app/components/FileHandler.js): `bevangelista-website/src/app/components/FileHandler.js`
- [Theme state](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/context/DarkModeContext.js): `bevangelista-website/src/context/DarkModeContext.js`
- [Site constants](https://github.com/bkevangelista/personal-website/blob/main/bevangelista-website/src/utils/constants/constants.js): `bevangelista-website/src/utils/constants/constants.js`

### API service

- [API application](https://github.com/bkevangelista/personal-website/blob/main/backend/app/main.py): `backend/app/main.py`
- [API routes](https://github.com/bkevangelista/personal-website/blob/main/backend/app/api/routes/routes.py): `backend/app/api/routes/routes.py`
- [GCP configuration](https://github.com/bkevangelista/personal-website/blob/main/backend/app/core/config.py): `backend/app/core/config.py`

### Cloud storage

- [Storage client](https://github.com/bkevangelista/personal-website/blob/main/backend/app/utils/gcs_client.py): `backend/app/utils/gcs_client.py`

### Other components

- **Visitor**
- **Google Cloud Storage**

## Connections

- Visitor → Home page: visits
- Home page → Navigation: renders (evidence: `bevangelista-website/src/app/page.js`)
- Home page → Profile header: renders (evidence: `bevangelista-website/src/app/page.js`)
- Visitor → About page: visits
- Visitor → Resume page: visits
- Resume page → Navigation: renders (evidence: `bevangelista-website/src/app/resume/page.js`)
- Resume page → Experience timeline: renders (evidence: `bevangelista-website/src/app/resume/page.js`)
- Navigation → Theme state: reads and updates (evidence: `bevangelista-website/src/app/components/NavBar.jsx`)
- Home page → Site constants: uses
- Profile header → Site constants: uses (evidence: `bevangelista-website/src/app/components/Header.jsx`)
- API application → API routes: registers (evidence: `backend/app/main.py`)
- API routes → Storage client: calls (evidence: `backend/app/api/routes/routes.py`)
- Storage client → GCP configuration: reads settings (evidence: `backend/app/utils/gcs_client.py`)
- Storage client → Google Cloud Storage: requests files (evidence: `backend/app/utils/gcs_client.py`)
- File preview → API routes: requests files
