# cgs26/cgs_portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/cgs26/cgs_portfolio
- Repository: https://github.com/cgs26/cgs_portfolio

## Overview

##### Main Components
- Entry Point: Start with index.html as the web page template and the associated index.css file.
- Application Bootstrap: Highlight src/main.jsx where the React application gets rendered.
- Application Container: Include src/App.jsx that forms the central component assembling the app.
- UI Components: List the individual components from src/components such as Navbar, Hero, About, Awards, Projects, Skills, Experience, Contact, Footer, PageLoader, ParticleBackground, and any additional shared/common components (Cursor, ExperienceCard, ProjectCard, ScrollProgress, SectionHeader, and SkillCategory).

##### Toolchain and Technologies
- Vite Bundler: Place a block showing Vite as the development bundler and server, responsible for compiling the code, managing HMR, and serving the final bundle.
- React: Emphasize that React is in charge of rendering the UI components, with src/App.jsx acting as the entry point for component composition.
- Fast Refresh Plugins: Indicate two possible plugins for fast-refresh – one using Babel (@vitejs/plugin-react) and the other using SWC (@vitejs/plugin-react-swc). You might show them connected to both Vite and React since they enhance the development experience.
- ESLint: Show ESLint’s role in maintaining code quality during development, and consider indicating its expandable configuration.
- CSS Framework: Include Tailwind CSS (with its configuration file and integration via postcss.config.cjs) as the styling framework.

##### Relationships and Interactions
- Configuration Influence: Represent a set of configuration files affecting the build, linting, and styling pipelines—link them to their relevant parts (e.g., Tailwind connects to CSS styling, ESLint connects to the source code under src, Vite connects to the build process).

##### Architectural Patterns
- Component-Based Architecture: Note that the system heavily relies on the component-based approach of React, where individual UI sections are modular and reusable.
- Plugin Pipeline: Highlight the use of modern plugins (Babel or SWC) that reflect a modular build toolchain.

b. Inside, position the “Entry and Bootstrap” section (index.html, main.jsx) at the top.
c. Under that, create a “Core App” block representing App.jsx which aggregates multiple “UI Components” blocks (group together components such as Navbar, Hero, About, etc.).
e. Use a connecting line from package.json to all these tools to indicate dependency management through npm.
f. Finally, denote the “Assets” block with a clear association to the UI components that import resources from src/assets.

## Diagram (Mermaid)

```mermaid
graph TD
    subgraph "Client Side Application"
        %% Entry and Bootstrap Section
        subgraph "Entry and Bootstrap"
            indexHtml("Entry Point (index.html)"):::entry
            indexCSS("Entry CSS (index.css)"):::entry
            mainJS("Application Bootstrap (main.jsx)"):::react
            indexHtml -->|"loads"| mainJS
            indexCSS -->|"loads"| mainJS
        end

        %% Core App Section
        subgraph "Core App"
            appJS("Application Container (App.jsx)"):::react
            %% UI Components
            subgraph "UI Components"
                navbar("Navbar"):::ui
                hero("Hero"):::ui
                about("About"):::ui
                awards("Awards"):::ui
                projects("Projects"):::ui
                skills("Skills"):::ui
                experience("Experience"):::ui
                contact("Contact"):::ui
                footer("Footer"):::ui
                pageLoader("PageLoader"):::ui
                particleBg("ParticleBackground"):::ui
            end
            %% Shared/Common Components
            subgraph "Shared Components"
                cursor("Cursor"):::ui
                expCard("ExperienceCard"):::ui
                projCard("ProjectCard"):::ui
                scrollProgress("ScrollProgress"):::ui
                sectionHeader("SectionHeader"):::ui
                skillCategory("SkillCategory"):::ui
            end
            mainJS -->|"initializes"| appJS
            appJS -->|"renders"| navbar
            appJS -->|"renders"| hero
            appJS -->|"renders"| about
            appJS -->|"renders"| awards
            appJS -->|"renders"| projects
            appJS -->|"renders"| skills
            appJS -->|"renders"| experience
            appJS -->|"renders"| contact
            appJS -->|"renders"| footer
            appJS -->|"renders"| pageLoader
            appJS -->|"renders"| particleBg
            appJS -->|"composes"| cursor
            appJS -->|"composes"| expCard
            appJS -->|"composes"| projCard
            appJS -->|"composes"| scrollProgress
            appJS -->|"composes"| sectionHeader
            appJS -->|"composes"| skillCategory
        end

        %% Assets Section
        subgraph "Assets"
            assets("Assets"):::assets
        end

        %% Configuration & Tooling Section
        subgraph "Configuration & Tooling"
            vite("Bundler & Dev Server (Vite)"):::config
            babel("Fast-Refresh Plugin (Babel)"):::config
            swc("Fast-Refresh Plugin (SWC)"):::config
            eslint("ESLint Configuration"):::config
            tailwind("Tailwind CSS Configuration"):::config
            postcss("PostCSS Configuration"):::config
            package("NPM Dependency Management (package.json)"):::config
        end
    end

    %% Relationships
    appJS -->|"imports"| assets
    package -->|"manages"| vite
    package -->|"manages"| babel
    package -->|"manages"| swc
    package -->|"manages"| eslint
    package -->|"manages"| tailwind
    package -->|"manages"| postcss
    vite -->|"integrates"| babel
    vite -->|"integrates"| swc
    vite -->|"serves"| mainJS
    eslint -->|"analyzes"| appJS

    %% Styles
    classDef entry fill:#f9e79f,stroke:#b7950b,stroke-width:2px;
    classDef react fill:#aed6f1,stroke:#1f618d,stroke-width:2px;
    classDef ui fill:#d5f5e3,stroke:#27ae60,stroke-width:2px;
    classDef config fill:#fadbd8,stroke:#cb4335,stroke-width:2px;
    classDef assets fill:#e8daef,stroke:#8e44ad,stroke-width:2px;

    %% Click Events
    click indexHtml "https://github.com/cgs26/cgs_portfolio/blob/main/index.html"
    click indexCSS "https://github.com/cgs26/cgs_portfolio/blob/main/src/index.css"
    click mainJS "https://github.com/cgs26/cgs_portfolio/blob/main/src/main.jsx"
    click appJS "https://github.com/cgs26/cgs_portfolio/blob/main/src/App.jsx"
    click navbar "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Navbar.jsx"
    click hero "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Hero.jsx"
    click about "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/About.jsx"
    click awards "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Awards.jsx"
    click projects "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Projects.jsx"
    click skills "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Skills.jsx"
    click experience "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Experience.jsx"
    click contact "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Contact.jsx"
    click footer "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/Footer.jsx"
    click pageLoader "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/PageLoader.jsx"
    click particleBg "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/ParticleBackground.jsx"
    click cursor "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/common/Cursor.jsx"
    click expCard "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/common/ExperienceCard.jsx"
    click projCard "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/common/ProjectCard.jsx"
    click scrollProgress "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/common/ScrollProgress.jsx"
    click sectionHeader "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/common/SectionHeader.jsx"
    click skillCategory "https://github.com/cgs26/cgs_portfolio/blob/main/src/components/common/SkillCategory.jsx"
    click assets "https://github.com/cgs26/cgs_portfolio/tree/main/src/assets"
    click babel "https://github.com/cgs26/cgs_portfolio/blob/main/babel.config.js"
    click eslint "https://github.com/cgs26/cgs_portfolio/blob/main/eslint.config.js"
    click postcss "https://github.com/cgs26/cgs_portfolio/blob/main/postcss.config.cjs"
    click tailwind "https://github.com/cgs26/cgs_portfolio/blob/main/tailwind.config.cjs"
    click vite "https://github.com/cgs26/cgs_portfolio/blob/main/vite.config.js"
    click package "https://github.com/cgs26/cgs_portfolio/blob/main/package.json"
```
