# shadman1077/osus-eye-website architecture

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

- Interactive diagram: https://gitdiagram.com/shadman1077/osus-eye-website
- Repository: https://github.com/shadman1077/osus-eye-website

## Overview

##### Project type and purpose
- This is a static, bilingual marketing website (“OSUS Eye Website”) exported from Webflow.
- Purpose: serve responsive, SEO-optimized HTML/CSS/JS pages (in two locales) with rich media (images, fonts, videos).

##### File structure
- Top level:
- HTML pages (e.g., index.html, community.html, discover.html, etc.)
- css/ (normalize.css, webflow styles)
- js/ (webflow.js)
- fonts/ (GTAmericaArabic .otf)
- images/ (static images folder)
- videos/ (MP4/WebM versions)
- en/ (mirrors of top-level HTML pages for “en” locale)
- documents/ (animation JSON)
- No backend code, APIs, or database layers—purely static assets.

##### README
- Confirms static Webflow export, bilingual support, responsive design, SEO focus, modern-browser compatibility.
- No custom server logic, no dynamic data fetching.

a. Main components
1. Client (Web Browser)
2. CDN / Web Server (e.g., Netlify, S3 + CloudFront, GitHub Pages)
3. Static Assets
– HTML pages (root and /en)
– CSS files (normalize.css, osus-eye-website.webflow.css, webflow.css)
– JavaScript (webflow.js)
– Fonts (GTAmericaArabic)
– Images
– Videos (MP4/WebM)
– Documents (JSON animations)
4. External Services (optional)
– DNS provider
– Analytics (Google Analytics or similar)
– SEO crawler/Search engines
b. Relationships and interactions
- Client → CDN/Web Server: HTTP(S) requests
- CDN/Web Server → Client: serves static HTML, CSS, JS, media assets
- Browser: renders HTML, applies CSS, executes JS (Webflow runtime), requests images/fonts/videos
- (Optional) Browser → Analytics endpoint: tracks page views
- Search engine crawlers traverse public URLs for SEO.
c. Architectural patterns/design principles
- Static site hosting (no server-side rendering or dynamic API).
- Bilingual content via directory structure (/en prefix).
- Separation of concerns: structural HTML, presentation CSS, behavior JS.
- Asset optimization: separate directories for fonts, images, videos.
d. Key technologies/frameworks
- Webflow-generated HTML/CSS/JS
- CDN or static-site host (e.g., AWS S3 + CloudFront, Netlify)
- Standard web assets (HTML5, CSS3, ES5 JS)
- JSON for animations

##### Essential architectural elements
- Explicitly separate localization paths (/ vs /en).
- Static hosting layer and absence of application server.
- Asset types and their delivery flow.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    Browser["Client Browser"]:::client
    Browser -->|DNS lookup| DNS["DNS Provider"]:::external
    Browser -->|HTTPS Request| CDN["CDN / Static-Site Host"]:::host

    %% Static Hosting Layer
    subgraph "Static-Site Host" 
        direction TB
        Assets["Static Assets"]:::host

        subgraph "HTML Pages"
            direction TB
            RootHTML["Root Locale HTML Pages"]:::host
            ENHTML["English Locale HTML Pages (/en)"]:::host
        end

        subgraph "CSS & JS"
            direction TB
            CSS["CSS Files"]:::host
            JS["JavaScript Files"]:::host
        end

        subgraph "Media Assets"
            direction TB
            Fonts["Font Files"]:::media
            Images["Image Assets"]:::media
            Videos["Video Assets"]:::media
            Docs["Document Assets (JSON)"]:::media
        end

        Assets --> RootHTML
        Assets --> ENHTML
        Assets --> CSS
        Assets --> JS
        Assets --> Fonts
        Assets --> Images
        Assets --> Videos
        Assets --> Docs
    end

    %% Analytics & Search
    Browser -->|Track page view| Analytics["Analytics Service"]:::external
    Search["Search Engines"]:::external -->|Crawl URLs| CDN

    %% Asset Fetching Flow
    Browser -->|Fetch HTML| RootHTML
    Browser -->|Fetch localized HTML| ENHTML
    Browser -->|Fetch CSS/JS| CSS
    Browser -->|Fetch JS runtime| JS
    Browser -->|Fetch fonts/images/videos| Fonts
    Browser -->|Fetch fonts/images/videos| Images
    Browser -->|Fetch fonts/images/videos| Videos
    Browser -->|Fetch animation docs| Docs

    %% Click Events
    click RootHTML "https://github.com/shadman1077/osus-eye-website/blob/main/index.html"
    click ENHTML "https://github.com/shadman1077/osus-eye-website/blob/main/en/home.html"
    click CSS "https://github.com/shadman1077/osus-eye-website/blob/main/css/normalize.css"
    click JS "https://github.com/shadman1077/osus-eye-website/blob/main/js/webflow.js"
    click Fonts "https://github.com/shadman1077/osus-eye-website/blob/main/fonts/GTAmericaArabic-Regular.otf"
    click Images "https://github.com/shadman1077/osus-eye-website/tree/main/images/"
    click Videos "https://github.com/shadman1077/osus-eye-website/tree/main/videos/"
    click Docs "https://github.com/shadman1077/osus-eye-website/blob/main/documents/Animation---1733720038959.json"

    %% Styles
    classDef client fill:#9f6,stroke:#393,stroke-width:2px
    classDef host fill:#6cf,stroke:#039,stroke-width:2px
    classDef media fill:#f96,stroke:#d60,stroke-width:2px
    classDef external fill:#ccc,stroke:#666,stroke-width:2px
```
