GitHub Pages guide

Put the files on GitHub and get the live site working first.

This should usually be the first guide you follow. Once GitHub Pages is live, the domain setup is easier and less confusing.

What this guide does

Keep it simple Move in order and do not skip around unless you already know the step.
Wording may vary slightly Big sites change buttons sometimes, so focus on the meaning of the step.
Come back later These pages are here so you can re-open them any time without digging through chat.
Step by step

Click-by-click walkthrough

Read one step, do that one step, then come back. That is the whole idea here.

1

Extract your zip first

Before you upload anything, unzip your website file on your computer so you can see the real files inside it.

  • You want the actual website files like HTML, CSS, JS, images, and folders.
  • Do not upload the closed zip if you are using GitHub's normal web upload page.
2

Sign in to GitHub

Go to GitHub and sign in to your account. Stay on the main screen after you sign in.

  • If you do not have an account yet, make one first, then come back to this guide.
3

Create a new repository

Click the plus button near the top right, then click the option for a new repository.

  • Name it something simple like jasonswebpages or your template preview site name.
  • Set it to Public if you want GitHub Pages to serve it without extra hassle.
4

Create the repository

Scroll down and click the button that creates the repository.

  • You can leave the advanced stuff alone for now if you are not sure.
5

Open the upload screen

Inside the new repository, look for Add file, then choose Upload files.

  • This is where you drag your website files in.
6

Drag your website files in

Open your extracted site folder on your computer. Drag the files and folders from inside the site folder into GitHub.

  • You want files like index.html and folders like images or assets.
  • If you see one extra outer folder wrapping everything, open that folder first and upload what is inside it.
7

Commit the upload

Wait for the files to finish loading, then scroll down and click Commit changes.

  • That saves the files into your repository.
8

Open the Pages settings

In the repository, click Settings. Then find Pages in the left menu or the settings area.

  • This is where GitHub turns your files into a live website.
9

Turn on GitHub Pages

In the Pages area, set the source to deploy from a branch.

  • Choose the main branch.
  • Choose the root folder if it asks for a folder.
10

Save the Pages settings

Click Save, then wait a minute or two while GitHub builds the site.

  • A message usually appears showing the live website link after it finishes.
11

Open your live site

Click the live GitHub Pages link and make sure the homepage opens.

  • If it looks broken, double-check that index.html is in the right place.
12

Only after that, connect your domain

Once the GitHub Pages link works, move to the Cloudflare guide to connect your real domain.

  • It is much easier when the GitHub side already works first.