# swiftdeskk/jesucristo-fuente-de-vida architecture

> Architecture diagram of the GitHub repository swiftdeskk/jesucristo-fuente-de-vida, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swiftdeskk/jesucristo-fuente-de-vida
- Repository: https://github.com/swiftdeskk/jesucristo-fuente-de-vida

## Overview

##### Project type and purpose (what you’re diagramming)
This repo is a **static, client-side website** (HTML/CSS/vanilla JS) for a church. There is **no backend service, no database, no build system** visible in the tree. The “system” is therefore primarily:
- A set of **static pages** (`index.html` + `pages/*.html`)
- Shared **static assets** (CSS, JS, images)
- Client-side **features** implemented in JS (animations, blog behavior, forms validation, gallery management, “new visitors” section)

##### File structure analysis (what maps to components)
Top-level:
- `index.html` — likely the landing/home page at site root
- `pages/` — additional site pages (blog, contacto, donaciones, etc.)
- `css/` — styling split by concern:
- `style.css` (base)
- `responsive.css` (media queries / layout adaptations)
- `animations.css` (animation definitions)
- `js/` — feature scripts:
- `main.js` — global/shared behavior across pages (navigation, UI glue, etc.)
- `animations.js` — runtime control of animations
- `forms.js` — client-side validation for contact/new visitor forms
- `blog.js` — blog page behavior (likely filtering, rendering, interactions)
- `galeria.js` — gallery page behavior (lightbox, carousel, etc.)
- `nuevos.js` — “new visitors” page behavior
- `images/` — page assets grouped by domain (blog/donaciones/equipo/galeria/ministerios)

Also: `CNAME` indicates GitHub Pages custom domain usage (common for static hosting). That’s a key deployment node.

##### README insights (architecture-relevant)
The README confirms:
- Tech stack: HTML5/CSS3/JavaScript only
- Features: responsive UI, animations, contact forms, gallery, blog, donations
- Usage: open `index.html` locally (no server needed)

##### HTML references
- CSS (`css/style.css`, `css/responsive.css`, `css/animations.css`)
- JS (`js/main.js` + page-specific JS)
- Images (`images/...`)
##### JS attaches event handlers and controls
- animations (from `animations.js` + `animations.css`)
- forms validation (`forms.js`)
- blog interactions (`blog.js`)
- gallery interactions (`galeria.js`)
- new visitors features (`nuevos.js`)
##### If forms/donations submit anywhere
- **Browser → External Service** (HTTP POST / redirect)
- External Service → confirmation page / redirect back to site (optional)

##### Architectural patterns/design principles to highlight
- **Static multi-page architecture (MPA)**: separate HTML pages per route
- **Separation of concerns**:
- Structure: HTML
- Presentation: CSS split into base/responsive/animations
- Behavior: JS split by feature/page
- **Progressive enhancement** (likely): pages render content without JS; JS enhances interactions (animations, gallery UI)

- HTML5, CSS3, Vanilla JavaScript
- Hosting: GitHub Pages (if accurate for the deployment), plus Custom Domain (CNAME)
- External: Payment processor / Form handler (if used)

##### What
Following explicitly:

- **Clear labels**:
- “Home Page (index.html)”
- “Blog Page (pages/blog.html)”
- “Global Script (js/main.js)”
- “Form Validation (js/forms.js)”
- “Static Hosting (GitHub Pages)”
- “Donation Provider (External)”
- Browser “requests” → Hosting
- HTML “loads” → CSS/JS/images
- JS “manipulates” → DOM / HTML page
- Form “submits” → External endpoint
- Rectangles for “pages”
- Rounded rectangles for “JS modules”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% =========================
    %% View 1 — Deployment/Delivery (vertical)
    %% =========================
    subgraph "View 1 — Deployment / Delivery"
        direction TB

        U["User (Desktop/Mobile)"]:::user
        B["Web Browser (HTML/CSS/Vanilla JS Runtime)"]:::client

        DNS["Custom Domain (CNAME / DNS)"]:::infra
        HOST["Static Hosting (GitHub Pages)"]:::infra
        CDN["CDN / Edge Cache (via hosting)"]:::infra

        ART["Static Site Artifacts (HTML/CSS/JS/Images)"]:::artifact

        EXT_FORM["Contact Form Handler (External / Out-of-repo)"]:::external
        EXT_PAY["Donation Processor (External / Out-of-repo)"]:::external
    end

    U -->|"uses"| B
    B -->|"resolves_domain"| DNS
    DNS -->|"routes_to"| HOST
    HOST -->|"serves_via"| CDN
    CDN -->|"delivers_static_files"| ART

    B -->|"submits_form(TBD)"| EXT_FORM
    B -->|"redirects_or_links(TBD)"| EXT_PAY

    %% =========================
    %% View 2 — Frontend Page-to-Module Map (vertical)
    %% =========================
    subgraph "View 2 — Frontend Runtime (Page → Assets → Features)"
        direction TB

        subgraph "Static Pages (MPA)"
            direction TB
            P_INDEX["Home Page (index.html)"]:::page
            P_NOS["About Page (Nosotros)"]:::page
            P_MIN["Ministries Page"]:::page
            P_BLOG["Blog Page"]:::page
            P_GAL["Gallery Page"]:::page
            P_NUE["New Visitors Page"]:::page
            P_DON["Donations Page"]:::page
            P_CON["Contact Page"]:::page
        end

        subgraph "Shared Styles (CSS)"
            direction TB
            CSS_BASE["Base Styles (style.css)"]:::css
            CSS_RESP["Responsive Styles (responsive.css)"]:::css
            CSS_ANIM["Animations Styles (animations.css)"]:::css
        end

        subgraph "Client Scripts (JS)"
            direction TB
            JS_MAIN["Global Script (main.js)"]:::js
            JS_ANIM["Animations Controller (animations.js)"]:::js
            JS_FORMS["Form Validation (forms.js)"]:::js

            subgraph "Page-specific Features"
                direction TB
                JS_BLOG["Blog Behavior (blog.js)"]:::js
                JS_GAL["Gallery Behavior (galeria.js)"]:::js
                JS_NUE["New Visitors Logic (nuevos.js)"]:::js
            end
        end

        subgraph "Static Media (Images)"
            direction TB
            IMG_BLOG["Blog Images"]:::media
            IMG_DON["Donations Images"]:::media
            IMG_TEAM["Team/Staff Images"]:::media
            IMG_GAL["Gallery Images"]:::media
            IMG_MIN["Ministries Images"]:::media
        end

        DOM["Rendered DOM (Progressive Enhancement)"]:::runtime
    end

    %% Browser loads pages (conceptual)
    ART -->|"includes"| P_INDEX
    ART -->|"includes"| P_NOS
    ART -->|"includes"| P_MIN
    ART -->|"includes"| P_BLOG
    ART -->|"includes"| P_GAL
    ART -->|"includes"| P_NUE
    ART -->|"includes"| P_DON
    ART -->|"includes"| P_CON

    %% Pages load shared CSS
    P_INDEX -->|"loads"| CSS_BASE
    P_INDEX -->|"loads"| CSS_RESP
    P_INDEX -->|"loads"| CSS_ANIM

    P_NOS -->|"loads"| CSS_BASE
    P_NOS -->|"loads"| CSS_RESP
    P_NOS -->|"loads"| CSS_ANIM

    P_MIN -->|"loads"| CSS_BASE
    P_MIN -->|"loads"| CSS_RESP
    P_MIN -->|"loads"| CSS_ANIM

    P_BLOG -->|"loads"| CSS_BASE
    P_BLOG -->|"loads"| CSS_RESP
    P_BLOG -->|"loads"| CSS_ANIM

    P_GAL -->|"loads"| CSS_BASE
    P_GAL -->|"loads"| CSS_RESP
    P_GAL -->|"loads"| CSS_ANIM

    P_NUE -->|"loads"| CSS_BASE
    P_NUE -->|"loads"| CSS_RESP
    P_NUE -->|"loads"| CSS_ANIM

    P_DON -->|"loads"| CSS_BASE
    P_DON -->|"loads"| CSS_RESP
    P_DON -->|"loads"| CSS_ANIM

    P_CON -->|"loads"| CSS_BASE
    P_CON -->|"loads"| CSS_RESP
    P_CON -->|"loads"| CSS_ANIM

    %% Pages load shared JS
    P_INDEX -->|"loads"| JS_MAIN
    P_INDEX -->|"loads"| JS_ANIM

    P_NOS -->|"loads"| JS_MAIN
    P_NOS -->|"loads"| JS_ANIM

    P_MIN -->|"loads"| JS_MAIN
    P_MIN -->|"loads"| JS_ANIM

    P_BLOG -->|"loads"| JS_MAIN
    P_BLOG -->|"loads"| JS_ANIM

    P_GAL -->|"loads"| JS_MAIN
    P_GAL -->|"loads"| JS_ANIM

    P_NUE -->|"loads"| JS_MAIN
    P_NUE -->|"loads"| JS_ANIM

    P_DON -->|"loads"| JS_MAIN
    P_DON -->|"loads"| JS_ANIM

    P_CON -->|"loads"| JS_MAIN
    P_CON -->|"loads"| JS_ANIM

    %% Page-specific scripts
    P_BLOG -->|"loads"| JS_BLOG
    P_GAL -->|"loads"| JS_GAL
    P_NUE -->|"loads"| JS_NUE

    %% Forms validation used by contact / new visitors
    P_CON -->|"loads"| JS_FORMS
    P_NUE -->|"loads"| JS_FORMS

    %% Scripts enhance runtime DOM
    JS_MAIN -->|"binds_UI_events"| DOM
    JS_ANIM -->|"controls_animations"| DOM
    JS_FORMS -->|"validates_forms"| DOM
    JS_BLOG -->|"enhances_blog_UI"| DOM
    JS_GAL -->|"enhances_gallery_UI"| DOM
    JS_NUE -->|"enhances_new_visitors_UI"| DOM

    %% Images used by relevant pages/features (representative mapping)
    P_BLOG -->|"uses"| IMG_BLOG
    P_DON -->|"uses"| IMG_DON
    P_NOS -->|"uses"| IMG_TEAM
    P_GAL -->|"uses"| IMG_GAL
    P_MIN -->|"uses"| IMG_MIN

    %% External interactions from specific pages (TBD / out-of-repo)
    P_CON -->|"submit_to(TBD)"| EXT_FORM
    P_NUE -->|"submit_to(TBD)"| EXT_FORM
    P_DON -->|"redirect_to(TBD)"| EXT_PAY

    %% =========================
    %% Legend
    %% =========================
    subgraph "Legend"
        direction TB
        L1["In-repo Page"]:::page
        L2["In-repo CSS"]:::css
        L3["In-repo JS"]:::js
        L4["In-repo Media"]:::media
        L5["Infrastructure"]:::infra
        L6["External/3rd-party"]:::external
    end

    %% =========================
    %% Click Events (from component_mapping)
    %% =========================
    click DNS "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/tree/main/CNAME"
    click P_INDEX "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/index.html"
    click P_BLOG "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/pages/blog.html"
    click P_CON "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/pages/contacto.html"
    click P_DON "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/pages/donaciones.html"
    click P_GAL "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/pages/galeria.html"
    click P_MIN "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/pages/ministerios.html"
    click P_NOS "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/pages/nosotros.html"
    click P_NUE "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/pages/nuevos.html"
    click CSS_BASE "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/css/style.css"
    click CSS_RESP "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/css/responsive.css"
    click CSS_ANIM "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/css/animations.css"
    click JS_MAIN "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/js/main.js"
    click JS_ANIM "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/js/animations.js"
    click JS_FORMS "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/js/forms.js"
    click JS_BLOG "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/js/blog.js"
    click JS_GAL "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/js/galeria.js"
    click JS_NUE "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/blob/main/js/nuevos.js"
    click IMG_BLOG "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/tree/main/images/blog/"
    click IMG_DON "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/tree/main/images/donaciones/"
    click IMG_TEAM "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/tree/main/images/equipo/"
    click IMG_GAL "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/tree/main/images/galeria/"
    click IMG_MIN "https://github.com/swiftdeskk/jesucristo-fuente-de-vida/tree/main/images/ministerios/"

    %% =========================
    %% Styles (color required)
    %% =========================
    classDef user fill:#E3F2FD,stroke:#1565C0,stroke-width:1px,color:#0D47A1
    classDef client fill:#E8F5E9,stroke:#2E7D32,stroke-width:1px,color:#1B5E20
    classDef infra fill:#FFF3E0,stroke:#EF6C00,stroke-width:1px,color:#E65100
    classDef artifact fill:#F3E5F5,stroke:#6A1B9A,stroke-width:1px,color:#4A148C
    classDef page fill:#FFFFFF,stroke:#424242,stroke-width:1px,color:#212121
    classDef css fill:#E0F7FA,stroke:#00838F,stroke-width:1px,color:#006064
    classDef js fill:#FFFDE7,stroke:#F9A825,stroke-width:1px,color:#7A5D00
    classDef media fill:#FCE4EC,stroke:#AD1457,stroke-width:1px,color:#880E4F
    classDef external fill:#ECEFF1,stroke:#455A64,stroke-width:1px,color:#263238,stroke-dasharray: 5 3
    classDef runtime fill:#EDE7F6,stroke:#4527A0,stroke-width:1px,color:#311B92
```
