# hdennen/resume-react architecture

> Architecture diagram of the GitHub repository hdennen/resume-react, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hdennen/resume-react
- Repository: https://github.com/hdennen/resume-react

## Overview

##### Project Type and Purpose
- This project is a personal website built with React, Vite, TailwindCSS, and TypeScript. The README makes it clear that it is a single-page application (SPA) intended for a personal online presence and is deployed on Vercel.

##### File Structure
- The project’s top level includes general configuration and documentation files such as .gitignore, LICENSE, and README.md.
- The “frontend” directory is the main body of the project.
- Within “frontend”:
- There is a public folder (containing index.html and static assets) which serves as the entry point.
- The “src” folder is organized into:
- Pages: Files under src/pages (e.g., Home.tsx, About.tsx, Contact.tsx, Projects.tsx, Experience.tsx) represent the main views.
- Components: Divided into several subdirectories like “about”, “experience”, “layout”, “projects”, and an extensive “ui” directory providing reusable UI widgets such as buttons, alerts, dialogs, etc.
- Hooks, lib, and utils: These directories hold custom React hooks, helper libraries, shared types, and utility functions that support the overall app logic.
- Configuration files for Vite, TypeScript (tsconfig.*.json), Tailwind (tailwind.config.js), and deployment (vercel.json) indicate modern tooling and deployment workflows.
- The “frontend/.bolt” directory (and related files) indicate preconfigured tools for code prompts or project scaffolding.

##### Main Components
a. User Interface Layer:
- Pages: Represent each main page (Home, About, Projects, Experience, Contact) as separate visual components.
- Components:
- Layout components (e.g., Navigation and Layout) that define the scaffolding around each page.
- Content-specific components (e.g., ProjectCard, ExperienceCard, Profile, TechStack) that render section data.
- UI Library components organized under “ui” (e.g., Accordions, Buttons, Alerts, etc.).
b. Application Logic:
- Hooks: Custom React hooks (e.g., use-toast) for managing local state or side effects.
- Lib and Utils: Modules that provide constants, common data, type definitions, and utility functions.
- Routing: Components like AppRoutes.tsx which define navigation and component rendering logic.
c. Build & Deployment Layer:
- Vite: Acts as a build tool and bundler managing module resolution and fast refresh.
- TailwindCSS: The styling framework applied via the tailwind.config.js and PostCSS configurations.
- TypeScript: Ensuring type safety across the project (configured via tsconfig files).
- Vercel: Deployment platform as noted in vercel.json and in the README.

##### Establish Relationships and Interactions
- Component Hierarchy: Illustrate a layout where the App component embeds the Navigation and Layout components, which in turn wrap around the specific page components.
- Routing: Show the relationship between AppRoutes.tsx and the individual page components that are displayed based on the URL.
- UI Communication: Highlight how reusable UI components are leveraged across various pages, fostering consistency and maintainability.
- Configuration Dependencies: Include build/configuration components (Vite, Tailwind, TypeScript) to emphasize how these tools underpin the development, building, and styling of the application.

##### Architectural Patterns and Design Principles
- Component-Based Architecture: Emphasize the React-based modularity that separates UI elements, pages, hooks, and utilities.
- Separation of Concerns: Different directories (components, pages, hooks, lib) indicate a separation between user interface, application logic, and helper utilities.
- Responsive UI Design: Indicate that TailwindCSS is used to provide responsive and modern styling.
- Declarative Routing: The use of AppRoutes.tsx implies that client-side routing is declaratively defined.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global Flow
    A["Browser"]:::browser
    B["index.html (Public)"]:::public
    C["Application Bootstrap (main.tsx)"]:::bootstrap
    D["Routing (AppRoutes.tsx)"]:::routing

    A -->|"loads"| B
    B -->|"bootstraps"| C
    C -->|"defines routes"| D

    %% UI Layer Subgraph
    subgraph "UI Layer"
        direction TB
        E["Navigation Component"]:::ui
        F["Layout Component"]:::ui
        G["Home Page"]:::pages
        H["About Page"]:::pages
        I["Projects Page"]:::pages
        J["Experience Page"]:::pages
        K["Contact Page"]:::pages
    end

    %% Component Details Subgraph
    subgraph "Component Details"
        direction TB
        L["Profile Component"]:::comp
        M["TechStack Component"]:::comp
        N["ProjectCard Component"]:::comp
        O["ExperienceCard Component"]:::comp
        P["UI Library Components"]:::comp
    end

    %% Application Logic Subgraph
    subgraph "Application Logic"
        direction TB
        Q["Custom Hooks"]:::logic
        R["Shared Libraries & Utilities"]:::logic
    end

    %% Build & Deployment Subgraph
    subgraph "Build & Deployment"
        direction TB
        S["Build Tool (Vite)"]:::config
        T["Styling Framework (TailwindCSS)"]:::config
        U["TypeScript Configurations"]:::config
        V["Deployment Configuration (Vercel)"]:::config
    end

    %% Connections within UI Layer
    D --> E
    D --> F
    F -->|"renders"| G
    F -->|"renders"| H
    F -->|"renders"| I
    F -->|"renders"| J
    F -->|"renders"| K

    %% Page specific components
    H -->|"includes"| L
    H -->|"includes"| M
    I -->|"displays"| N
    J -->|"displays"| O

    %% Reusable UI components
    E ---|"uses"| P
    F ---|"uses"| P
    G ---|"uses"| P
    H ---|"uses"| P
    I ---|"uses"| P
    J ---|"uses"| P
    K ---|"uses"| P

    %% Application logic connections
    D ---|"utilizes"| Q
    D ---|"utilizes"| R

    %% Build & Deployment connections
    S -->|"builds"| C
    T -->|"styles"| C
    U -->|"types"| C
    S --- T
    T --- U
    U --- V

    %% Click Events
    click G "https://github.com/hdennen/resume-react/blob/main/frontend/src/pages/Home.tsx"
    click H "https://github.com/hdennen/resume-react/blob/main/frontend/src/pages/About.tsx"
    click I "https://github.com/hdennen/resume-react/blob/main/frontend/src/pages/Projects.tsx"
    click J "https://github.com/hdennen/resume-react/blob/main/frontend/src/pages/Experience.tsx"
    click K "https://github.com/hdennen/resume-react/blob/main/frontend/src/pages/Contact.tsx"
    click E "https://github.com/hdennen/resume-react/blob/main/frontend/src/components/layout/Navigation.tsx"
    click F "https://github.com/hdennen/resume-react/blob/main/frontend/src/components/layout/Layout.tsx"
    click L "https://github.com/hdennen/resume-react/blob/main/frontend/src/components/about/Profile.tsx"
    click M "https://github.com/hdennen/resume-react/blob/main/frontend/src/components/about/TechStack.tsx"
    click O "https://github.com/hdennen/resume-react/blob/main/frontend/src/components/experience/ExperienceCard.tsx"
    click N "https://github.com/hdennen/resume-react/blob/main/frontend/src/components/projects/ProjectCard.tsx"
    click P "https://github.com/hdennen/resume-react/tree/main/frontend/src/components/ui/"
    click Q "https://github.com/hdennen/resume-react/blob/main/frontend/src/hooks/use-toast.ts"
    click R "https://github.com/hdennen/resume-react/tree/main/frontend/src/lib/"
    click D "https://github.com/hdennen/resume-react/blob/main/frontend/src/AppRoutes.tsx"
    click C "https://github.com/hdennen/resume-react/blob/main/frontend/src/main.tsx"
    click S "https://github.com/hdennen/resume-react/blob/main/frontend/vite.config.ts"
    click T "https://github.com/hdennen/resume-react/blob/main/frontend/tailwind.config.js"
    click U "https://github.com/hdennen/resume-react/blob/main/frontend/tsconfig.json"
    click V "https://github.com/hdennen/resume-react/blob/main/frontend/vercel.json"

    %% Styles
    classDef browser fill:#F4D03F,stroke:#000,stroke-width:2px;
    classDef public fill:#AED6F1,stroke:#000,stroke-width:2px;
    classDef bootstrap fill:#A3E4D7,stroke:#000,stroke-width:2px;
    classDef routing fill:#F5B7B1,stroke:#000,stroke-width:2px;
    classDef ui fill:#D2B4DE,stroke:#000,stroke-width:2px;
    classDef pages fill:#AED6F1,stroke:#000,stroke-width:2px;
    classDef comp fill:#F9E79F,stroke:#000,stroke-width:2px;
    classDef logic fill:#FAD7A0,stroke:#000,stroke-width:2px;
    classDef config fill:#D5F5E3,stroke:#000,stroke-width:2px;
```
