# sebastiansierra15/udlaverso-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/sebastiansierra15/udlaverso-frontend
- Repository: https://github.com/sebastiansierra15/udlaverso-frontend

## Overview

##### Project Type & Purpose
- Type: A single-page application (SPA) built with React, TypeScript, Vite, Tailwind CSS, following an Atomic Design component structure.
- Purpose: A marketing/documentation site (with pages like “AcercaDe,” “FAQ,” “Noticias,” “Proyectos,” etc.), deployed as static assets (Netlify).

##### File Structure
Top-level areas:
- public/ – Static assets (images, videos, logos) served as-is
- src/
– main.tsx + index.html + index.css: app entry point + global styles
– pages/ – Route pages (one per URL path)
– components/ – UI layer organized by Atomic Design:
· atoms → molecules → organisms → templates (in “templates” subfolders)
– assets/, content/ & utils/
- Configuration & build scripts:
– vite.config.ts, tailwind.config.js, postcss.config.js, eslint.config.js, netlify.toml

##### README for Insights
- Confirms Vite with React plugin, HMR, ESLint rules, optional React Compiler.
- No backend or API calls are referenced—this is purely frontend/hosting.

##### Main Components and Their Relationships
A. Development & Build Pipeline
1. Developer edits .tsx/.ts files in src/
2. Vite Dev Server provides HMR for local testing
3. On build, Vite + PostCSS + Tailwind generate optimized bundles
4. Netlify CI/CD picks up dist/ and deploys to a CDN
B. Runtime (Client-side)
1. User’s browser fetches index.html + JS/CSS bundles from CDN
2. React Router in main.tsx mounts App.tsx
3. App renders Page components (in src/pages/) based on URL
4. Pages compose Organisms → Molecules → Atoms components
5. Assets (images, videos) are loaded from /public via static routes
C. Design Pattern
Atomic Design:
– Molecules: small groups of atoms (input groups, card snippets)
– Organisms: larger sections (headers, footers, hero sections)
– Templates/Pages: route-level layouts and content composition

##### Key Technologies & Frameworks
- React + TypeScript for UI & type safety
- Vite for fast development and build
- Tailwind CSS + PostCSS for styling
- ESLint (with optional React/TypeScript plugins)
- Netlify for static hosting & CDN

##### Essential Details to Capture
- Vite Dev Server & Plugins (fast refresh, ESLint)
- Build → dist/ artifacts → Netlify deploy
- CDN distribution of JS/CSS/assets
- React App bootstrapped by main.tsx → App.tsx
- Routing layer (pages folder)
- Atomic Design component flow: Atoms → Molecules → Organisms → Templates → Pages
- Tailwind & PostCSS pipeline

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Development & Build Layer
    subgraph "Development & Build"
        direction TB
        DevMachine["Developer Machine"]:::devci
        ViteDev["Vite Dev Server (HMR)"]:::devci
        ESLint["ESLint (Linting)"]:::devci
        ViteConfig["vite.config.ts"]:::devci
        TailwindConfig["tailwind.config.js"]:::devci
        PostCSSConfig["postcss.config.js"]:::devci
        ESLintConfig["eslint.config.js"]:::devci
        TSConfig["tsconfig*.json"]:::devci
        PackageJSON["package.json"]:::devci

        DevMachine -->|"edit .tsx/.ts files"| ViteDev
        DevMachine -->|use lint rules| ESLint
        ViteDev -->|reads config| ViteConfig
        ViteDev -->|reads config| TailwindConfig
        ViteDev -->|reads config| PostCSSConfig
        ESLint -->|reads config| ESLintConfig
        ViteDev -->|reads config| TSConfig
        ViteDev -->|reads deps| PackageJSON
    end

    %% CI/CD & Hosting Layer
    subgraph "CI/CD & Hosting"
        direction TB
        GitHub["Git Repository"]:::devci
        NetlifyCI["Netlify CI/CD"]:::hosting
        ViteBuild["Vite Build → dist/"]:::devci
        NetlifyConfig["netlify.toml"]:::hosting
        CDN["CDN (Netlify Edge)"]:::hosting

        DevMachine -->|git push| GitHub
        GitHub -->|triggers build| NetlifyCI
        NetlifyCI -->|uses netlify.toml| NetlifyConfig
        NetlifyCI -->|runs build| ViteBuild
        ViteBuild -->|deploy dist| CDN
    end

    %% Assets & Content Layer
    subgraph "Assets & Content"
        direction TB
        PublicAssets["public/"]:::assets
        SrcAssets["src/assets/"]:::assets
        ContentDef["src/content/ComoEmpezar.ts"]:::assets

        CDN -->|"serves static assets"| PublicAssets
        CDN -->|"serves bundled asset files"| SrcAssets
        CDN -->|"serves content definitions"| ContentDef
    end

    %% Client-side Application Layer
    subgraph "Client-side Application"
        direction TB
        IndexHTML["index.html"]:::runtime
        GlobalStyles["src/index.css"]:::runtime
        MainTSX["src/main.tsx"]:::runtime
        AppTSX["src/App.tsx"]:::runtime
        LayoutComp["src/Layouts/Layout.tsx"]:::runtime
        Router["React Router"]:::runtime

        IndexHTML -->|loads CSS/JS| GlobalStyles
        IndexHTML -->|bootstrap| MainTSX
        MainTSX -->|mounts| AppTSX
        AppTSX -->|wraps| LayoutComp
        AppTSX -->|uses| Router

        %% Pages
        subgraph "Pages (Routing Layer)"
            direction TB
            AcercaDe["AcercaDe.tsx"]:::runtime
            Login["Login.tsx"]:::runtime
            Recuperar["RecuperarContrasenia.tsx"]:::runtime
            Registrarse["Registrarse.tsx"]:::runtime
            ComoEmpezarPg["ComoEmpezar.tsx"]:::runtime
            Contacto["Contacto.tsx"]:::runtime
            FAQ["FAQ.tsx"]:::runtime
            Inicio["Inicio.tsx"]:::runtime
            Noticias["Noticias.tsx"]:::runtime
            NoticiaDetalle["NoticiaDetalle.tsx"]:::runtime
            Proyectos["Proyectos.tsx"]:::runtime
            ProyectoDetalle["ProyectoDetalle.tsx"]:::runtime

            Router -->|route| AcercaDe
            Router -->|route| Login
            Router -->|route| Recuperar
            Router -->|route| Registrarse
            Router -->|route| ComoEmpezarPg
            Router -->|route| Contacto
            Router -->|route| FAQ
            Router -->|route| Inicio
            Router -->|route| Noticias
            Router -->|route| NoticiaDetalle
            Router -->|route| Proyectos
            Router -->|route| ProyectoDetalle
        end

        %% Atomic Design Components
        subgraph "Atomic Design Components"
            direction TB
            subgraph Atoms
                direction TB
                Atoms["src/components/**/atoms/"]:::runtime
            end
            subgraph Molecules
                direction TB
                Molecules["src/components/**/molecules/"]:::runtime
            end
            subgraph Organisms
                direction TB
                Organisms["src/components/**/organisms/"]:::runtime
            end
            subgraph Templates
                direction TB
                Templates["src/components/**/templates/"]:::runtime
            end
            Shared["src/components/Shared/"]:::runtime
            Utils["src/components/utils/ScrollTop.tsx"]:::runtime

            AcercaDe -->|uses| Templates
            Templates -->|compose| Organisms
            Organisms -->|compose| Molecules
            Molecules -->|compose| Atoms
            AppTSX -->|imports| Shared
            AppTSX -->|imports| Utils
        end
    end

    %% User Flow
    CDN -->|CDN → Browser| UserBrowser["User Browser"]:::runtime
    UserBrowser -->|fetch index.html| IndexHTML
    UserBrowser -->|load assets| PublicAssets

    %% Click events
    click PublicAssets "https://github.com/sebastiansierra15/udlaverso-frontend/tree/main/public/"
    click IndexHTML "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/index.html"
    click GlobalStyles "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/index.css"
    click MainTSX "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/main.tsx"
    click AppTSX "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/App.tsx"
    click LayoutComp "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/Layouts/Layout.tsx"
    click AcercaDe "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/AcercaDe/AcercaDe.tsx"
    click Login "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Auth/Login.tsx"
    click Recuperar "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Auth/RecuperarContrasenia.tsx"
    click Registrarse "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Auth/Registrarse.tsx"
    click ComoEmpezarPg "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/ComoEmpezar/ComoEmpezar.tsx"
    click Contacto "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Contacto/Contacto.tsx"
    click FAQ "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/FAQ/FAQ.tsx"
    click Inicio "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Inicio/Inicio.tsx"
    click Noticias "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Noticias/Noticias.tsx"
    click NoticiaDetalle "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Noticias/NoticiaDetalle.tsx"
    click Proyectos "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Proyectos/Proyectos.tsx"
    click ProyectoDetalle "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/pages/Proyectos/ProyectoDetalle.tsx"
    click Atoms "https://github.com/sebastiansierra15/udlaverso-frontend/tree/main/src/components/**/atoms/"
    click Molecules "https://github.com/sebastiansierra15/udlaverso-frontend/tree/main/src/components/**/molecules/"
    click Organisms "https://github.com/sebastiansierra15/udlaverso-frontend/tree/main/src/components/**/organisms/"
    click Templates "https://github.com/sebastiansierra15/udlaverso-frontend/tree/main/src/components/**/templates/"
    click Shared "https://github.com/sebastiansierra15/udlaverso-frontend/tree/main/src/components/Shared/"
    click Utils "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/src/components/utils/ScrollTop.tsx"
    click ViteConfig "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/vite.config.ts"
    click TailwindConfig "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/tailwind.config.js"
    click PostCSSConfig "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/postcss.config.js"
    click ESLintConfig "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/eslint.config.js"
    click TSConfig "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/tsconfig.json"
    click NetlifyConfig "https://github.com/sebastiansierra15/udlaverso-frontend/blob/main/netlify.toml"

    %% Styles
    classDef devci fill:#eeeeee,stroke:#888888,color:#000000
    classDef hosting fill:#bbdefb,stroke:#1e88e5,color:#0d47a1
    classDef runtime fill:#c8e6c9,stroke:#2e7d32,color:#1b5e20
    classDef assets fill:#ffe0b2,stroke:#fb8c00,color:#e65100
```
