# akash-kumar-dev/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/akash-kumar-dev/portfolio
- Repository: https://github.com/akash-kumar-dev/portfolio

## Overview

##### Main Components
- Vite & Build Configuration: Represented by files like vite.config.js, package.json, package-lock.json, and ESLint configuration (.eslintrc.cjs). This is the foundation for the development, bundling, and code quality checks.
- HTML Entry Point: The index.html file, which is the initial static HTML page that loads the React application.
- React Bootstrapping: The src/main.jsx file serves as the entry point for the React application.
- Core Application Component: src/App.jsx, which orchestrates the layout and includes various child components.
- React Components: The src/components directory which includes components such as Navbar, Landing, About, Skills, Projects, Experience, Contact, and Footer. Each of these components also has its own CSS files under src/components/styles.
- Assets: The src/assets directory (including images and company assets) used by the components.
- Configurations & Constants: The src/config directory with constants and placeholders which feed configuration data (e.g., experience constants, social links).

##### Relationships and Interactions
- The index.html loads the bundled application, which is initiated by src/main.jsx.
- The main.jsx renders the root React element, which is the App component.
- Each component may further import specific styling from the src/components/styles subfolder, and their functionality may be influenced by configuration data (from src/config).
- The Vite configuration and package scripts are used during development and build time, influencing how files are bundled and served.

##### Architectural Patterns and Design Principles
- Component-Based Architecture: Clearly separate each UI element into distinct components, as seen in the src/components directory.
- Separation of Concerns: Configuration (src/config) and styling (src/components/styles) are managed in separate folders supporting cleaner, more manageable code.
- Fast Refresh and Modular Build: The use of Vite (with official React plugins) and ESLint represents modern web development practices focused on rapid development and quality control.

##### Relevant Technologies and Frameworks
- React for building the UI.
- Vite as the build tool to support fast hot module replacement.
- Babel or SWC (as indicated in the README) for handling transformations in the development environment.
- ESLint for maintaining consistent code quality.
- CSS modules and possibly asset management strategies for images/logos.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Build & Dev Environment
    subgraph "Build & Dev Environment"
        ViteConfig["vite.config.js"]:::build
        PackageJson["package.json"]:::build
        PackageLock["package-lock.json"]:::build
        ESLint[".eslintrc.cjs"]:::build
    end

    %% Entry & Bootstrapping
    subgraph "Entry & Bootstrapping"
        HTML["index.html"]:::entry
        MainJSX["src/main.jsx"]:::entry
        AppJSX["src/App.jsx"]:::react
    end

    %% React Components
    subgraph "React Components"
        Navbar["Navbar Component"]:::react
        Landing["Landing Component"]:::react
        About["About Component"]:::react
        Skills["Skills Component"]:::react
        Projects["Projects Component"]:::react
        Experience["Experience Component"]:::react
        Contact["Contact Component"]:::react
        Footer["Footer Component"]:::react
    end

    %% Assets
    subgraph "Assets"
        AssetsNode["Assets"]:::assets
    end

    %% Configurations & Constants
    subgraph "Configurations"
        Config["Configurations & Constants"]:::config
    end

    %% Components Styling
    subgraph "Components Styling"
        CompStyles["Components Styles"]:::styles
    end

    %% Connections from Build & Dev Environment to Entry & Bootstrapping
    PackageJson -->|"builds"| HTML
    PackageJson -->|"builds"| MainJSX
    PackageJson -->|"builds"| AppJSX

    %% Bootstrapping Flow
    HTML -->|"loads"| MainJSX
    MainJSX -->|"renders"| AppJSX

    %% App Component composing React Components
    AppJSX -->|"composes"| Navbar
    AppJSX -->|"composes"| Landing
    AppJSX -->|"composes"| About
    AppJSX -->|"composes"| Skills
    AppJSX -->|"composes"| Projects
    AppJSX -->|"composes"| Experience
    AppJSX -->|"composes"| Contact
    AppJSX -->|"composes"| Footer

    %% Components dependencies on Assets, Config, and Styles
    Navbar -->|"uses"| AssetsNode
    Landing -->|"uses"| AssetsNode
    About -->|"uses"| AssetsNode
    Skills -->|"uses"| AssetsNode
    Projects -->|"uses"| AssetsNode
    Experience -->|"uses"| AssetsNode
    Contact -->|"uses"| AssetsNode
    Footer -->|"uses"| AssetsNode

    Navbar -->|"config"| Config
    Landing -->|"config"| Config
    About -->|"config"| Config
    Skills -->|"config"| Config
    Projects -->|"config"| Config
    Experience -->|"config"| Config
    Contact -->|"config"| Config
    Footer -->|"config"| Config

    Navbar -->|"styles"| CompStyles
    Landing -->|"styles"| CompStyles
    About -->|"styles"| CompStyles
    Skills -->|"styles"| CompStyles
    Projects -->|"styles"| CompStyles
    Experience -->|"styles"| CompStyles
    Contact -->|"styles"| CompStyles
    Footer -->|"styles"| CompStyles

    %% Styles for diagram nodes
    classDef build fill:#AED6F1,stroke:#1B4F72,stroke-width:2px;
    classDef entry fill:#A9DFBF,stroke:#196F3D,stroke-width:2px;
    classDef react fill:#F9E79F,stroke:#B7950B,stroke-width:2px;
    classDef assets fill:#D2B4DE,stroke:#6C3483,stroke-width:2px;
    classDef config fill:#FAD7A0,stroke:#D35400,stroke-width:2px;
    classDef styles fill:#F5B7B1,stroke:#922B21,stroke-width:2px;

    %% Click Events
    click ViteConfig "https://github.com/akash-kumar-dev/portfolio/blob/main/vite.config.js"
    click PackageJson "https://github.com/akash-kumar-dev/portfolio/blob/main/package.json"
    click PackageLock "https://github.com/akash-kumar-dev/portfolio/blob/main/package-lock.json"
    click ESLint "https://github.com/akash-kumar-dev/portfolio/blob/main/.eslintrc.cjs"
    click HTML "https://github.com/akash-kumar-dev/portfolio/blob/main/index.html"
    click MainJSX "https://github.com/akash-kumar-dev/portfolio/blob/main/src/main.jsx"
    click AppJSX "https://github.com/akash-kumar-dev/portfolio/blob/main/src/App.jsx"
    click Navbar "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/Navbar.jsx"
    click Landing "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/Landing.jsx"
    click About "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/About.jsx"
    click Skills "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/Skills.jsx"
    click Projects "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/Projects.jsx"
    click Experience "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/Experience.jsx"
    click Contact "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/Contact.jsx"
    click Footer "https://github.com/akash-kumar-dev/portfolio/blob/main/src/components/Footer.jsx"
    click CompStyles "https://github.com/akash-kumar-dev/portfolio/tree/main/src/components/styles"
    click AssetsNode "https://github.com/akash-kumar-dev/portfolio/tree/main/src/assets"
    click Config "https://github.com/akash-kumar-dev/portfolio/tree/main/src/config"
```
