Deploy de Astro en Cloudflare Pages en 5 minutos

Guía rápida para publicar un sitio Astro en Cloudflare Pages con dominio propio, HTTPS automático y previews por rama.

19 de julio de 2026 · #cloudflare#astro#pages#tutorial

Cloudflare Pages es de mis formas favoritas de publicar sitios estáticos: git push, deploy automático, HTTPS incluido y CDN global sin configurar nada.

1. Crea el proyecto en Cloudflare

En el dashboard: Workers & Pages → Create → Pages → Connect to Git.

Configura el build:

Framework preset: Astro
Build command: npm run build
Build output: dist

2. Push y listo

Cada git push a main genera un deploy a producción. Cada PR genera una preview URL única (perfecto para revisar cambios antes de mergear).

3. Dominio propio

Ve a la pestaña Custom domains del proyecto y añade tu dominio. Si el dominio ya está en Cloudflare, se configura solo. Si no, tendrás que apuntar un CNAME a <proyecto>.pages.dev.

Tips útiles

Node version: define NODE_VERSION=20 en las variables de entorno del proyecto para evitar sorpresas.
Build cache: Pages cachea node_modules/ automáticamente entre builds.
Wrangler local: usa npx wrangler pages dev ./dist para probar binds de KV, D1 o R2 en local.

Eso es todo. En serio.