# rodak123/portfolio-web architecture

> Architecture diagram of the GitHub repository rodak123/portfolio-web, 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/rodak123/portfolio-web
- Repository: https://github.com/rodak123/portfolio-web

## Overview

This is a personal portfolio website: visitors move from the home page to portfolio details or a browsable project collection, with contact links and external project destinations. The router selects pages; shared layout and visual components render them. Project metadata is assembled into an ordered catalog used by the projects view. Theme and responsive behavior are supporting UI layers. The graph follows documented routes and imports visible in the supplied excerpts and SOURCE INDEX; unsampled project-page and theme-provider wiring is therefore limited.

Main entry points: [`src/ui/pages/MainPage.tsx`](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/MainPage.tsx) (Home page), [`src/router.tsx`](https://github.com/rodak123/portfolio-web/blob/main/src/router.tsx) (Route table), [`src/ui/pages/PortfolioPage.tsx`](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/PortfolioPage.tsx) (Portfolio page), [`src/ui/pages/ProjectsPage.tsx`](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/ProjectsPage.tsx) (Projects page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry and routes"]
  node_entry["App entry<br/>[main.tsx]"]
  node_router["Route table<br/>[router.tsx]"]
  node_config["Route paths<br/>[config.ts]"]
end

subgraph group_pages["Visitor pages"]
  node_home["Home page<br/>[MainPage.tsx]"]
  node_portfolio["Portfolio page<br/>[PortfolioPage.tsx]"]
  node_projects["Projects page<br/>[ProjectsPage.tsx]"]
  node_error["Error page<br/>[ErrorPage.tsx]"]
  node_projectdetail["Project detail page<br/>[ProjectPage.tsx]"]
end

subgraph group_content["Project content"]
  node_catalog[("Project catalog<br/>[projects.ts]")]
  node_projectmodel["Project model<br/>[project.ts]"]
  node_projectrecords["Project records"]
end

subgraph group_ui["Shared presentation"]
  node_layout["Default layout<br/>[DefaultLayout.tsx]"]
  node_hero["Hero composition<br/>[Hero.tsx]"]
  node_masonry["Project masonry<br/>[Masonry.tsx]"]
  node_contacts["Contact links<br/>[Contacts.tsx]"]
  node_typography["Typography<br/>[Typography.tsx]"]
  node_button["Buttons<br/>[Button.tsx]"]
  node_titlelink["Title and link<br/>[TitleAndLink.tsx]"]
  node_texttype["Typed text<br/>[TextType.tsx]"]
  node_shapegrid["Shape grid<br/>[ShapeGrid.tsx]"]
end

subgraph group_state["UI state"]
  node_themeprovider["Theme provider<br/>[ThemeProvider.tsx]"]
  node_themecontext["Theme context<br/>[ThemeContext.tsx]"]
  node_responsive["Responsive hook<br/>[useResponsive.tsx]"]
  node_mediaquery["Media query hook<br/>[useMediaQuery.tsx]"]
end

node_visitor(("Website visitor"))

node_visitor -->|"navigates"| node_router
node_entry -->|"mounts routes"| node_router
node_entry -->|"wraps app"| node_themeprovider
node_router -->|"uses paths"| node_config
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_portfolio
node_router -->|"routes to"| node_projects
node_router -->|"handles errors"| node_error
node_home -->|"renders within"| node_layout
node_portfolio -->|"renders within"| node_layout
node_projects -->|"renders within"| node_layout
node_error -->|"renders within"| node_layout
node_home -->|"renders"| node_hero
node_portfolio -->|"renders"| node_hero
node_projects -->|"renders"| node_masonry
node_projects -->|"reads catalog"| node_catalog
node_catalog -->|"assembles"| node_projectrecords
node_catalog -->|"types entries"| node_projectmodel
node_home -->|"renders"| node_contacts
node_home -->|"renders"| node_texttype
node_home -->|"renders"| node_button
node_home -->|"checks layout"| node_responsive
node_hero -->|"renders"| node_shapegrid
node_hero -->|"checks layout"| node_responsive
node_masonry -->|"renders"| node_typography
node_portfolio -->|"renders"| node_titlelink
node_themeprovider -->|"provides state"| node_themecontext
node_responsive -->|"calls"| node_mediaquery
node_projectdetail -.->|"looks up project"| node_catalog

click node_entry "https://github.com/rodak123/portfolio-web/blob/main/src/main.tsx"
click node_router "https://github.com/rodak123/portfolio-web/blob/main/src/router.tsx"
click node_config "https://github.com/rodak123/portfolio-web/blob/main/src/config.ts"
click node_home "https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/MainPage.tsx"
click node_portfolio "https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/PortfolioPage.tsx"
click node_projects "https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/ProjectsPage.tsx"
click node_error "https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/ErrorPage.tsx"
click node_projectdetail "https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/ProjectPage.tsx"
click node_catalog "https://github.com/rodak123/portfolio-web/blob/main/src/data/projects.ts"
click node_projectmodel "https://github.com/rodak123/portfolio-web/blob/main/src/data/utils/project.ts"
click node_projectrecords "https://github.com/rodak123/portfolio-web/tree/main/src/data/projects"
click node_layout "https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/layouts/DefaultLayout.tsx"
click node_hero "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Hero.tsx"
click node_masonry "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Masonry.tsx"
click node_contacts "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Contacts.tsx"
click node_typography "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Typography.tsx"
click node_button "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Button.tsx"
click node_titlelink "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/TitleAndLink.tsx"
click node_texttype "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/TextType.tsx"
click node_shapegrid "https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/ShapeGrid.tsx"
click node_themeprovider "https://github.com/rodak123/portfolio-web/blob/main/src/libs/providers/ThemeProvider.tsx"
click node_themecontext "https://github.com/rodak123/portfolio-web/blob/main/src/libs/context/ThemeContext.tsx"
click node_responsive "https://github.com/rodak123/portfolio-web/blob/main/src/libs/hooks/useResponsive.tsx"
click node_mediaquery "https://github.com/rodak123/portfolio-web/blob/main/src/libs/hooks/useMediaQuery.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_entry,node_router,node_config toneBlue
class node_home,node_portfolio,node_projects,node_error,node_projectdetail toneAmber
class node_catalog,node_projectmodel,node_projectrecords toneMint
class node_layout,node_hero,node_masonry,node_contacts,node_typography,node_button,node_titlelink,node_texttype,node_shapegrid toneRose
class node_themeprovider,node_themecontext,node_responsive,node_mediaquery,node_visitor toneIndigo
```

## Components

### App entry and routes

- [App entry](https://github.com/rodak123/portfolio-web/blob/main/src/main.tsx): `src/main.tsx`
- [Route table](https://github.com/rodak123/portfolio-web/blob/main/src/router.tsx): `src/router.tsx`
- [Route paths](https://github.com/rodak123/portfolio-web/blob/main/src/config.ts): `src/config.ts`

### Visitor pages

- [Home page](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/MainPage.tsx): `src/ui/pages/MainPage.tsx`
- [Portfolio page](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/PortfolioPage.tsx): `src/ui/pages/PortfolioPage.tsx`
- [Projects page](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/ProjectsPage.tsx): `src/ui/pages/ProjectsPage.tsx`
- [Error page](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/ErrorPage.tsx): `src/ui/pages/ErrorPage.tsx`
- [Project detail page](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/ProjectPage.tsx): `src/ui/pages/ProjectPage.tsx`

### Project content

- [Project catalog](https://github.com/rodak123/portfolio-web/blob/main/src/data/projects.ts): `src/data/projects.ts`
- [Project model](https://github.com/rodak123/portfolio-web/blob/main/src/data/utils/project.ts): `src/data/utils/project.ts`
- [Project records](https://github.com/rodak123/portfolio-web/tree/main/src/data/projects): `src/data/projects`

### Shared presentation

- [Default layout](https://github.com/rodak123/portfolio-web/blob/main/src/ui/pages/layouts/DefaultLayout.tsx): `src/ui/pages/layouts/DefaultLayout.tsx`
- [Hero composition](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Hero.tsx): `src/ui/components/Hero.tsx`
- [Project masonry](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Masonry.tsx): `src/ui/components/Masonry.tsx`
- [Contact links](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Contacts.tsx): `src/ui/components/Contacts.tsx`
- [Typography](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Typography.tsx): `src/ui/components/Typography.tsx`
- [Buttons](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/Button.tsx): `src/ui/components/Button.tsx`
- [Title and link](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/TitleAndLink.tsx): `src/ui/components/TitleAndLink.tsx`
- [Typed text](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/TextType.tsx): `src/ui/components/TextType.tsx`
- [Shape grid](https://github.com/rodak123/portfolio-web/blob/main/src/ui/components/ShapeGrid.tsx): `src/ui/components/ShapeGrid.tsx`

### UI state

- [Theme provider](https://github.com/rodak123/portfolio-web/blob/main/src/libs/providers/ThemeProvider.tsx): `src/libs/providers/ThemeProvider.tsx`
- [Theme context](https://github.com/rodak123/portfolio-web/blob/main/src/libs/context/ThemeContext.tsx): `src/libs/context/ThemeContext.tsx`
- [Responsive hook](https://github.com/rodak123/portfolio-web/blob/main/src/libs/hooks/useResponsive.tsx): `src/libs/hooks/useResponsive.tsx`
- [Media query hook](https://github.com/rodak123/portfolio-web/blob/main/src/libs/hooks/useMediaQuery.tsx): `src/libs/hooks/useMediaQuery.tsx`

### Other components

- **Website visitor**

## Connections

- Website visitor → Route table: navigates (evidence: `src/router.tsx`)
- App entry → Route table: mounts routes (evidence: `src/main.tsx`)
- App entry → Theme provider: wraps app (evidence: `src/main.tsx`)
- Route table → Route paths: uses paths (evidence: `src/router.tsx`)
- Route table → Home page: routes to (evidence: `src/router.tsx`)
- Route table → Portfolio page: routes to (evidence: `src/router.tsx`)
- Route table → Projects page: routes to (evidence: `src/router.tsx`)
- Route table → Error page: handles errors (evidence: `src/router.tsx`)
- Home page → Default layout: renders within (evidence: `src/ui/pages/MainPage.tsx`)
- Portfolio page → Default layout: renders within (evidence: `src/ui/pages/PortfolioPage.tsx`)
- Projects page → Default layout: renders within (evidence: `src/ui/pages/ProjectsPage.tsx`)
- Error page → Default layout: renders within (evidence: `src/ui/pages/ErrorPage.tsx`)
- Home page → Hero composition: renders (evidence: `src/ui/pages/MainPage.tsx`)
- Portfolio page → Hero composition: renders (evidence: `src/ui/pages/PortfolioPage.tsx`)
- Projects page → Project masonry: renders (evidence: `src/ui/pages/ProjectsPage.tsx`)
- Projects page → Project catalog: reads catalog (evidence: `src/ui/pages/ProjectsPage.tsx`)
- Project catalog → Project records: assembles (evidence: `src/data/projects.ts`)
- Project catalog → Project model: types entries (evidence: `src/data/projects.ts`)
- Home page → Contact links: renders (evidence: `src/ui/pages/MainPage.tsx`)
- Home page → Typed text: renders (evidence: `src/ui/pages/MainPage.tsx`)
- Home page → Buttons: renders (evidence: `src/ui/pages/MainPage.tsx`)
- Home page → Responsive hook: checks layout (evidence: `src/ui/pages/MainPage.tsx`)
- Hero composition → Shape grid: renders (evidence: `src/ui/components/Hero.tsx`)
- Hero composition → Responsive hook: checks layout (evidence: `src/ui/components/Hero.tsx`)
- Project masonry → Typography: renders (evidence: `src/ui/components/Masonry.tsx`)
- Portfolio page → Title and link: renders (evidence: `src/ui/pages/PortfolioPage.tsx`)
- Theme provider → Theme context: provides state (evidence: `src/libs/providers/ThemeProvider.tsx`)
- Responsive hook → Media query hook: calls (evidence: `src/libs/hooks/useResponsive.tsx`)
- Project detail page → Project catalog: looks up project
