GitHub Pages is eenvoudig, maar domein- en publicatieregels zijn precies. Een CNAME in de verkeerde map of ontbrekende index.html kan een 404 veroorzaken.

Geschikt voor

Custom domains voorbereiden.
Statische output controleren voor push.
CNAME, sitemap en robots.txt in de gepubliceerde map houden.

Veelvoorkomend gebruik

Geldige CNAME-inhoud maken.
DNS-notities scheiden van repo-instellingen.
Launchdetails controleren voor HTTPS en delen.

Task guide

Use GitHub Pages tools when you set up a new site, move an existing site to a custom domain, or troubleshoot a deployment that is not serving correctly. Start by confirming your site repository settings: the publishing source branch and folder. Use the CNAME helper to prepare a custom domain file and verify your DNS configuration before enabling HTTPS. Add a 404 HTML page for single-page applications that handle client-side routing. Finish with the SEO checklist to verify that your generated output includes essential files like robots.txt, sitemap.xml, and proper metadata.

Publishing checklist

Confirm the CNAME file exists in the root of your published output, not your project source root, and matches your custom domain exactly.
Verify that the GitHub Pages publishing source setting points to the correct branch and folder, such as main /root or gh-pages /docs.
Check DNS records for your custom domain: a CNAME record for www and either ALIAS or A records for the apex domain.
Test the site URL after HTTPS is provisioned, as GitHub Pages can take several minutes to issue a certificate.
Enable HTTPS enforcement only after confirming the site loads correctly over both HTTP and HTTPS.

FAQ

Vragen over github pages tools

Waar moet het CNAME-bestand staan?

In de gepubliceerde siteroot. Als GitHub Pages dist serveert, moet het bestand in dist staan.

Waarom toont GitHub Pages 404 na een push?

Vaak gaat het om verkeerde branch, map, ontbrekende index.html of een domein op de verkeerde repo.