# lavyatandel/-basic-portfolio-website architecture

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

- Interactive diagram: https://gitdiagram.com/lavyatandel/-basic-portfolio-website
- Repository: https://github.com/lavyatandel/-basic-portfolio-website

## Overview

##### Project type and purpose
- This is a front-end only, static “Basic Portfolio Website.”
- It’s designed as a single-page, responsive site showcasing: Hero, About, Skills, Projects, Experience, Contact form, Social links.

##### File structure
- Top level:
- index.html – the only HTML entry point
- README.md / LICENSE – documentation
- Implicit assets (from README):
- CSS (Flexbox/Grid, variables, media queries)
- JavaScript for smooth scrolling, responsive nav toggle

##### Key insights from README
- Mobile-first responsive design (media queries)
- Semantic HTML5
- CSS3 (Flexbox, Grid)
- Interactive JS (hamburger menu, scroll animations)
- External dependencies: Font Awesome CDN, possibly a third-party email/contact service

##### Main components
a. Client Browser (User’s device)
b. Static Asset Host (Web server or CDN)
- index.html
- styles.css (Flexbox/Grid, CSS variables)
- scripts.js (menu toggle, smooth scrolling)
- images/ (portfolio screenshots, hero image)
c. External Services
- Contact Form Service (e.g., Formspree, SendGrid API)
- (Optional) Analytics/Tracking (Google Analytics)

##### Component interactions and data flow
- On page load, Browser → HTTP GET → Asset Host → index.html, CSS, JS, images
- Browser loads CSS and JS from Host; JS may call external APIs for contact form submissions
- When user submits contact form: Browser → POST → Contact Form Service endpoint → sends email/notification

##### Architectural patterns and design principles
- Single-Page architecture (all content in index.html, dynamic sections revealed via JS)
- Responsive design (media queries alter layout at breakpoints)
- Progressive enhancement (basic HTML content, CSS and JS add layout & interactivity)
- CDN usage for third-party assets (Font Awesome)

## Diagram (Mermaid)

```mermaid
flowchart TD
    Browser["User Browser"]:::client
    subgraph "Static Asset Host (S3/GitHub Pages)"
        direction TB
        Index["index.html"]:::host
        Styles["styles.css"]:::host
        Scripts["scripts.js"]:::host
        Images["images/"]:::host
    end
    subgraph "Documentation"
        direction TB
        Readme["README.md"]:::docs
        License["LICENSE"]:::docs
    end
    FontAwesome["Font Awesome CDN"]:::external
    ContactService["Contact Form Service API"]:::external
    Analytics["Analytics/Tracking Service"]:::external

    Browser -->|"GET index.html, CSS, JS, images"| Index
    Browser -->|"GET CSS"| Styles
    Browser -->|"GET JS"| Scripts
    Browser -->|"GET images"| Images
    Browser -->|"GET icons"| FontAwesome
    Browser -->|"POST form data"| ContactService
    Browser -.->|"optional GET"| Analytics

    class Browser client
    class Index,Styles,Scripts,Images host
    class Readme,License docs
    class FontAwesome,ContactService,Analytics external

    click Index "https://github.com/lavyatandel/-basic-portfolio-website/blob/main/Basic Protfolio Website/index.html"
    click Readme "https://github.com/lavyatandel/-basic-portfolio-website/blob/main/Basic Protfolio Website/README.md"
    click License "https://github.com/lavyatandel/-basic-portfolio-website/tree/main/Basic Protfolio Website/LICENSE"

    classDef client fill:#ccffcc,stroke:#333,stroke-width:1px
    classDef host fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef external fill:#ffe5cc,stroke:#333,stroke-width:1px
    classDef docs fill:#e5e5e5,stroke:#333,stroke-width:1px
```
