Deploy an Astro site
In this guide, you will create a new Astro application and deploy it using Cloudflare Pages.
Setting up a new project
$ mkdir astro-site && cd astro-site$ npm init astro
init, Astro will ask you which project type you would like to set up. Your answers will not affect the rest of this tutorial. Select an answer ideal for your project.
Before you continue
Creating a GitHub repository
# Setup the local repository$ git init$ git remote add origin https://github.com/<username>/<repo>$ git branch -M main# Commit all initial files$ git add -A$ git commit -m "initial commit"# Send commit to new GitHub repo$ git push -u origin main
Deploying with Cloudflare Pages
You will be asked to authorize access to your GitHub account if you have not already done so. Cloudflare needs this so that it can monitor and deploy your projects from the source. You may narrow access to specific repositories if you prefer; however, you will have to manually update this list when you want to add more repositories to Cloudflare Pages.
Select the new GitHub repository that you created and, in the Set up builds and deployments section, provide the following information:
Optionally, you can customize the Project name field. It defaults to the GitHub repository's name, but it does not need to match. The Project name value is assigned as your
After completing configuration, click the Save and Deploy button.
You will see your first deploy pipeline in progress. Pages installs all dependencies and builds the project as specified.
Cloudflare Pages will automatically rebuild your project and deploy it on every new pushed commit.
Additionally, you will have access to , which repeat the build-and-deploy process for pull requests. With these, you can preview changes to your project with a real URL before deploying them to production.