# joekaltho/joekaltho-portfolio architecture

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

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

## Overview

This is a personal portfolio and founder-story site presenting an engineer’s work and a public $1B-in-three-years goal. A visitor enters through the landing door or a hash route; the app selects the Engineer, Founder, or CV experience. The Founder view combines a live deadline counter, day grid, scoreboard, roadmap, and progress story. Visitors can also contact the founder: the form saves to Supabase when configured, otherwise it opens the visitor’s mail app. Relationships below follow the sampled app wiring and README; unsampled contact and page details are limited to documented behavior.

Main entry points: [`src/components/Founder.tsx`](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Founder.tsx) (Founder page), [`src/App.tsx`](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/App.tsx) (App shell), [`src/components/Engineer.tsx`](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Engineer.tsx) (Engineer page), [`src/components/Contact.tsx`](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Contact.tsx) (Contact form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Entry and routing"]
  node_hash_route["Hash route<br/>[useRoute.ts]"]
  node_app["App shell<br/>[App.tsx]"]
  node_door["Landing door<br/>[Door.tsx]"]
end

subgraph group_portfolio["Engineer portfolio"]
  node_engineer["Engineer page<br/>[Engineer.tsx]"]
  node_cv["Printable CV<br/>[Cv.tsx]"]
end

subgraph group_founder["Founder story"]
  node_founder["Founder page<br/>[Founder.tsx]"]
  node_goal_clock["Goal clock<br/>[goal.ts]"]
  node_day_grid["Day grid<br/>[DayGrid.tsx]"]
  node_progress_content["Progress and roadmap<br/>[data.ts]"]
end

subgraph group_shared["Shared content and contact"]
  node_site_content["Portfolio content<br/>[data.ts]"]
  node_about["About sections<br/>[About.tsx]"]
  node_contact["Contact form<br/>[Contact.tsx]"]
  node_supabase_client["Supabase client<br/>[supabase.ts]"]
end

node_visitor(("Visitor"))
node_supabase[("Supabase")]
node_mail_app["Visitor mail app"]

node_visitor -->|"sets hash"| node_hash_route
node_hash_route -->|"selects route"| node_app
node_app -->|"renders default"| node_door
node_app -->|"renders engineer"| node_engineer
node_app -->|"renders founder"| node_founder
node_app -->|"renders CV"| node_cv
node_engineer -->|"renders about"| node_about
node_founder -->|"renders about"| node_about
node_engineer -->|"renders form"| node_contact
node_founder -->|"renders form"| node_contact
node_engineer -->|"reads content"| node_site_content
node_about -->|"reads content"| node_site_content
node_founder -->|"gets status"| node_goal_clock
node_founder -->|"renders grid"| node_day_grid
node_founder -->|"reads roadmap"| node_progress_content
node_contact -->|"saves submission"| node_supabase_client
node_supabase_client -->|"writes contact"| node_supabase
node_contact -->|"opens fallback"| node_mail_app

click node_hash_route "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/lib/useRoute.ts"
click node_app "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/App.tsx"
click node_door "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Door.tsx"
click node_engineer "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Engineer.tsx"
click node_cv "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Cv.tsx"
click node_founder "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Founder.tsx"
click node_goal_clock "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/lib/goal.ts"
click node_day_grid "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/DayGrid.tsx"
click node_progress_content "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/data.ts"
click node_site_content "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/data.ts"
click node_about "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/About.tsx"
click node_contact "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Contact.tsx"
click node_supabase_client "https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/lib/supabase.ts"

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_hash_route,node_app,node_door toneBlue
class node_engineer,node_cv,node_supabase toneAmber
class node_founder,node_goal_clock,node_day_grid,node_progress_content toneMint
class node_site_content,node_about,node_contact,node_supabase_client toneRose
class node_visitor,node_mail_app toneIndigo
```

## Components

### Entry and routing

- [Hash route](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/lib/useRoute.ts): `src/lib/useRoute.ts`
- [App shell](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [Landing door](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Door.tsx): `src/components/Door.tsx`

### Engineer portfolio

- [Engineer page](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Engineer.tsx): `src/components/Engineer.tsx`
- [Printable CV](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Cv.tsx): `src/components/Cv.tsx`

### Founder story

- [Founder page](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Founder.tsx): `src/components/Founder.tsx`
- [Goal clock](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/lib/goal.ts): `src/lib/goal.ts`
- [Day grid](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/DayGrid.tsx): `src/components/DayGrid.tsx`
- [Progress and roadmap](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/data.ts): `src/data.ts`

### Shared content and contact

- [Portfolio content](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/data.ts): `src/data.ts`
- [About sections](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/About.tsx): `src/components/About.tsx`
- [Contact form](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`
- [Supabase client](https://github.com/joekaltho/joekaltho-portfolio/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`

### Other components

- **Visitor**
- **Supabase**
- **Visitor mail app**

## Connections

- Visitor → Hash route: sets hash (evidence: `src/lib/useRoute.ts`)
- Hash route → App shell: selects route (evidence: `src/App.tsx`)
- App shell → Landing door: renders default (evidence: `src/App.tsx`)
- App shell → Engineer page: renders engineer (evidence: `src/App.tsx`)
- App shell → Founder page: renders founder (evidence: `src/App.tsx`)
- App shell → Printable CV: renders CV (evidence: `src/App.tsx`)
- Engineer page → About sections: renders about (evidence: `src/components/Engineer.tsx`)
- Founder page → About sections: renders about (evidence: `src/components/Founder.tsx`)
- Engineer page → Contact form: renders form (evidence: `src/components/Engineer.tsx`)
- Founder page → Contact form: renders form (evidence: `src/components/Founder.tsx`)
- Engineer page → Portfolio content: reads content (evidence: `src/components/Engineer.tsx`)
- About sections → Portfolio content: reads content (evidence: `src/components/About.tsx`)
- Founder page → Goal clock: gets status (evidence: `src/components/Founder.tsx`)
- Founder page → Day grid: renders grid (evidence: `src/components/Founder.tsx`)
- Founder page → Progress and roadmap: reads roadmap (evidence: `src/components/Founder.tsx`)
- Contact form → Supabase client: saves submission (evidence: `README.md`)
- Supabase client → Supabase: writes contact (evidence: `README.md`)
- Contact form → Visitor mail app: opens fallback (evidence: `README.md`)
