GitHub Community
Github website deployment #184006
Replies: 3 comments 1 reply
-
|
Hi! Since you are seeing a blank screen instead of a browser error, your DNS settings are likely fine. This usually happens when the index.html loads, but it fails to find the connected JavaScript or CSS files due to path issues. Open your browser console (press F12 or Right Click -> Inspect -> Console). If you see a bunch of red 404 errors, that confirms it. Two quick things that usually fix this for exported sites:
|
Beta Was this translation helpful? Give feedback.
-
|
thank you! I just tried both of these and it still didnt work. Any other ideas? |
Beta Was this translation helpful? Give feedback.
-
|
Hi 👋 1️⃣ Repository & Branch Make sure GitHub Pages is enabled from Settings → Pages Confirm the correct branch is selected (main or gh-pages) If your site is in a subfolder, make sure the root folder is correct 2️⃣ index.html GitHub Pages requires an index.html file at the root of the published folder File name must be exactly index.html (case-sensitive) 3️⃣ Custom Domain (DNS) Verify that: CNAME file exists in the repo and contains only your domain (e.g. example.com) DNS records are correct: A records → GitHub Pages IPs or CNAME pointing to username.github.io DNS propagation can take up to 24–48 hours even if Namecheap says it’s complete 4️⃣ Relative Paths If the site was transferred from another platform, check CSS/JS paths Absolute paths (/assets/...) often cause blank pages on GitHub Pages 5️⃣ Browser DevTools Open DevTools → Console & Network tab Look for 404 errors or JS errors (they usually explain the blank screen) If you want, share: Repo link Domain name Screenshot of Pages settings Happy to help 👍 |
Beta Was this translation helpful? Give feedback.
-
|
This usually happens because GitHub Pages is working, but the site files or DNS are not fully aligned yet. Here’s how to troubleshoot step by step:
Go to Repo → Settings → Pages and confirm: Source branch is correct (usually main or gh-pages) Folder is correct (/root or /docs) Your custom domain is saved there
For GitHub Pages custom domain, you should have: A records 185.199.108.153 And one CNAME pointing to: yourusername.github.io
Make sure your repo has: index.html in the root (this is required) Not inside another folder unless Pages is configured for it
DNS can take up to 24–48 hours to fully update.
Open: https://yourusername.github.io/reponame If this works, then the issue is DNS only. Most common cause of blank page: Missing index.html in root folder or wrong Pages source setting. |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
-
Select Topic Area
Question
Body
Hi, I am trying to publish a website off of github pages transfered from another website (lovable). DNS has gone through according to NAMECHEAP to make a custom domain. Still showing blank screen when I load the website. I'm pretty new to github and coding and not sure what else to try, to troubleshoot if anyone has any ideas or advice. Thanks!
Beta Was this translation helpful? Give feedback.
All reactions