You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In this guide, you'll get started with Cloudflare Pages, and deploy your first website to the platform.
8
+
In this guide, you will get started with Cloudflare Pages, and deploy your first website to the platform.
9
9
10
10
<Aside>
11
11
12
-
You'll be signing up for a Cloudflare account. You may also want a custom domain available, but it isn't required.
12
+
You will be signing up for a Cloudflare account. You may also want to create a custom domain, but this is not required.
13
13
14
14
</Aside>
15
15
16
16
## Connecting your GitHub account
17
17
18
18
### Sign in to Cloudflare Pages
19
19
20
-
To begin, go to the [Cloudflare Pages site](https://pages.dev) and sign in with your Cloudflare account. If you don't have one yet, you can sign up for an account as you get started deploying your new site.
20
+
To begin, go to the [Cloudflare Pages site](https://pages.dev) and sign in with your Cloudflare account. If you do not have an account yet, you can sign up as you get started deploying your new Pages site.
21
21
22
22
### Connect to GitHub
23
23
24
-
Signing in with GitHub allows [Cloudflare Pages](https://pages.dev) to deploy your projects, update your GitHub PRs with [preview deployments](/platform/preview-deployments), and more. When you sign in, you'll also have the option of specifying any GitHub organizations that you'd like to connect to Cloudflare Pages. This allows you to deploy both public and private repositories for your own account, as well as repositories for your company or organization.
24
+
Signing in with GitHub allows [Cloudflare Pages](https://pages.dev) to deploy your projects, update your GitHub PRs with [preview deployments](/platform/preview-deployments), and more. After you sign in, select **Create a project**.
25
25
26
26
## Configuration and deployment
27
27
28
28
### Selecting a GitHub repository
29
29
30
-
You can select a GitHub project from your personal account or an organization you've given Pages access to. This allows you to choose a GitHub repository to deploy using Pages. Both private and public repositories are supported.
30
+
You can select a GitHub project from your personal account or an organization you have given Pages access to. This allows you to choose a GitHub repository to deploy using Pages. Both private and public repositories are supported.
31
31
32
32
<Aside>
33
33
34
-
Don't have a project? [Check out our extensive How-To section](/how-to) to learn how to create and deploy common frameworks and tools to Cloudflare Pages.
34
+
If you do not have a project, [refer to our extensive HowTo section](/how-to) to learn how to create and deploy common frameworks and tools to Cloudflare Pages.
35
35
36
36
</Aside>
37
37
38
38
### Configuring your deployment
39
39
40
-
Once you've selected a repository, you can customize your deployment in the "Deployment settings" page.
40
+
Once you have selected a repository, select **Install & Authorize** and **Begin setup**. You can then customize your deployment in the "Set up builds and deployments" page.
41
41
42
-
Your **project name** will be used to generate your deploy's hostname. By default, this matches your GitHub project name.
42
+
Your **project name** will be used to generate your project's hostname. By default, this matches your GitHub project name.
43
43
44
-
**Production branch** indicates the branch that Cloudflare Pages should use to deploy the "production" version of your site. For most projects, this is the `main` or `master` branch. All other branches that _aren't_ your production branch will be used for [preview deployments](/platform/preview-deployments).
44
+
"Production branch" indicates the branch that Cloudflare Pages should use to deploy the "production" version of your site. For most projects, this is the `main` or `master` branch. All other branches that are not your production branch will be used for [preview deployments](/platform/preview-deployments).
45
45
46
46
47
47
48
48
#### Build settings
49
49
50
-
Depending on the framework, tool, or project you're deploying to Cloudflare Pages, you'll need to specify the site's **build command** and **publish directory** to tell Cloudflare Pages how to deploy your site.
50
+
Depending on the framework, tool, or project you are deploying to Cloudflare Pages, you will need to specify the site's **build command** and **publish directory** to tell Cloudflare Pages how to deploy your site.
51
51
52
-
Our deployment UI provides a number of "presets", pre-filling values for many common deployment scenarios. If you're unsure what the correct values are for this section, check out our documentation for [build configuration](/platform/build-configuration).
52
+
Our deployment UI provides a number of "presets", pre-filling values for many common deployment scenarios. If you are unsure what the correct values are for this section, check out our documentation for [build configuration](/platform/build-configuration).
53
53
54
54
55
55
56
56
#### Environment variables
57
57
58
58
Environment variables are a common way of providing configuration to your build workflow. While setting up your project, you can specify a number of key-value pairs as environment variables. These can be further customized once your project has finished building for the first time.
59
59
60
+
After you have chosen your _Framework preset_, configured Root directory (optional), and customized your Environment variables (optional), you are ready to deploy.
61
+
60
62
## Your first deploy
61
63
62
-
Once you've finished setting your build configuration, Cloudflare Pages will begin deploying your site! Your project build logs will output as Cloudflare Pages installs your project dependencies, build the project, and deploys it to Cloudflare's global network.
64
+
Once you have finished setting your build configuration, select **Save and Deploy**. Your project build logs will output as Cloudflare Pages installs your project dependencies, builds the project, and deploys it to Cloudflare's global network.
63
65
64
66
65
67
66
-
When your project has finished deploying, you'll receive a unique URL to view your deployed site. Congrats! You've deployed your first site with Cloudflare Pages 🚀
68
+
When your project has finished deploying, you will receive a unique URL to view your deployed site.
67
69
68
70
## Managing your site
69
71
70
-
Selecting "Continue to project" after your first deploy, you'll see your project's configuration in the Cloudflare Pages dashboard. Here, you can see your project's current deployment status, the production URL and associated commit, and all past deployments.
72
+
After your first deploy, select **Continue to project** to see see your project's configuration in the Cloudflare Pages dashboard. On this page, you can see your project's current deployment status, the production URL and associated commit, and all past deployments.
71
73
72
74
73
75
74
76
### Adding a custom domain
75
77
76
-
While every Cloudflare Pages site receives a custom subdomain during deployment, you may also wish to point custom domains (or subdomains) to your site. To do this, go to the "Domains" tab in your site dashboard.
78
+
While every Cloudflare Pages site receives a custom subdomain during deployment, you may also wish to point custom domains (or subdomains) to your site. To do this, go to **Custom domains** in your site dashboard.
77
79
78
80
79
81
80
-
Click the "Set up a domain" button, and provide the domain that you'd like to serve your Cloudflare Pages site on. Depending on the domain, you'll need to configure nameservers or add a custom CNAME record to point the domain to your Cloudflare Pages site.
82
+
Select **Set up a domain**, provide the domain that you would like to serve your Cloudflare Pages site on and select **Continue**. Depending on the domain, you will need to configure nameservers or add a custom CNAME record to point the domain to your Cloudflare Pages site.
81
83
82
84
#### Configure nameservers
83
85
84
-
Configure your nameservers to point to Cloudflare's name servers. If your nameservers are successfully pointed to Cloudflare, we'll proceed by creating a CNAME record for you!
86
+
Configure your nameservers to point to Cloudflare's name servers. If your nameservers are successfully pointed to Cloudflare, Cloudflare will proceed by creating a CNAME record for you.
85
87
86
88
#### Add a custom CNAME record
87
89
88
-
If you don't want to point your nameservers to Cloudflare, you can still use a custom CNAME record to use a single domain with Cloudflare Pages.
90
+
If you do not want to point your nameservers to Cloudflare, you can still use a custom CNAME record to use a single domain with Cloudflare Pages. You can configure your DNS settings in the **DNS** section of the Cloudflare dashboard.
0 commit comments