Why GitHub Pages?
GitHub Pages turns any repository into a live website — instantly and for free.
Free Hosting
Serve your site directly from a GitHub repository at no cost, with HTTPS included.
Instant Deployment
Push a commit and your changes are live within seconds via GitHub Actions.
Custom Domains
Point your own domain name at your GitHub Pages site with a simple DNS change.
Jekyll Support
Optionally use Jekyll to build blogs or documentation sites straight from Markdown.
HTTPS by Default
Every GitHub Pages site gets a free TLS certificate so your visitors are always secure.
Any Static Stack
Use plain HTML, React, Vue, Hugo — anything that produces static files works.
Getting Started
Publishing your own GitHub Pages site takes just a few steps.
- Create or fork a GitHub repository.
- Add an
index.html(orindex.md) file to the repository root. - Go to Settings → Pages in your repository.
- Under Source, select the branch you want to publish (e.g.
main) and click Save. - Your site will be live at
https://<username>.github.io/<repo>/within a minute.
Minimal index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>My GitHub Pages Site</title>
</head>
<body>
<h1>Hello, World!</h1>
</body>
</html>