# jhonja999/landing-dev architecture

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

- Interactive diagram: https://gitdiagram.com/jhonja999/landing-dev
- Repository: https://github.com/jhonja999/landing-dev

## Overview

Para dibujar un diagrama de arquitectura claro y preciso para “Landing Pad” (un tema Astro tipo CMS estático), sigue estos pasos:

##### Identificación del tipo y propósito
- Proyecto Jamstack estático con Astro: mezcla de SSG (Static Site Generation) y un CMS opcional (Keystatic) para editar Markdown/YAML localmente.
- Objetivo: generar un sitio de enlaces (link-in-bio) y panel de administración local para edición de contenido.

##### Componentes principales
A. Entorno de Desarrollo
- Editor de código (VS Code).
- Node.js + npm.
- Dependencias: Astro, Tailwind CSS, Keystatic, astro:assets.
- Configuraciones: astro.config.mjs, tailwind.config.cjs, keystatic.config.tsx, netlify.toml/vercel.json.

B. Capa de Contenido
- Files Markdown/YAML en src/data/ (bio, links, projects, socials).
- Assets estáticos en src/assets/ y public/.

C. Motor de Construcción
- Astro CLI: lee src/pages/, src/components/, src/layouts/, y la content API (src/content.config.ts).
- Plugins: astro:assets (optimización de imágenes), Tailwind CSS.
- Keystatic: UI en /admin para editar los archivos bajo src/data/.

D. Salida Estática
- Carpeta /dist/ generada por npm run build.
- Archivos HTML, CSS (Tailwind compilado), JS mínimo, imágenes optimizadas.

E. Despliegue y CDN
- Netlify/Vercel/Cloudflare: entregan los assets estáticos al usuario final.
- Dominio configurado en astro.config.mjs y public/robots.txt.

F. Usuario Final
- Navegador web consume los archivos estáticos.
- Opcionalmente usa Keystatic (solo en entorno dev o con autenticación) para editar contenido.

##### Relaciones e Interacciones
- Flechas de datos:
- Desarrollador → Archivos fuente (src/)
- Node.js (Astro CLI) ← Archivos fuente
- Astro CLI → /dist/
- CDN ← /dist/
- Navegador ← CDN
- Navegador → /admin (solo en dev) → Keystatic UI → modifica src/data/
- Destacar que la edición via Keystatic escribe directamente en archivos Markdown/YAML.

##### Patrón Arquitectural
- Jamstack / SSG: separación clara entre contenido (ficheros), build (Astro) y presentación (static hosting).
- Componentes UI (Astro components) reutilizables (Links, Projects, Seo, Socials, ThemeToggle).

##### Tecnologías Clave
- Astro (SSG, routing, content collections).
- Keystatic (CMS local headless).
- Tailwind CSS (estilos).
- Netlify/Vercel (hosting, CDNs).
- Node.js + npm.

##### Guía de diagramación
a. Usa rectángulos/grupos para cada componente:
– “Developer Workstation” (Editor, terminal)
– “Content Store” (src/data/, src/assets/, public/)
– “Build Server” (Astro CLI, Tailwind, Plugins)
– “Static Output” (/dist/)
– “CDN / Hosting Platform”
– “End User Browser”
– “Admin UI (Keystatic)”

b. Flechas direccionales con etiquetas:
– “build” entre Developer → Build Server → Static Output
– “deploy” entre Static Output → CDN/Hosting
– “fetch” entre End User → CDN/Hosting
– “edit content” entre Admin UI → Content Store

c. Colores/Formas:
– Azules para procesos (Build, Hosting)
– Verdes para almacenamiento (Content Store, Static Output)
– Naranja para UX/UI (Admin UI, Browser)

d. Añade notas de config files junto a los componentes relevantes:
– astro.config.mjs en Build Server
– tailwind.config.cjs en Build Server
– keystatic.config.tsx junto a Admin UI

##### Nivel de detalle
- Incluye todos los directorios clave (src/pages/, src/components/, src/layouts/) dentro del bloque “Content Store”.
- Marca la etapa de optimización de imágenes (astro:assets) en el Build Server.
- Señala que el sitio resultante es 100% estático.

Siguiendo esta estructura, obtendrás un diagrama muy detallado y fiel a la arquitectura real de “Landing Pad”, mostrando cómo el contenido, la construcción y la entrega al usuario final están separados y orquestados.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer Workstation
    Dev["Developer Workstation"]:::ui

    %% Content Store
    subgraph "Content Store"
        Data["Data (src/data/)"]:::storage
        Assets["Assets (src/assets/)"]:::storage
        Public["Public (public/)"]:::storage
        subgraph "UI Components"
            Pages["Pages (src/pages/)"]:::storage
            Components["Components (src/components/)"]:::storage
            Layouts["Layouts (src/layouts/)"]:::storage
            Styles["Styles (src/styles/)"]:::storage
        end
    end

    %% Build Server
    subgraph "Build Server"
        AstroCLI["Astro CLI"]:::process
        Tailwind["Tailwind CSS"]:::process
        ImgOpt["Image Optimization (astro:assets)"]:::process
        astroConfig["astro.config.mjs"]:::process
        tailwindConfig["tailwind.config.cjs"]:::process
        contentConfig["Content API config (src/content.config.ts)"]:::process
    end

    %% Admin UI
    AdminUI["Admin UI (Keystatic)"]:::ui
    keystaticConfig["keystatic.config.tsx"]:::process

    %% Static Output
    StaticOut["Static Output (/dist/)"]:::storage

    %% CDN / Hosting
    subgraph "CDN / Hosting Platform"
        Netlify["Netlify"]:::process
        Vercel["Vercel"]:::process
        netlifyConfig["netlify.toml"]:::process
        vercelConfig["vercel.json"]:::process
    end

    %% End User Browser
    Browser["End User Browser"]:::ui

    %% Relationships
    Dev -->|"edit source"| Data
    Dev -->|"edit source"| Assets
    Dev -->|"run build"| AstroCLI
    AstroCLI --> Tailwind
    AstroCLI --> ImgOpt
    AstroCLI --> StaticOut
    AstroCLI -->|"uses config"| astroConfig
    AstroCLI -->|"uses config"| tailwindConfig
    AstroCLI -->|"uses config"| contentConfig

    StaticOut -->|"deploy"| Netlify
    StaticOut -->|"deploy"| Vercel
    Netlify --> netlifyConfig
    Vercel --> vercelConfig

    Browser -->|"fetch"| Netlify
    Browser -->|"fetch"| Vercel
    Browser -->|"open admin"| AdminUI
    AdminUI -->|"uses config"| keystaticConfig
    AdminUI -->|"edit content"| Data

    %% Click Events
    click Data "https://github.com/jhonja999/landing-dev/tree/main/src/data/"
    click Assets "https://github.com/jhonja999/landing-dev/tree/main/src/assets/"
    click Public "https://github.com/jhonja999/landing-dev/tree/main/public/"
    click Pages "https://github.com/jhonja999/landing-dev/tree/main/src/pages/"
    click Components "https://github.com/jhonja999/landing-dev/tree/main/src/components/"
    click Layouts "https://github.com/jhonja999/landing-dev/tree/main/src/layouts/"
    click Styles "https://github.com/jhonja999/landing-dev/tree/main/src/styles/"
    click astroConfig "https://github.com/jhonja999/landing-dev/blob/main/astro.config.mjs"
    click tailwindConfig "https://github.com/jhonja999/landing-dev/blob/main/tailwind.config.cjs"
    click contentConfig "https://github.com/jhonja999/landing-dev/blob/main/src/content.config.ts"
    click AdminUI "https://github.com/jhonja999/landing-dev/blob/main/keystatic.config.tsx"
    click StaticOut "https://github.com/jhonja999/landing-dev/tree/main//dist/"
    click netlifyConfig "https://github.com/jhonja999/landing-dev/blob/main/netlify.toml"
    click vercelConfig "https://github.com/jhonja999/landing-dev/blob/main/vercel.json"

    %% Styles
    classDef process fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef storage fill:#90EE90,stroke:#000,stroke-width:1px
    classDef ui fill:#FFA500,stroke:#000,stroke-width:1px
```
