# swarna7414/swarna-s-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/swarna7414/swarna-s-portfolio
- Repository: https://github.com/swarna7414/swarna-s-portfolio

## Overview

##### Project type and purpose
- This is a purely front-end, static portfolio website. It consists of a single HTML page (index.html), a stylesheet (style.css), a JavaScript file (script.js), and an image assets folder. There is no server-side logic, no database, and no microservices.

##### File structure
- Top-level files:
- index.html – the entry point and layout of the portfolio
- style.css – the global styles and layout rules
- script.js – any dynamic behaviors, event handlers, or animations
- README.md – a brief project description
- Directory:
- Images/ – contains all image assets that the portfolio references
- No build scripts, no configuration for back-end, no tests, no package.json (i.e., no Node.js toolchain).

##### Key components
a. Client (Web Browser)
b. Static File Server or CDN (hosting index.html, CSS, JS, images)
c. Asset Storage (the Images folder)

##### Relationships and interactions
- The user’s browser issues HTTP GET requests to the hosting/CDN for index.html.
- The browser parses index.html, then requests style.css and script.js.
- The browser requests image files from the Images folder as referenced in HTML or CSS.
- The browser’s rendering engine applies CSS and constructs the DOM; the JS engine executes script.js.
- (Optional) script.js or HTML may load external JS libraries or trigger calls to third-party services.

##### Architectural patterns and design principles
- Single Page Application (SPA) pattern (if script.js dynamically updates content) or simply a Multi-Page Static Site.
- Asset segregation: HTML, CSS, JS, and images are clearly separated.
- All content is served statically; no run-time back-end processes.

##### Relevant technologies and frameworks
- Web technologies: HTML5, CSS3, Vanilla JavaScript
- Hosting: GitHub Pages, Netlify, AWS S3 + CloudFront, or any static-site host
- (Optional) Third-party: Google Analytics, Formspree or email API for contact form

##### Detail without over-engineering
- Even in a static site, capture every asset as its own component or group of assets (HTML, CSS, JS, Images).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Tier 1: Client Layer
    subgraph "Tier 1: Client Browser"
        Browser["User Browser"]:::client
    end

    %% Tier 2: Content Delivery Layer
    subgraph "Tier 2: Hosting / CDN"
        CDN["Static File Server / CDN\n(Hosted on GitHub Pages / CloudFront)"]:::cdn
        HTML["index.html"]:::cdn
        CSS["style.css"]:::cdn
        JS["script.js"]:::cdn
        README["README.md"]:::cdn
    end

    %% Tier 3: Asset Storage
    subgraph "Tier 3: Asset Storage"
        Images["Images/"]:::storage
    end

    %% External Services
    External["External Services\n(Google Analytics, Contact Form)"]:::external

    %% Connections
    Browser -->|GET /index.html| HTML
    Browser -->|GET /style.css| CSS
    Browser -->|GET /script.js| JS
    Browser -->|GET /Images/*| Images
    Browser -.->|enables analytics| External

    %% Click Events
    click HTML "https://github.com/swarna7414/swarna-s-portfolio/blob/main/index.html"
    click CSS "https://github.com/swarna7414/swarna-s-portfolio/blob/main/style.css"
    click JS "https://github.com/swarna7414/swarna-s-portfolio/blob/main/script.js"
    click Images "https://github.com/swarna7414/swarna-s-portfolio/tree/main/Images/"
    click README "https://github.com/swarna7414/swarna-s-portfolio/blob/main/README.md"

    %% Styles
    classDef client fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef cdn fill:#90EE90,stroke:#000,stroke-width:1px
    classDef storage fill:#FFA500,stroke:#000,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
```
