↗ first flightFIELD GUIDE
A small guide to a big first step

Your first website.
Out in the world.

Go from “where do I start?” to a live website on Cloudflare. One page, a few simple steps, and a link you can share.

Let’s get it online
Beginner friendly · No terminal needed for this guide
</> index.html
⌑ your-first-site.pages.dev
✳

Hello, world.

A little corner of the internet, made by you.

This is just the beginning ↗
●   Your idea is now live.
01   Make a page02   Upload your files03   Share your linkTHE CLOUDFLARE PAGES ROUTE ↗
Pick your starting point

Two ways to take off.

Same destination. A different way to get there.

START HERE · NO GIT REQUIRED

Upload a ready-made site

Have HTML, CSS, and images ready? Use Pages Direct Upload to publish your finished files. This guide walks you through it.

Follow the upload guide →
FOR A DEVELOPMENT WORKFLOW

Connect a Git repository

Keep your code in GitHub or GitLab and let Pages deploy changes when you push. A useful path for ongoing development.

Explore Git integration ↗
Choose before you start: a Pages Direct Upload project cannot later switch to Git integration. You would need a new project.
01

Start with your website files

Download the starter above. It’s a complete HTML page. Put index.html in a folder and open it in your browser. Edit the text in a text editor to make it yours.

02

Open Cloudflare Pages

Sign in to Cloudflare. Go to Workers & Pages, create an application, and choose the Pages Direct Upload flow. Dashboard wording may vary.

Open the Cloudflare dashboard ↗

03

Drop your files. Deploy your site.

Give your project a name. Upload the folder or ZIP containing your finished site, with index.html at its root, then select Deploy site.

04

Meet your new corner of the web

Open the provided pages.dev address. Check your links and mobile layout, then share it. To update the site, upload a new deployment in the same project.

Based on Cloudflare’s Direct Upload documentation ↗

Before you go

A few things you might be wondering.

Do I need to buy a domain?

No. You can start with the pages.dev address Cloudflare gives your project. Add your own domain later from the project’s Custom domains section. Follow Cloudflare’s custom domain instructions for DNS setup.

What if I’m using React or another framework?

Build the project first and upload its generated static output, often a folder named dist or build. Uploading your source code alone does not build the site. Apps that need server-side code require an appropriate Workers or Pages Functions setup.

Can I add a backend or a database?

Yes, but this starter is a static page. For server logic, explore Cloudflare Workers. A contact form, account system, or database needs additional implementation; uploading HTML does not create those services.

Why does my site show a 404?

Check that index.html is at the top level of the uploaded output, rather than inside an extra nested folder. Also check that your image and stylesheet paths match the filenames, including capitalization.

Every great site starts with one page.

Yours can start right here.

Take the first step ↗