# ramdeniakki/ramdeniakki-portfolio architecture

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

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

## Overview

##### Main Components
- Frontend Application: At the heart is the React app. Represent the main entry points such as index.html, main.jsx, and App.jsx.
- UI Components: Break out key UI components found under “src/components” – for example:
– Navbar, MobileMenu, LoadingScreen, and RevealOnScroll (for smooth animations/interactions).
– Sections like Home, About, Projects, and Contact (found in “src/components/sections”) which are essentially the various pages or sections of the site.
- Public Assets: Include the “public” folder that hosts static resources (like the resume.pdf). This indicates that some common files and assets are served directly.
- Configuration & Build Tools: Note supporting configuration files such as:
– Vite configuration (vite.config.js)
– Tailwind configuration (tailwind.config.js)
– ESLint configuration (eslint.config.js)
– Package management lock files (package-lock.json, pnpm-lock.yaml) which indicate dependency management.
- CI/CD Pipeline: Represent that there is a GitHub Workflows directory (.github/workflows) which automates deployment steps (e.g., the jekyll-gh-pages.yml workflow).

##### Relationships and Interactions
- That index.html is the entry point which loads main.jsx (the React bootstrapper).
- main.jsx renders the top-level App.jsx component that orchestrates the layout.
- That certain components (such as the MobileMenu and Navbar) function together for site navigation.
- If applicable, show that the build and refresh processes involve Vite bundling and possibly Babel/SWC for Fast Refresh (as suggested in the README).

##### Architectural Patterns
- Although there isn’t an explicit backend or API layer, the project follows a component-driven, modular architecture. Emphasize the separation of concerns:
– UI/Presentation Components (Navbar, MobileMenu, etc.)
– Section-specific Components (Home, About, Projects, Contact)
- You could note that the project uses modern ES6 modules and dynamic imports if applicable.
- Notion of HMR (Hot Module Replacement) as an external service or feature provided by Vite.

##### Relevant Technologies
- React as the main UI library.
- Vite as the build tool and development server.
- Tailwind CSS for styling.
- ESLint for code linting.
- GitHub Actions for CI/CD (deployments using GitHub Pages via the Jekyll workflow).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend Application"
        idx("index.html"):::entry
        main("main.jsx"):::entry
        app("App.jsx"):::entry
    end

    subgraph "UI Components"
        navbar("Navbar"):::ui
        mobile("MobileMenu"):::ui
        loading("LoadingScreen"):::ui
        reveal("RevealOnScroll"):::ui
    end

    subgraph "Section Components"
        home("Home"):::section
        about("About"):::section
        projects("Projects"):::section
        contact("Contact"):::section
    end

    subgraph "Public Assets"
        resume("resume.pdf"):::asset
    end

    subgraph "Configurations & Build Tools"
        vite("Vite (HMR)"):::config
        viteConfig("vite.config.js"):::config
        tailwind("tailwind.config.js"):::config
        eslint("eslint.config.js"):::config
        pkgLock("package-lock.json"):::config
        pnpmLock("pnpm-lock.yaml"):::config
    end

    subgraph "CI/CD Pipeline"
        github("GitHub Actions Workflow"):::pipeline
    end

    %% Connections between Frontend Application components
    idx -->|"loads"| main
    main -->|"bootstraps"| app

    %% App.jsx renders the UI and Section Components
    app -->|"renders"| navbar
    app -->|"renders"| mobile
    app -->|"renders"| loading
    app -->|"renders"| reveal
    app -->|"renders"| home
    app -->|"renders"| about
    app -->|"renders"| projects
    app -->|"renders"| contact

    %% Interaction between UI Components
    navbar -->|"toggles"| mobile

    %% Vite Dev Server interactions with Frontend
    vite -->|"bundles"| idx
    vite -->|"hotReloads"| main
    vite -->|"hotReloads"| app

    %% Configuration linking to Vite
    viteConfig --> vite
    tailwind --> vite
    eslint --> vite
    pkgLock --> vite
    pnpmLock --> vite

    %% Deployment workflow triggers build and deploy processes
    github -->|"deploys"| vite

    %% Static Assets served by index.html
    idx ---|"serves"| resume

    %% Class definitions with colours
    classDef entry fill:#FFD700,stroke:#000,stroke-width:2px;
    classDef ui fill:#90EE90,stroke:#000,stroke-width:2px;
    classDef section fill:#ADD8E6,stroke:#000,stroke-width:2px;
    classDef asset fill:#FFB6C1,stroke:#000,stroke-width:2px;
    classDef config fill:#FFA07A,stroke:#000,stroke-width:2px;
    classDef pipeline fill:#DDA0DD,stroke:#000,stroke-width:2px;

    %% Click Events
    click idx "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/index.html"
    click main "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/main.jsx"
    click app "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/App.jsx"
    click navbar "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/Navbar.jsx"
    click mobile "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/MobileMenu.jsx"
    click loading "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/LoadingScreen.jsx"
    click reveal "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/RevealOnScroll.jsx"
    click home "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/sections/Home.jsx"
    click about "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/sections/About.jsx"
    click projects "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/sections/Projects.jsx"
    click contact "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/src/components/sections/Contact.jsx"
    click resume "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/public/File/resume.pdf"
    click viteConfig "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/vite.config.js"
    click tailwind "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/tailwind.config.js"
    click eslint "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/eslint.config.js"
    click pkgLock "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/package-lock.json"
    click pnpmLock "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/pnpm-lock.yaml"
    click github "https://github.com/ramdeniakki/ramdeniakki-portfolio/blob/master/.github/workflows/jekyll-gh-pages.yml"
```
