A curated store for the modern static web Read the Static Web Guide

Deployment / Static Web Guide

How to deploy an Astro site to Cloudflare Pages

The build settings and checks to understand before publishing an Astro project.

Updated 16 September 2026 · 6 min read

The build settings and checks to understand before publishing an Astro project.

Prepare the project

Confirm the site builds locally with npm install and npm run build. Check the Astro site value before deployment.

Set the build configuration

Connect the source repository to Cloudflare Pages. Use npm run build and dist as the output directory for a standard static Astro project.

Check the published site

Review routes, assets, canonicals and the sitemap on the public domain. Project-specific documentation may include additional steps.

Keep exploring

Browse the template catalogue, documentation and licensing overview as you plan your next site.