Deployment Issues

Netlify Build Fails

Check the build log for the first error. Confirm the build command is npm run build, the publish directory is dist, and the Node.js version matches the project requirement.

Broken Production URLs

Update astro.config.mjs with the final site URL. Rebuild after changing it.

DNS Delay

DNS records can take time to propagate. Use the hosting provider’s domain status and Cloudflare’s DNS panel to confirm records.

SSL Delay

Use DNS-only mode during certificate provisioning if proxied DNS blocks validation. After the certificate is issued, configure Cloudflare SSL as appropriate for the origin certificate.

Broken Internal Links

Run a production build and click through key pages in preview. Fix routes that changed during customization.