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.
Join GitHub
Email address
Password
2Create a New Repository
Choose a name like march-showcase. Set visibility to Public.
Create a new repository
● PublicAnyone can see this repository
3Upload Project Files
Make sure index.html is in the top folder (root), not nested inside another folder.
📁imagesproject images
📄index.htmlrequired home page
🎨style.csspage styles
⚙️script.jspage behavior
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.
Build and deployment
Source
Deploy from a branch⌄
main⌄
/ (root)⌄
✓ Your site is ready to be published.
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 project is live!
Open the address in a private window and test every image, button, and link.
Checklist
-
index.htmlis in the root folder - All images/scripts/styles are uploaded
- No local file paths like
C:\orfile:// - Repo is public and Pages is enabled
Common Mistakes
- Missing index.html: add it to project root.
- Wrong folder depth: avoid nesting project folders inside each other.
- Broken asset paths: use relative paths like
./images/pic.png.