¿Qué hace Astro?
Resumen
Astro es un framework web para construir sitios web orientados al contenido que envía cero JavaScript por defecto. Su arquitectura de islas hidrata solo los componentes interactivos, logrando puntuaciones excelentes en Lighthouse, mientras es compatible con React, Vue, Svelte o cualquier framework de UI donde se necesite interactividad.
Instrucciones
- Al crear páginas, usa el enrutamiento basado en archivos en
src/pages/con archivos.astro,.mdo.mdx, y organiza la estructura compartida ensrc/layouts/. - Al agregar interactividad, usa directivas de cliente en componentes de framework: prefiere
client:visibleoclient:idleen lugar declient:load, ya que la mayoría de los componentes no necesitan hidratación inmediata. - Al gestionar contenido, define Colecciones de Contenido en
src/content/con esquemas Zod estrictos usandodefineCollection(), y consulta congetCollection()ygetEntry(). - Al elegir modos de renderizado, usa por defecto el estático (SSG) para páginas de marketing y contenido; usa
output: "server"para páginas dinámicas; o usa renderizado híbrido conexport const prerender = falsepor página. - Al optimizar imágenes, usa el componente
<Image>deastro:assetspara conversión automática de formato (WebP/AVIF), redimensionamiento y carga diferida, en lugar de etiquetas<img>sin procesar. - Al agregar transiciones de página, habilita las Transiciones de Vista con
<ViewTransitions />para una navegación similar a una SPA sin enviar un enrutador del lado del cliente. - Al integrar frameworks de UI, instala la integración correspondiente (
@astrojs/react,@astrojs/vue,@astrojs/svelte) y usa componentes de Astro para contenido estático, recurriendo a componentes de framework solo cuando se requiera interactividad.
Ejemplos
Ejemplo 1: Construir un blog con Colecciones de Contenido
Solicitud del usuario: "Crear un blog en Astro con contenido Markdown tipado"
Acciones:
- Definir una Colección de Contenido para el blog con un esquema Zod para el frontmatter (título, fecha, etiquetas, autor)
- Crear una ruta dinámica
src/pages/blog/[slug].astrocongetStaticPaths() - Construir la página de índice del blog consultando
getCollection("blog")con ordenación - Agregar un layout con etiquetas SEO, navegación y Transiciones de Vista
Resultado: Un blog generado estáticamente con contenido validado, URLs limpias y transiciones de página suaves.
Ejemplo 2: Agregar componentes interactivos a un sitio estático
Solicitud del usuario: "Agregar un componente de búsqueda en React a mi sitio de documentación en Astro"
Acciones:
- Instalar la integración
@astrojs/react - Crear el componente de búsqueda en React con estado y manejo de eventos
- Agregar el componente a la página con la directiva
client:idle - Pasar datos estáticos como props desde el frontmatter de la página de Astro
Resultado: Un sitio de documentación completamente estático, excepto por la isla de búsqueda interactiva.
Directrices
- Usa componentes de Astro (
.astro) para contenido estático; solo usa React/Vue/Svelte cuando se necesite interactividad. - Por defecto, usa
client:visibleoclient:idleen lugar declient:loadpara las directivas de hidratación. - Define Colecciones de Contenido con esquemas Zod estrictos para detectar errores de contenido en tiempo de compilación.
- Usa
<Image>deastro:assetsen lugar de etiquetas<img>sin procesar para una optimización automática. - Mantén los layouts ligeros con
<head>compartido, navegación y pie de página; coloca el contenido específico de cada página en las páginas. - Usa renderizado híbrido: estático para páginas de marketing, SSR solo para páginas personalizadas o dinámicas.
- Habilita las Transiciones de Vista para una navegación similar a una SPA sin enviar un enrutador.