butiran-✗

simple website gh pages med

· 2 mins read · edit

Original post

Simple website on GitHub Pages

https://medium.com/p/1be8fcb0d64c

10-Mar-2026

Simple website on GitHub Pages
A not-so-complete step-by-step guidance

It is assumed that you have already GitHub account. When not, just create it .

Create repository

Use + and find New Repository.

image-01

Fill Repository name, Description, Choose visilibity to Public, Turn on Add README.

image-02

Click Create Repository to proceed.

image-03

In this case the repository is on https://github.com/dudung/simple-website .

Create docs/index.html

Use + on the left of green button <> Code and choose Create new file.

image-04

Type docs/index.html in the available field as filename.

image-05

The fill content of the file with following lines.

<html>
  <h1>simple-website<h1>
  <p>Hello, World!</p>
</html>

Click the green button on the top right Commit changes…

image-06

Click Commit changes.

image-07

Now you have the new file docs/index.html.

Actions

Choose Actions tab on the top, but below your username/simple-website text.

image-08

Type Static HTML and press enter, or simply scroll down to find it.

image-09

Click Configure on the card of Static HTML.

image-10

For now just click Commit changes…, the green button on the top right.

image-11

Confirm it by clicking Commit changes.

image-12

Now you have the static.yaml for deployment of you static HTML files.

Settings

Go to Settings tab.

image-13

Click it to change settings of your repository.

image-14

Scroll down and find Pages on the left menu.

image-15

Choose Branch main/docs.

image-16

Then click Save.

image-17

Go to main page of the repository by clicking username/simple-website link, where it is https://github.com/dudung/simple-website in this example.

image-18

Find option button on the right of About and click it.

image-19

Check Use your GitHub Pages website and click Save changes.

image-20

Now you have the link username.github.io/simple-website/ or https://dudung.github.io/simple-website/ for this example.

Open the website

Click the link to open your website hosted on GitHub Pages.

image-21

Now you have the website live on GitHub Pages.

Summaries

After reading this story you are able to

  • Create a new repository.
  • Create a docs/index.html as landing page of your website.
  • Create GitHub Actions Static HTML.
  • Activate GitHub Pages for main/docs folder.
  • Add website link to repository page.
  • Open the website hosted on GitHub Pages.

Topics: Static Site; Github Actions; Github Pages.