Github Pages Static Website Hosting

Static Website Hosting on GitHub Pages.


Always Free Plan

GitHub Pages is free to use for personal sites with a 1GB storage limit.


Create, Build and Deploy

Create and manage content. Build your site to locally to test then single click deploy to the Git repository. No command line required.


Personal Use Only

GitHub Pages is not intended to be used as a free web-hosting service to run an online business, e-commerce site, or any other website that is primarily directed at commercial transactions.

How It Works?

GitHub Pages connects a repository branch with a domain alias and publishes the branch as the source for a website.

In the context of the other cloud platforms the git repository represents the storage and the pages platform is the CDN.

GitHub Pages publishes any static files that you push to your repository. If you publish your site from a source branch, GitHub Pages will use Jekyll to build your site by default. With YouDoCMS static site generator Jekyll is disabled thus skipping the build process by creating an empty file called .nojekyll in the root of your local build folder.

YouDoCMS headless CMS Integrates with the git command line to deploy and push a website built on your local machine to your git repository. During the build process the base URL is updated with the GitHub custom domain.

Learn More

GitHub Pages Headless CMS

If you are a GitHub user the Pages option allows static site hosting directly from a GitHub repository including free hosting.  YouDoCMS headless CMS integrates with the GitHub CLI to manage content, build and deploy without using the terminal.

GitHub Pages is available for static sites only and Pages supports custom domains and SLL certificates. However it does not include serverless functions or any options to customise the CDN. There is a limit of one site per GitHub account and organization, and unlimited project sites. A further limitation of the pages platform is the inability to create a 301 redirect from old to new content as this cannot be done via the CDN.

  • Custom Domains and Sub Domain.
  • GitHub CLI integration.
  • Single click build and deploy.
  • Custom Domain CNAME setup.

GitHub Pages Performance

GTMetrix test results for our home page tested on 19/12/2022 show GitHub Pages achieving an an average Largest Contentful Paint (LCP) time of 1.2s which is the slowest CDN we have tested. For comparison AWS (460ms), Azure(495ms), Cloudflare (393ms) and Firebase (468ms). 

LCP measures how long it takes for the largest content element e.g. an image or heading text on your page to become visible. For a good user experience, aim for an LCP of 1.2 seconds or less.

The 2022 Web Almanac analysis of the performance of hosted content management systems shows that less than half of the tested CMS sites achieve a “good” LCP of under 2.5 seconds for desktop or mobile.

  • 97% Lighthouse Score.
  • Slowest CDN LCP score.
  • Fully loaded time of 1.2s.
  • Time to first byte of 46ms.
Why Speed Matters

Frequently Asked Questions

GitHub can be confusing please read the guide regarding usage.

Pages offers a generous free tier for public and private repositories. Public repositories are suitable for personal and open source sites but business users will need a private repository which has build limits and a monthly fee.

GitHub Pages is not intended for or allowed to be used as a free web-hosting service to run your online business, e-commerce site, or any other website.

GitHub Pages sites have a soft bandwidth limit of 100 GB per month and a soft limit of 10 builds per hour.

Github users can fork your repository. Therefore Github pages should only be used for non-commercial sites without any secure information.