Por qué elegí Astro: arquitectura para un blog orientado a contenido

Monitor con código iluminado en habitación oscura
Fotografía de Harshit Katiyar · Unsplash (licencia gratuita). Contexto de desarrollo web con Astro; no captura de Astro. · Ver imagen original

Un blog técnico no necesita comportarse como una aplicación de escritorio. Su trabajo principal consiste en entregar artículos legibles, enlazables y accesibles. Sin embargo, junto a ese contenido aparecen necesidades reales: un archivo paginado, un tema claro/oscuro, bloques de código, un formulario y, quizá, alguna visualización interactiva. La decisión arquitectónica no consiste en eliminar JavaScript a cualquier precio, sino en elegir qué partes necesitan ejecutarlo y dónde.

Este proyecto utiliza Astro para la composición y el renderizado, Content Collections para gestionar artículos Markdown/MDX y una isla Svelte para el formulario. La elección es específica del tipo de sitio: mucha lectura, poca interacción permanente. No demuestra que Astro sea universalmente más rápido ni que otros frameworks envíen JavaScript innecesario en todos los casos.

Ilustración conceptual de arquitectura de contenidos en Astro: MDX, colecciones y HTML estático.
Ilustración conceptual original: síntesis visual del tema del artículo, no captura ni prueba ejecutada.

El contenido como unidad de arquitectura

Un post tiene un título, una fecha, etiquetas, una imagen de portada y un cuerpo. En una aplicación tradicional podría obtenerse en cada petición desde una base de datos; aquí, los artículos viven en archivos versionados. Ese punto de partida reduce componentes operativos: no hace falta un CMS dinámico únicamente para servir texto que cambia cuando se publica una nueva versión.

En el repositorio, la cadena tiene responsabilidades concretas:

  1. src/content/blog/ contiene los documentos.
  2. src/content/config.ts valida los metadatos mediante un esquema.
  3. src/lib/posts.ts consulta las entradas publicadas y las ordena por fecha.
  4. src/pages/blog/[slug].astro asigna una ruta a cada entrada y renderiza su cuerpo.
  5. Los layouts y componentes Astro aportan cabecera, portada, navegación y artículos relacionados.

Esta organización tiene una propiedad valiosa: el contenido no decide por sí mismo cómo debe renderizarse todo el sitio. El documento aporta datos; la ruta selecciona el artículo; el layout controla la presentación. No es una abstracción gratuita: permite modificar el diseño de lectura sin reescribir los posts.

El esquema que realmente usa este blog

La versión instalada declarada en package.json es Astro 4 (^4.16.18). Para esta versión, la API de colecciones emplea src/content/config.ts y type: 'content'. Un fragmento representativo, coherente con la configuración real, es:

// src/content/config.ts — esquema Astro 4 simplificado
import { defineCollection, z } from 'astro:content';

const blog = defineCollection({
  type: 'content',
  schema: z.object({
    title: z.string(),
    pubDate: z.coerce.date(),
    draft: z.boolean().default(false),
    lang: z.enum(['es', 'en']).default('es'),
    tags: z.array(z.string()).default([]),
    coverImage: z.string(),
    description: z.string().optional(),
    coverAlt: z.string().optional(),
    coverCaption: z.string().optional(),
  }),
});

export const collections = { blog };

coverImage es obligatorio por decisión de este proyecto, no porque Astro imponga portadas a todas las colecciones. El esquema acepta tanto rutas como cadenas URL; eso valida su tipo, no que el recurso remoto exista ni que la portada sea editorialmente apropiada. draft permite conservar trabajo sin publicarlo: el helper getPublishedPosts() filtra las entradas con data.draft falso antes de construir rutas y tarjetas.

Una precisión de versión: la documentación reciente de Astro utiliza la Content Layer API y suele situar las colecciones en src/content.config.ts, con loaders como glob(). Ese modelo llegó después de Astro 4; copiar sus ejemplos en este repositorio sin migrar el proyecto mezclaría dos APIs. La guía de colecciones de Astro 4 y la guía de actualización a Astro 5 explican la frontera.

Estático no significa necesariamente sin JavaScript

Astro puede generar HTML durante el build: el servidor de producción entrega un documento ya construido, sin necesitar montar un árbol de componentes JavaScript en el navegador para mostrar el título y los párrafos. Pero una página estática sí puede incluir JavaScript. En este blog, un script pequeño decide el tema visual y un componente Svelte gestiona el formulario de suscripción.

Conviene separar tres preguntas:

PreguntaRespuesta arquitectónica
¿Cuándo se genera el HTML?En build para rutas prerenderizadas; en una petición para rutas bajo demanda.
¿Cuánto JavaScript recibe el navegador?Depende de scripts incluidos e islas hidratadas, no solo del tipo de renderizado.
¿Qué necesita un servidor activo?Las rutas que ejecutan lógica por petición, además de servicios externos que use la aplicación.

El blog está configurado con output: 'hybrid' y un adaptador Vercel. En Astro 4, este modo prerenderiza las páginas ordinarias y permite marcar rutas específicas con export const prerender = false. Eso es precisamente lo que hace el endpoint src/pages/api/subscribe.ts: recibe una petición POST bajo demanda. El contenido del artículo, en cambio, puede entregarse como HTML prerenderizado.

// src/pages/api/subscribe.ts — parte del contrato real
import type { APIRoute } from 'astro';

export const prerender = false;

export const POST: APIRoute = async ({ request }) => {
  // Validar la petición y producir una respuesta HTTP.
  // Este ejemplo NO conecta un proveedor de newsletters.
  return new Response(JSON.stringify({ ok: true }), {
    headers: { 'Content-Type': 'application/json' },
  });
};

El fragmento muestra la separación de responsabilidades; no sustituye la validación del endpoint existente. En el código real se valida el email y se devuelve un éxito simulado: todavía no se almacena ningún suscriptor ni se envían correos. La documentación de renderizado bajo demanda de Astro 4 describe este modelo híbrido.

Las islas como frontera deliberada

En una plantilla Astro podemos renderizar un componente de framework como HTML sin hidratarlo. Si una interfaz necesita reaccionar a eventos después de cargar la página, una directiva client:* le indica a Astro cuándo descargar y activar el código del componente.

---
import SubscribeForm from '../../components/SubscribeForm.svelte';
---

<!-- El HTML del artículo no necesita hidratarse como una SPA. -->
<SubscribeForm variant="plain" client:load />

La ruta real de detalle utiliza client:load: el formulario necesita reaccionar al envío y ofrecer feedback sin una recarga. Esto tiene un coste, por pequeño que resulte: hay JavaScript del componente y trabajo de hidratación. Moverlo a client:visible podría retrasar ese coste, pero también cambiaría cuándo queda operativa la interfaz. No se debería cambiar la directiva por una intuición de rendimiento sin probar la experiencia real.

La explicación de renderizado, descarga, evaluación e hidratación, junto con el uso exacto de Svelte 4, se desarrolla en Islas Svelte en Astro.

Comparar frameworks exige comparar arquitecturas

La distinción relevante no es «Astro estático frente a cualquier otro framework dinámico». Next.js puede emplear Server Components y exportación estática; SvelteKit admite prerenderizado, SSR y renderizado cliente según la ruta; Eleventy y Hugo son opciones sólidas para generar contenido estático. Una comparación útil pregunta qué complejidad adicional introduce cada alternativa para los requisitos concretos del proyecto.

AlternativaEncaja especialmente cuandoCompromiso que conviene evaluar
AstroEl HTML y el contenido son predominantes; la interactividad es puntualCoordinación entre islas y restricciones de serialización cuando aumenta la interacción
Next.jsLa aplicación necesita React y un modelo amplio de rutas y datosDistinguir Server Components, Client Components, cachés y estrategias de render
SvelteKitSe necesita una aplicación Svelte con navegación, formularios y lógica por rutaElegir conscientemente qué rutas se prerenderizan y cuáles usan servidor
Eleventy / HugoEl contenido puede resolverse con generación estática y plantillasDiseñar por separado las capas interactivas y el flujo de publicación

No es correcto atribuir cantidades fijas de JavaScript a una tecnología sin inspeccionar la compilación de una aplicación específica. Tampoco es válido concluir que elegir Astro garantiza una puntuación determinada de Lighthouse: fuentes, imágenes, scripts de terceros, hosting y red siguen influyendo.

Rendimiento: medir antes de prometer

En un sitio editorial merece la pena observar las métricas de experiencia real: LCP (cuándo aparece el contenido principal), INP (respuesta a la interacción) y CLS (estabilidad visual). Los umbrales de referencia de Core Web Vitals para el percentil 75 son LCP de 2,5 segundos o menos, INP de 200 ms o menos y CLS de 0,1 o menos, medidos por separado para móvil y escritorio. Son umbrales de evaluación, no resultados medidos de este blog. Consulta web.dev para la metodología.

La revisión debería combinar:

  • bun run build para comprobar que las rutas y recursos se generan correctamente;
  • bun run test para los tests del proyecto (que incluyen el build);
  • mediciones reales de Lighthouse/CrUX o RUM, con contexto de dispositivo y red;
  • inspección de JavaScript transferido, imágenes de portada, HTML generado y cambios de layout.

El sitio ya usa pruebas sobre el HTML compilado y rutas; eso verifica contratos del producto, no sustituye pruebas de rendimiento en usuarios reales. No se presentan números de KB, tiempos de carga ni resultados de Core Web Vitals sin mediciones reproducibles.

Imágenes, SEO y publicación: los límites del content-first

El contenido versionado facilita URLs y metadatos coherentes, pero no crea automáticamente una estrategia de descubrimiento. La ruta del artículo recibe title y description desde su entrada; una publicación que quiera buena visibilidad también debe decidir canonical URLs, Open Graph, sitemap, RSS, control de indexación y versiones de idioma. En la configuración actual, site todavía declara una URL de ejemplo: antes de publicar un dominio definitivo hay que sustituirla y validar las URLs absolutas generadas.

Con imágenes ocurre algo parecido. Una URL de portada válida para el esquema puede ser editorialmente incorrecta, desaparecer o no tener dimensiones apropiadas. Astro ofrece herramientas de optimización y el elemento Image, pero no basta con escoger una API: hay que verificar el origen, la licencia, el texto alternativo y el comportamiento responsive. Las imágenes genéricas que acompañan entradas antiguas del blog son activos preexistentes, no evidencia del contenido del artículo. La mejora editorial pendiente consiste en sustituirlas por portadas diseñadas y aprobadas, no en generar placeholders.

Cuándo no elegir esta arquitectura

Si la experiencia principal es una aplicación muy interactiva con estado compartido entre decenas de componentes, una arquitectura orientada a aplicación puede ser más directa que coordinar islas. Si el contenido cambia por usuario en cada petición, habrá que evaluar SSR, cachés, autenticación y consistencia; «prerenderizar todo» podría no encajar. Si un equipo ya domina otra solución y obtiene métricas buenas, una migración a Astro necesita una justificación medible.

La razón para elegir Astro aquí es más concreta: el proyecto puede tratar los artículos como datos versionados, generar una navegación estática y pagar el coste de ejecución cliente únicamente en las interfaces que lo necesitan. El valor está en la frontera que impone esa arquitectura, no en una victoria universal de un framework sobre otro.

Para continuar con la implementación concreta del editor y los archivos, consulta el artículo sobre Markdown y Obsidian. Para examinar el lado interactivo de esta decisión, sigue con Islas Svelte en Astro.

Fuentes primarias: Astro 4 Content Collections, Astro 4 on-demand rendering, Astro Islands, migración de colecciones en Astro 5 y Core Web Vitals.