# vernalan/websites architecture

> Architecture diagram of the GitHub repository vernalan/websites, 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/vernalan/websites
- Repository: https://github.com/vernalan/websites

## Overview

##### Project Type & Purpose
- This project is a collection of “little” static websites – each file (or group of files) represents a standalone web page or small web application.
- The project is simple and entirely client-side, built with HTML, CSS, and JavaScript. The README (“my-little-websites, made through vibe-coding”) reinforces that this is a hobbyist project showcasing several separate functionalities (e.g., calendar app, countdown, grade calculator, JSON viewer, text converter).

##### File Structure Analysis
- At the top level, there is a README.md and several HTML files (index.html, countdown.html, grade-calculator.html, json-viewer.html, text-converter.html), each representing a separate website or a demo.
- The “calender-app” directory is a self-contained sub-application that includes:
- index.html: The main HTML entry point.
- main.js: JavaScript functionality for the calendar.
- style.css: Specific styling for the calendar.
- The existence of multiple individual HTML files alongside the grouped “calender-app” suggests a design where each page/component can be visited independently, likely from a homepage that might link to them.

a. Main Components:
- Static Pages: Represent each individual web page (e.g., homepage/index.html, countdown.html, grade-calculator.html, json-viewer.html, text-converter.html).
- Calender App Module: A dedicated component for the calendar functionality, represented as a grouped unit (with its own HTML, CSS, and JavaScript).

b. Relationships & Interactions:
- The user's browser is the entry point and loads any of the static HTML pages.
- Each page might have its own self-contained styling and scripts.
- For the “calender-app”, show an internal interaction between index.html (the view) and main.js (the script controlling the app’s behavior), with style.css for presentation.

c. Architectural Patterns & Design Principles:
- Separation of Concerns: Each website or module is clearly separated by its file(s), with HTML for structure, CSS for styling, and JavaScript for behavior.
- Modularity: Although the project is simple, the “calender-app” directory encapsulates its functionality, mirroring component-based design principles.
- Client-Side Execution: Emphasize that the entire system runs in the browser with no backend processing.

d. Relevant Technologies:
- If any library or external dependency were used (not visible here), that should be pointed out next to the corresponding component.

## Diagram (Mermaid)

```mermaid
flowchart TD
    B("Browser/Client"):::client
    HP("Homepage (index.html)"):::static
    CD("Countdown (countdown.html)"):::static
    GC("Grade Calculator (grade-calculator.html)"):::static
    JV("JSON Viewer (json-viewer.html)"):::static
    TC("Text Converter (text-converter.html)"):::static
    CA_Module("Calendar App Module"):::module

    subgraph "Calendar App Details"
        CA_HTML("index.html"):::internal
        CA_JS("main.js"):::internal
        CA_CSS("style.css"):::internal
    end

    B -->|"loads"| HP
    B -->|"loads"| CD
    B -->|"loads"| GC
    B -->|"loads"| JV
    B -->|"loads"| TC
    B -->|"loads"| CA_Module
    CA_Module -->|"initiates"| CA_HTML
    CA_HTML -->|"triggers"| CA_JS
    CA_HTML -->|"styled_by"| CA_CSS

    click HP "https://github.com/vernalan/websites/blob/main/index.html"
    click CD "https://github.com/vernalan/websites/blob/main/countdown.html"
    click GC "https://github.com/vernalan/websites/blob/main/grade-calculator.html"
    click JV "https://github.com/vernalan/websites/blob/main/json-viewer.html"
    click TC "https://github.com/vernalan/websites/blob/main/text-converter.html"
    click CA_Module "https://github.com/vernalan/websites/tree/main/calender-app"

    classDef client fill:#ADD8E6,stroke:#333,stroke-width:2px;
    classDef static fill:#90EE90,stroke:#333,stroke-width:2px;
    classDef module fill:#FFFACD,stroke:#333,stroke-width:2px;
    classDef internal fill:#FFB6C1,stroke:#333,stroke-width:2px;
```
