How jhonja999/landing-dev works
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.