# mehdibp/heliya architecture

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

- Interactive diagram: https://gitdiagram.com/mehdibp/heliya
- Repository: https://github.com/mehdibp/heliya

## Overview

##### Project type and purpose
- From the README (“Heliya: Designing a website for the Heliya Astronomy Association”) and the file list (index.html, main.css, main.js plus a .json/.xlsx of sky events), this is a simple static, data‐driven front-end website. Its goal is to display astronomical events in the browser, likely by loading the Sky Events JSON.

##### File structure
- Top-level assets:
- index.html – the entry point/view template
- main.css – styling
- main.js – client-side logic to fetch & render data
- Sky Events.json / Sky Events.xlsx – the raw data feed
- .gitignore – version control setup
- No server-side code, no build scripts or backend folder: implies deployment as a static site (e.g. GitHub Pages, Netlify, S3 + CloudFront).

##### README for additional insights
- No further architectural hints; it’s purely a static site for an astronomy association. The Excel file suggests a step where you convert to JSON (either manually or via a simple script/build step), but that process is outside the runtime architecture.

##### Detail
- Runtime environment (browser) vs. build-time tools (Excel conversion)
- How each file contributes to the overall user experience

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    Client["Client (Browser)"]:::client

    %% Hosting Layer
    Hosting["CDN / Web Server"]:::hosting

    %% Static Assets
    subgraph "Static Assets"
        HTML["index.html"]:::asset
        CSS["main.css"]:::asset
        JS["main.js"]:::asset
        JSON["Sky Events.json"]:::asset
    end

    %% Project Documentation
    subgraph "Project Files"
        README["README.md"]:::doc
        GITIGNORE[".gitignore"]:::doc
    end

    %% Pre-deployment Process
    subgraph "Pre-deployment"
        Excel["Sky Events.xlsx"]:::pre
        Excel -->|"convert to JSON"| JSON
    end

    %% Runtime Data Flow
    Client -->|"GET index.html"| Hosting
    Hosting -->|"200 OK + index.html"| Client

    Client -->|"GET main.css"| Hosting
    Hosting -->|"200 OK + main.css"| Client

    Client -->|"GET main.js"| Hosting
    Hosting -->|"200 OK + main.js"| Client

    JS -->|"fetch Sky Events.json"| Hosting
    Hosting -->|"200 OK + JSON data"| JS

    %% Click Events
    click HTML "https://github.com/mehdibp/heliya/blob/main/index.html"
    click CSS "https://github.com/mehdibp/heliya/blob/main/main.css"
    click JS "https://github.com/mehdibp/heliya/blob/main/main.js"
    click JSON "https://github.com/mehdibp/heliya/blob/main/Sky Events.json"
    click Excel "https://github.com/mehdibp/heliya/blob/main/Sky Events.xlsx"
    click README "https://github.com/mehdibp/heliya/blob/main/README.md"
    click GITIGNORE "https://github.com/mehdibp/heliya/blob/main/.gitignore"

    %% Styles
    classDef asset fill:#cce5ff,stroke:#3399ff,color:#000
    classDef hosting fill:#d4edda,stroke:#28a745,color:#000
    classDef client fill:#ffe5b4,stroke:#ff9900,color:#000
    classDef pre fill:#f0f0f0,stroke:#999,color:#000
    classDef doc fill:#f8f9fa,stroke:#6c757d,color:#000
```
