¿Qué es el archivo astro.config.mjs?
Es el archivo principal de configuración de Astro. Es el "cerebro" donde le indicas al framework cómo debe comportarse, qué herramientas adicionales va a usar y cómo va a construir el sitio web.
Ejemplo de contenido de un archivo astro.config.mjs:
¿Qué se configura dentro de astro.config.mjs
Integraciones (Integrations):Aquí es donde registras frameworks UI o librerías externas que uses con Astro (como React, Vue, Tailwind CSS, Svelte, MDX, Sitemap, etc.).
Adaptadores de despliegue (Adapters):Si el sitio requiere renderizado en el servidor (*Server-Side Rendering / SSR*), aquí se configura el adaptador específico para el hosting (como
@astrojs/vercel,@astrojs/netlifyo@astrojs/cloudflare).URL del sitio web:En esta sección se define el dominio final del proyecto (ejemplo:
). Astro usa esta URL para generar automáticamente mapas del sitio (site: https://miweb.comsitemap.xml), feeds RSS y URLs absolutas para SEO.Redirecciones y Rutas:Puedes definir reglas de redirección permanente o temporal de URLs antiguas a nuevas.
Opciones del Servidor y Vite:Astro utiliza Vite por debajo para compilar el proyecto. Desde este archivo puedes personalizar opciones del servidor de desarrollo (como el puerto) o plugins avanzados de Vite.
¿Dónde se ubica?
En la raíz del proyecto (al mismo nivel que package.json).
¿Se sube a Git y al Hosting?
A Git / GitHub: SÍ.
Es un archivo vital del código fuente. Todo tu equipo necesita la misma configuración.
Al Hosting: SÍ
Vercel/Netlify/Cloudflare lo necesitan en el repositorio de GitHub para saber cómo compilar el sitio correctamente con npm run build.