# nugallan/python-desde-cero-adeviento-web architecture

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

- Interactive diagram: https://gitdiagram.com/nugallan/python-desde-cero-adeviento-web
- Repository: https://github.com/nugallan/python-desde-cero-adeviento-web

## Overview

##### Project Type and Purpose
- This is a static, single‐page web application built with Python and Reflex (a React‐style UI framework for Python) and then deployed as a static site (Next.js‐based output) to Vercel.
- Its purpose is to render an interactive “Calendario de aDEViento” UI entirely in the browser with no custom server‐side logic at runtime.

##### File‐Structure Analysis
- Top‐level packages and scripts:
- `adeviento_web/` (Python package with Reflex app)
- `assets/` (source CSS, JS, images)
- `public/` (build output: Next.js–generated static files under `_next/` and other HTML/JS/CSS)
- `build.sh`, `rxconfig.py`, `requirements.txt` (build and dependency configs)
- Within `adeviento_web/`:
- `components/` (reusable UI bits: Button, Day, HeaderText, etc.)
- `views/` (page‐level compositions: calendar, navbar, footer, etc.)
- `adeviento_web.py` (app entry point that composes views into a page)
- Build pipeline indicators:
- `rxconfig.py` (Reflex config)
- `build.sh` (script that likely invokes `reflex build` and Next.js build)

##### README Insights
- Specifies Python 3.12+, Reflex 0.7.2+, NES.CSS for styling, and Vercel for static hosting.
- No runtime backend beyond Reflex’s development server; production is pure static.

##### Core Components
a. Developer Environment
– Python + Reflex CLI (dev server & build tool)
– Source code folders (`adeviento_web/`, `assets/`)
b. Build/Transpilation Layer
– Reflex compiler → generates React/Next.js code
– Next.js build → bundles JS/CSS into `public/_next/` and HTML pages
c. Hosting/Delivery
– Static files on Vercel (or any static web host)
d. Client Side
– Browser running React UI (hydrated from static JS bundle)
e. External Dependencies
– NES.CSS (via CDN or local CSS in `assets/css`)
– Any other external JS libs (e.g., `countdown.js`, `snow.js`)

##### Relationships and Interactions
- During development: Browser ↔ WebSocket ↔ Reflex dev server (for hot‐reload).
- Static assets (CSS/JS from `assets/`) are consumed at build time and referenced in HTML.

##### Architectural Patterns and Principles
- Component‐based UI (React/Reflex)
- Unidirectional data flow in the browser
- Build‐time rendering → static site generation (SSG)
- Strict separation:
- Source (Python) → Build pipeline → Deployment assets
- No server‐side compute at runtime (static only)

##### Technologies and Frameworks to Annotate
- Python 3.12+
- Reflex (0.7.2+)
- Next.js (auto‐inferred from `_next/` folder)
- NES.CSS (2.3.0)
- Vercel (static hosting)

##### Essential Elements to Capture
- Components taxonomy (Python UI modules vs. static assets)
- Build stages (Reflex compile → Next.js SSG)
- Hosting & delivery (Vercel serving `public/`)
- Runtime environment (Browser executing React)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Environment
    subgraph "Dev Environment"
        subgraph "Source Code & Configurations"
            ENTRY["adeviento_web.py"]:::code
            CONST["constants.py"]:::code
            REQ["requirements.txt"]:::code
            RXCFG["rxconfig.py"]:::code
            BUILD_SH["build.sh"]:::code
        end
        subgraph "adeviento_web/"
            subgraph "components/"
                COMP_BUTTON["button.py"]:::code
                COMP_DAY["day.py"]:::code
                COMP_GH["github.py"]:::code
                COMP_HEADER_TEXT["header_text.py"]:::code
                COMP_LINK_ICON["link_icon.py"]:::code
            end
            subgraph "views/"
                VIEW_AUTHOR["author.py"]:::code
                VIEW_CAL["calendar.py"]:::code
                VIEW_FOOTER["footer.py"]:::code
                VIEW_HEADER["header.py"]:::code
                VIEW_INSTR["instructions.py"]:::code
                VIEW_NAV["navbar.py"]:::code
                VIEW_PART["partners.py"]:::code
            end
            subgraph "styles/"
                STYLE_COLORS["colors.py"]:::code
                STYLE_FONTS["fonts.py"]:::code
                STYLE_STYLES["styles.py"]:::code
            end
        end
        subgraph "assets/"
            CSS_MAIN["css/main.css"]:::code
            JS_COUNTDOWN["js/countdown.js"]:::code
            JS_SNOW["js/snow.js"]:::code
        end
        DEV_SERVER["Reflex Dev Server"]:::tool
    end

    %% Build Pipeline
    REFLEX["Reflex CLI & Compiler"]:::tool
    NEXTJS["Next.js Builder"]:::tool

    %% Build Output
    subgraph "Build Output (public/)"
        PUBLIC_NEXT["_next/"]:::code
        HTML_HOME["index.html"]:::code
        HTML_CAL["calendar/index.html"]:::code
        ROBOTS["robots.txt"]:::code
        SITEMAP["sitemap.xml"]:::code
        SITEMAP0["sitemap-0.xml"]:::code
        ERR404["404.html"]:::code
        ERR404I["404/index.html"]:::code
    end

    %% Hosting & Client
    VERCEL["Vercel CDN"]:::host
    BROWSER["Browser (React UI)"]:::client

    %% Data Flows
    ENTRY --> REFLEX
    BUILD_SH --> REFLEX
    RXCFG --> REFLEX
    REQ --> REFLEX

    REFLEX --> NEXTJS
    BUILD_SH --> NEXTJS
    CSS_MAIN --> NEXTJS
    JS_COUNTDOWN --> NEXTJS
    JS_SNOW --> NEXTJS

    NEXTJS --> PUBLIC_NEXT
    NEXTJS --> HTML_HOME
    NEXTJS --> HTML_CAL
    NEXTJS --> ROBOTS
    NEXTJS --> SITEMAP
    NEXTJS --> SITEMAP0
    NEXTJS --> ERR404
    NEXTJS --> ERR404I

    PUBLIC_NEXT --> VERCEL
    HTML_HOME --> VERCEL
    HTML_CAL --> VERCEL
    ROBOTS --> VERCEL
    SITEMAP --> VERCEL
    SITEMAP0 --> VERCEL
    ERR404 --> VERCEL
    ERR404I --> VERCEL

    VERCEL --> BROWSER

    BROWSER <--> DEV_SERVER

    %% Click Events
    click RXCFG "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/rxconfig.py"
    click BUILD_SH "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/build.sh"
    click REQ "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/requirements.txt"
    click ENTRY "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/adeviento_web.py"
    click COMP_BUTTON "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/components/button.py"
    click COMP_DAY "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/components/day.py"
    click COMP_GH "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/components/github.py"
    click COMP_HEADER_TEXT "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/components/header_text.py"
    click COMP_LINK_ICON "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/components/link_icon.py"
    click VIEW_AUTHOR "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/views/author.py"
    click VIEW_CAL "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/views/calendar.py"
    click VIEW_FOOTER "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/views/footer.py"
    click VIEW_HEADER "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/views/header.py"
    click VIEW_INSTR "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/views/instructions.py"
    click VIEW_NAV "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/views/navbar.py"
    click VIEW_PART "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/views/partners.py"
    click STYLE_COLORS "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/styles/colors.py"
    click STYLE_FONTS "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/styles/fonts.py"
    click STYLE_STYLES "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/styles/styles.py"
    click CONST "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/adeviento_web/constants.py"
    click CSS_MAIN "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/assets/css/main.css"
    click JS_COUNTDOWN "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/assets/js/countdown.js"
    click JS_SNOW "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/assets/js/snow.js"
    click PUBLIC_NEXT "https://github.com/nugallan/python-desde-cero-adeviento-web/tree/main/public/_next/"
    click HTML_HOME "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/public/index.html"
    click HTML_CAL "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/public/calendar/index.html"
    click ROBOTS "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/public/robots.txt"
    click SITEMAP "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/public/sitemap.xml"
    click SITEMAP0 "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/public/sitemap-0.xml"
    click ERR404 "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/public/404.html"
    click ERR404I "https://github.com/nugallan/python-desde-cero-adeviento-web/blob/main/public/404/index.html"

    %% Styles
    classDef code fill:#ADD8E6,stroke:#000
    classDef tool fill:#FFA500,stroke:#000
    classDef host fill:#90EE90,stroke:#000
    classDef client fill:#D3D3D3,stroke:#000
```
