Un sitio estático en Astro con 15KB de JavaScript estaba enviando 3.4MB de imágenes. Estos son los tres modos de fallo que se colaron por el pipeline de imágenes — la regla de que el original siempre se publica, la captura que el optimizador nunca tocó y el material de plantilla que nadie referenciaba — y las 15 líneas de Sharp que lo arreglaron todo.
Publicar un post estático en Astro está a un merge de estar en vivo — justo por eso los bugs silenciosos son peligrosos. Un lang incorrecto, un canonical que da 404, un link entre idiomas que se filtró: nada de eso se ve en tu editor, solo en el HTML compilado. Aquí está el checklist que corro sobre dist/ antes de cada post, scripts incluidos.
Un title tag y una meta description no son una configuración de SEO — son la parte que cualquier template ya te regala. La plomería que se acumula (JSON-LD, canonicals que no dan 404, hreflang que no se te revierte, un sitemap limpio) es lo que los portafolios omiten. Aquí está mi configuración completa de SEO en Astro, con código real incluido.
La migración de Astro 5 a 6 se veía como un bump de seguridad de diez minutos. En vez de eso choqué con tres builds rotos, uno tras otro — todos en código del theme que nunca escribí. Aquí están los errores exactos, los fixes, y por qué un sitio con theme se rompe donde tu propio código no se rompería.
Mi Google Analytics estaba instalado, verificado, y no recolectaba absolutamente nada — sin un solo error que me avisara. El culpable era un valor por default de Partytown en mi tema de Astro, que emite GA como un script que el navegador jamás ejecuta. Aquí está la trampa, y el arreglo de una línea.
While easy to get started, Astrowind is quite complex internally. This page provides documentation on some of the more intricate parts.