# akshaylavan/akshay_portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/akshaylavan/akshay_portfolio
- Repository: https://github.com/akshaylavan/akshay_portfolio

## Overview

##### Project type and purpose
- This is a single-page portfolio website built with React.js and GSAP for animations.
- It’s purely front-end: there is no backend service or database. The site is compiled into static assets and deployed (e.g., via Netlify).

##### File structure
- Top level:
- public/ – static HTML (index.html), manifest, redirects
- src/ – React source code
- package.json & lock – dependency and build scripts
- src/ contains:
- index.js – mounts the React App
- App.js & App.css – root component and styling
- components/ – modular React components (Navbar, Hero, About, Skills, Projects, Contact, etc.), each with its own CSS
- netlify.toml – configuration for Netlify deployment

##### README for additional insights
- Frameworks: React, GSAP, custom CSS
- Build & deployment steps: npm install, npm run build, deploy static build folder to Netlify (or similar)
- No external data sources—projects, skills, and content are defined in component arrays and JSX.

##### Main components
a. User Browser (Client)
b. Static Asset Hosting (Netlify or CDN)
c. React Application
– index.html → index.js → App.js
– Component tree: Navbar, Hero, About, Skills, Projects, Contact, Achievements, Experience
– GSAP animation layer interacting with DOM elements
d. Build Pipeline
– Node.js/npm install → Webpack (via Create React App) → Production bundle

##### Relationships and data flow
- User’s browser requests “/” → Hosting/CDN serves index.html and JS/CSS bundles
- index.js bootstraps React in the DOM
- App.js orchestrates child components, passing props or importing content arrays
- GSAP triggers animations on component mount or scroll events
- Build pipeline is triggered on code change or Git push (CI/CD) → automated deploy to Netlify

##### Architectural patterns and design principles
- Component-based architecture (React) for separation of concerns
- Static site generation/build → no runtime backend dependencies
- Modular CSS per component
- Responsive design principle baked into each component’s CSS

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Workflow
    GitRepo["Git Repository"]:::code
    CI["CI/CD Pipeline"]:::build
    Build["Build & Deploy"]:::build

    GitRepo -->|"push"| CI
    CI -->|"build triggered"| Build
    Build -->|"deploy"| NetlifyCDN

    %% Hosting/Infrastructure
    NetlifyCDN["Static Asset Hosting (Netlify/CDN)"]:::infra
    click NetlifyCDN "https://github.com/akshaylavan/akshay_portfolio/blob/main/netlify.toml"

    %% Client Runtime
    subgraph "Client Runtime"
        Browser["User Browser"]:::external
        Browser -->|"requests assets"| NetlifyCDN
        NetlifyCDN -->|"serves static files"| Browser

        %% Static Assets
        public["public/"]:::infra
        click public "https://github.com/akshaylavan/akshay_portfolio/tree/main/public/"
        Browser -->|"loads"| public

        %% External Services
        GoogleFonts["Google Fonts"]:::external
        click GoogleFonts "https://github.com/akshaylavan/akshay_portfolio/blob/main/public/index.html"
        Emojis["Emoji Icons"]:::external
        Browser --> GoogleFonts
        Browser --> Emojis

        %% React Application
        subgraph "React Application"
            indexJS["src/index.js"]:::code
            click indexJS "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/index.js"
            AppJS["src/App.js"]:::code
            click AppJS "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/App.js"
            AppCSS["src/App.css"]:::code
            click AppCSS "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/App.css"

            public -->|"bootstraps"| indexJS
            indexJS -->|"renders"| AppJS
            AppJS -->|"imports styles"| AppCSS

            %% Component Hierarchy
            subgraph "Components"
                Navbar["Navbar"]:::code
                click Navbar "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/Navbar.js"
                Hero["Hero"]:::code
                click Hero "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/Hero.js"
                About["About"]:::code
                click About "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/About.js"
                Skills["Skills"]:::code
                click Skills "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/Skills.js"
                Projects["Projects"]:::code
                click Projects "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/Projects.js"
                Contact["Contact"]:::code
                click Contact "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/Contact.js"
                Achievements["Achievements"]:::code
                click Achievements "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/Achievements.js"
                Experience["Experience"]:::code
                click Experience "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/components/Experience.js"
            end

            AppJS -->|"uses components"| Components
            GSAP["GSAP Animation Module"]:::external
            click GSAP "https://github.com/akshaylavan/akshay_portfolio/blob/main/src/index.js"
            Components -->|"animated by"| GSAP
        end
    end

    %% Build & Dependency Configuration
    package["package.json & package-lock.json"]:::build
    click package "https://github.com/akshaylavan/akshay_portfolio/blob/main/package.json"
    GitRepo --> package
    package --> CI

    classDef infra fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef code fill:#90EE90,stroke:#000,stroke-width:1px
    classDef build fill:#FFA500,stroke:#000,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
```
