Publish Playbook

How to Put Your HTML Project Online

Fast, clean, and beginner-friendly GitHub Pages workflow.

Share link for LMS/class page: https://YOUR-USERNAME.github.io/YOUR-REPO/

1Create a GitHub Account

Go to github.com and make a free account.

github.com/signup
Join GitHub
Email address
Password
Create account
Use an email you can access, choose a strong password, and verify the email GitHub sends you.

2Create a New Repository

Choose a name like march-showcase. Set visibility to Public.

github.com/new
Create a new repository
● PublicAnyone can see this repository
Create repository
Use a short name with lowercase letters and hyphens. Select Public so GitHub Pages can publish it.

3Upload Project Files

Make sure index.html is in the top folder (root), not nested inside another folder.

march-showcase
Add file ▾Code ▾
📁imagesproject images
📄index.htmlrequired home page
🎨style.csspage styles
⚙️script.jspage behavior
The important clue is that index.html appears immediately in the repository—not inside another project folder.

4Turn on GitHub Pages

Open Settings → Pages. Source should be main branch and root folder.

Settings → Pages
Build and deployment

Source

Deploy from a branch⌄
main⌄
/ (root)⌄
Save
✓ Your site is ready to be published.
Choose Deploy from a branch, then main and /(root). Click Save once.

5Get Your Live Link

Your website link will look like: https://YOUR-USERNAME.github.io/YOUR-REPO/

Your tutorial link will look like: https://YOUR-USERNAME.github.io/YOUR-REPO/tutorial/

your-username.github.io/march-showcase/
Your project is live!

Open the address in a private window and test every image, button, and link.

Publishing can take a few minutes. If the page initially shows 404, wait briefly and refresh before changing settings.

Checklist

Common Mistakes

Ready to Share?

Copy the final github.io address—not the repository editing address—and test it on another device.

Visit the Student Showcase →