GitHub Pages

GitHub Pages hosts static websites directly from a GitHub repository. It is a good fit for project pages, documentation and personal sites.

GitHub Pages publishes files from a repository branch, or from a GitHub Actions workflow, as a live website. It supports Jekyll out of the box, and you can add a custom domain or a theme. You can also build a site with another static site generator and publish the output through a workflow. The default address uses your username or organization name as a github.io subdomain, and you can change it to a domain you own.

• Publish from a branch or with a workflow
• Built-in Jekyll support
• Custom domains for your site
• Custom 404 pages
• Themes you can add and customize

Open source maintainers, developers who write project documentation and people who want a simple personal or portfolio site. Anyone who already keeps their code on GitHub will find the setup familiar, and the site can sit in the same repository as the code it describes.

GitHub Pages is free to use. Sites are static, so there is no server-side code or database to run. Usage limits and terms are set by GitHub, and the site is served from GitHub's infrastructure. Plan for static content only, and use an outside service if you need dynamic features like logins or form processing.