# twinemukama/twine architecture

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

- Interactive diagram: https://gitdiagram.com/twinemukama/twine
- Repository: https://github.com/twinemukama/twine

## Overview

Twine Portfolio is a React personal portfolio. A visitor enters through the browser app, views the portfolio’s introduction and work sections, and can navigate to a longer personal story. The source excerpts show the entry-point routing and the portfolio page’s section composition; the README adds no further product capabilities. The UI primitives are a supporting layer, not a separate product workflow. Some listed UI components were not sampled, so their internal usage is not mapped.

Main entry points: [`src/pages/Index.tsx`](https://github.com/twinemukama/twine/blob/main/src/pages/Index.tsx) (Portfolio page), [`src/components/SectionHeader.tsx`](https://github.com/twinemukama/twine/blob/main/src/components/SectionHeader.tsx) (Section heading), [`src/main.tsx`](https://github.com/twinemukama/twine/blob/main/src/main.tsx) (Browser entry), [`src/components/ui/toaster.tsx`](https://github.com/twinemukama/twine/blob/main/src/components/ui/toaster.tsx) (Toast renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_main["Browser entry<br/>[main.tsx]"]
  node_not_found["Not found page<br/>[NotFound.tsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_index["Portfolio page<br/>[Index.tsx]"]
  node_hero["Introduction<br/>[Hero.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_experience["Experience<br/>[Experience.tsx]"]
  node_projects["Projects<br/>[Projects.tsx]"]
  node_education["Education<br/>[Education.tsx]"]
  node_section_header["Section heading<br/>[SectionHeader.tsx]"]
  node_nav_link["Navigation link<br/>[NavLink.tsx]"]
end

subgraph group_story["Personal story"]
  node_story["Story page<br/>[Story.tsx]"]
end

subgraph group_ui["UI support"]
  node_ui_primitives["UI primitives"]
  node_toast_hook["Toast state<br/>[use-toast.ts]"]
  node_toaster["Toast renderer<br/>[toaster.tsx]"]
  node_toast["Toast components<br/>[toast.tsx]"]
  node_sonner["Sonner renderer<br/>[sonner.tsx]"]
  node_tooltip["Tooltip provider<br/>[tooltip.tsx]"]
end

node_visitor(("Portfolio visitor"))

node_visitor -->|"opens"| node_main
node_main -->|"routes to"| node_index
node_main -->|"routes to"| node_story
node_index -->|"renders"| node_hero
node_index -->|"renders"| node_skills
node_index -->|"renders"| node_experience
node_index -->|"renders"| node_projects
node_index -->|"renders"| node_education
node_experience -->|"renders"| node_section_header
node_projects -->|"renders"| node_section_header
node_education -->|"renders"| node_section_header
node_skills -->|"renders"| node_section_header
node_toast_hook -->|"uses types"| node_toast
node_toaster -->|"reads state"| node_toast_hook
node_toaster -->|"renders"| node_toast

click node_main "https://github.com/twinemukama/twine/blob/main/src/main.tsx"
click node_index "https://github.com/twinemukama/twine/blob/main/src/pages/Index.tsx"
click node_hero "https://github.com/twinemukama/twine/blob/main/src/components/Hero.tsx"
click node_skills "https://github.com/twinemukama/twine/blob/main/src/components/Skills.tsx"
click node_experience "https://github.com/twinemukama/twine/blob/main/src/components/Experience.tsx"
click node_projects "https://github.com/twinemukama/twine/blob/main/src/components/Projects.tsx"
click node_education "https://github.com/twinemukama/twine/blob/main/src/components/Education.tsx"
click node_section_header "https://github.com/twinemukama/twine/blob/main/src/components/SectionHeader.tsx"
click node_nav_link "https://github.com/twinemukama/twine/blob/main/src/components/NavLink.tsx"
click node_story "https://github.com/twinemukama/twine/blob/main/src/pages/Story.tsx"
click node_not_found "https://github.com/twinemukama/twine/blob/main/src/pages/NotFound.tsx"
click node_ui_primitives "https://github.com/twinemukama/twine/tree/main/src/components/ui"
click node_toast_hook "https://github.com/twinemukama/twine/blob/main/src/hooks/use-toast.ts"
click node_toaster "https://github.com/twinemukama/twine/blob/main/src/components/ui/toaster.tsx"
click node_toast "https://github.com/twinemukama/twine/blob/main/src/components/ui/toast.tsx"
click node_sonner "https://github.com/twinemukama/twine/blob/main/src/components/ui/sonner.tsx"
click node_tooltip "https://github.com/twinemukama/twine/blob/main/src/components/ui/tooltip.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_main,node_not_found toneBlue
class node_index,node_hero,node_skills,node_experience,node_projects,node_education,node_section_header,node_nav_link toneAmber
class node_story toneMint
class node_ui_primitives,node_toast_hook,node_toaster,node_toast,node_sonner,node_tooltip toneRose
class node_visitor toneIndigo
```

## Components

### App entry

- [Browser entry](https://github.com/twinemukama/twine/blob/main/src/main.tsx): `src/main.tsx`
- [Not found page](https://github.com/twinemukama/twine/blob/main/src/pages/NotFound.tsx): `src/pages/NotFound.tsx`

### Portfolio content

- [Portfolio page](https://github.com/twinemukama/twine/blob/main/src/pages/Index.tsx): `src/pages/Index.tsx`
- [Introduction](https://github.com/twinemukama/twine/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [Skills](https://github.com/twinemukama/twine/blob/main/src/components/Skills.tsx): `src/components/Skills.tsx`
- [Experience](https://github.com/twinemukama/twine/blob/main/src/components/Experience.tsx): `src/components/Experience.tsx`
- [Projects](https://github.com/twinemukama/twine/blob/main/src/components/Projects.tsx): `src/components/Projects.tsx`
- [Education](https://github.com/twinemukama/twine/blob/main/src/components/Education.tsx): `src/components/Education.tsx`
- [Section heading](https://github.com/twinemukama/twine/blob/main/src/components/SectionHeader.tsx): `src/components/SectionHeader.tsx`
- [Navigation link](https://github.com/twinemukama/twine/blob/main/src/components/NavLink.tsx): `src/components/NavLink.tsx`

### Personal story

- [Story page](https://github.com/twinemukama/twine/blob/main/src/pages/Story.tsx): `src/pages/Story.tsx`

### UI support

- [UI primitives](https://github.com/twinemukama/twine/tree/main/src/components/ui): `src/components/ui`
- [Toast state](https://github.com/twinemukama/twine/blob/main/src/hooks/use-toast.ts): `src/hooks/use-toast.ts`
- [Toast renderer](https://github.com/twinemukama/twine/blob/main/src/components/ui/toaster.tsx): `src/components/ui/toaster.tsx`
- [Toast components](https://github.com/twinemukama/twine/blob/main/src/components/ui/toast.tsx): `src/components/ui/toast.tsx`
- [Sonner renderer](https://github.com/twinemukama/twine/blob/main/src/components/ui/sonner.tsx): `src/components/ui/sonner.tsx`
- [Tooltip provider](https://github.com/twinemukama/twine/blob/main/src/components/ui/tooltip.tsx): `src/components/ui/tooltip.tsx`

### Other components

- **Portfolio visitor**

## Connections

- Portfolio visitor → Browser entry: opens (evidence: `src/main.tsx`)
- Browser entry → Portfolio page: routes to (evidence: `src/main.tsx`)
- Browser entry → Story page: routes to (evidence: `src/main.tsx`)
- Portfolio page → Introduction: renders (evidence: `src/pages/Index.tsx`)
- Portfolio page → Skills: renders (evidence: `src/pages/Index.tsx`)
- Portfolio page → Experience: renders (evidence: `src/pages/Index.tsx`)
- Portfolio page → Projects: renders (evidence: `src/pages/Index.tsx`)
- Portfolio page → Education: renders (evidence: `src/pages/Index.tsx`)
- Experience → Section heading: renders (evidence: `src/components/Experience.tsx`)
- Projects → Section heading: renders (evidence: `src/components/Projects.tsx`)
- Education → Section heading: renders (evidence: `src/components/Education.tsx`)
- Skills → Section heading: renders (evidence: `src/components/Skills.tsx`)
- Toast state → Toast components: uses types (evidence: `src/hooks/use-toast.ts`)
- Toast renderer → Toast state: reads state (evidence: `src/components/ui/toaster.tsx`)
- Toast renderer → Toast components: renders (evidence: `src/components/ui/toaster.tsx`)
